ProBridge
ProBridge

ChatGPT desktop Quick Chat + GPT-5.6 Pro 向けのオープンソースのローカル MCP ブリッジです。
Codex、OpenCode、Claude、または類似の MCP ホストのコーディングエージェントは ProBridge を呼び出します。ProBridge はジョブをキューに入れ、検証済みの ChatGPT Quick Chat を開き、プロンプトを送信します。その ChatGPT セッション内では、LocalAnt / DevSpace がローカル Mac とアクティブなワークスペースに到達するコネクタです。
ChatGPT Pro のクォータが使用されます。Codex モデルのクォータは使用されません。モデルの API キーはありません。
現在のターゲット: macOS。 Windows と Linux はまだサポートされていません。これらのプラットフォーム向けの実際のドライバを追加するコントリビューションを歓迎します。
連携の仕組み
Codex / OpenCode / Claude
|
| MCP tool call
v
ProBridge
prompt · queue · status · follow-up
|
| drives ChatGPT desktop Quick Chat
v
ChatGPT Quick Chat (GPT-5.6 Pro)
|
| LocalAnt / DevSpace inside ChatGPT
v
authenticated device tunnel
|
v
local Mac / active workspace呼び出し側エージェントが必要とするツールは 3 つだけです。
gpt56_pro_start({ prompt })
gpt56_pro_status({ jobId })
gpt56_pro_followup({ jobId, prompt })start は即座に jobId を返します。status をポーリングしてください。follow-up は、同じ Quick Chat のラウンドが完了した後にのみ使用してください。
Related MCP server: mcacp
このリポジトリが追加するもの
LocalAnt / DevSpace は ChatGPT に Mac へのアクセスを提供します。 ProBridge はそのコネクタを置き換えるものではなく、代わりにインストールすることもできません。
ProBridge はコーディングエージェントに ChatGPT Pro へのブリッジを提供します。 MCP ホストは ProBridge にプロンプトを送信し、ProBridge はそれをキューに入れ、Quick Chat を操作し、MCP 経由でジョブの状態を返します。ChatGPT Pro にローカルの作業をさせたいが、Codex、OpenCode、Claude、または別のエージェントにサブエージェントとして呼び出させたい場合に、このリポジトリは理にかなっています。
要件
macOS
Node 20+
Xcode コマンドラインツール(
swiftc)Pro でサインインしている ChatGPT desktop
コンパイル済みの
bin/ax-driverに対するアクセシビリティ権限
LocalAnt / DevSpace は、ChatGPT Pro にマシンを操作する手段を提供します。ProBridge は、他のエージェントがその ChatGPT セッションに作業を送れるようにするものです。
セットアップ — 必要な 2 つの要素
1. 最初に ChatGPT のローカルコネクタをセットアップする
ProBridge が機能するには、ChatGPT がローカル Mac に到達できるコネクタをすでに持っている必要があります。1 つのコネクタを選択し、ProBridge をインストールする前にその前提のセットアップを完了してください。
LocalAnt(検証済みのパス): LocalAnt のセットアップガイド に従ってください。クイックスタートは次のとおりです。
npx -y localant setup localant tools profile coding
localant setup は、認証済みの MCP エンドポイントを出力します。ChatGPT デスクトップで、Settings → Apps & Connectors に移動し、Developer Mode を有効にして、Connectors → Create を選択し、その MCP エンドポイントを貼り付け、Authentication: None を選択し、コネクタに LocalAnt という名前を付けます。LocalAnt のローカル承認とセキュリティ設定を、お使いのマシンに適した状態に保ってください。
DevSpace: Waishnav/devspace の手順に従い、そのプロジェクトの指示どおりにローカル環境を ChatGPT に接続してください。
続行する前に、ChatGPT Quick Chat を開き、選択したコネクタが無害なローカルプロジェクトファイルを読み取れることを確認してください。これは ChatGPT 側のセットアップです。ProBridge だけをインストールしても、ChatGPT が Mac にアクセスできるようにはなりません。
2. Mac に ProBridge をインストールする
git clone https://github.com/HAMZADEMIR33412005/probridge.git
cd probridge
node scripts/build-ax.mjs
node scripts/install.mjs
node scripts/doctor.mjsinstall.mjs は、必要に応じて ~/.codex/config.toml を作成し、ProBridge の MCP エントリを書き込み、既存の設定を変更する場合はタイムスタンプ付きのバックアップを作成します。その後、macOS が要求したら bin/ax-driver にアクセシビリティを許可し、ChatGPT デスクトップを開いたままにして、新しい Codex チャットを開始してください。
cwd は設定されません。Codex は、すでに開いているプロジェクトからサーバーを起動する必要があります。
Codex 用の MCP
自動:
node scripts/install.mjs手動: examples/codex.config.toml を ~/.codex/config.toml にコピーし、サーバーの絶対パスを置き換えてください。
登録されるサーバー名は probridge です。更新後は、新しい Codex チャットを開始して MCP プロセスとデーモンプロトコルを再読み込みしてください。
Claude Code / OpenCode / その他のホスト用の MCP
stdio MCP サーバーをこのチェックアウトに指定してください。
{
"mcpServers": {
"probridge": {
"command": "/Applications/ChatGPT.app/Contents/Resources/cua_node/bin/node",
"args": ["/ABS/PATH/TO/probridge/src/server.mjs"]
}
}
}examples/claude-code.mcp.json と examples/opencode.json を参照してください。ChatGPT に同梱されている Node がない場合は、Node 20+ のバイナリならどれでも動作します。
MCP ホストは、プロジェクトのワークスペースからサーバーを起動するか、file:// ルートを正確に 1 つ指定する必要があります。ProBridge は、ホーム、Desktop、Documents などの広範なフォルダを拒否します。
使い方
プロジェクトワークスペース内のエージェントから:
gpt56_pro_start({
prompt: "Inspect the failing tests, fix the root cause, run focused tests, and report changed files."
})ポーリング:
gpt56_pro_status({ jobId: "pro_..." })完了したら、同じ Quick Chat を続行します:
gpt56_pro_followup({
jobId: "pro_...",
prompt: "Now implement the review findings."
})ジョブはキューに入れられます。前のプロンプトが送信済みとして確認されると、すぐに 2 つ目の New chat を送信できます。フォローアップは同じ会話に残ります。
ステータスは次の 2 か所にあります:
~/.chatgpt-pro-subagent/— 正規のデーモン状態、キュー、ロック<workspace>/.chatgpt-pro-jobs/<jobId>.md— LocalAnt / DevSpace を通じて ChatGPT が書き込む協調制御ファイル
関連プロジェクト
プラットフォーム対応
プラットフォーム | ステータス |
macOS | サポート対象。ネイティブのアクセシビリティドライバ。 |
Windows | サポート対象外。別の UI ドライバが必要。 |
Linux | サポート対象外。別の UI ドライバが必要。 |
MCP サーバー、キュー、および制御ファイルプロトコルは OS に依存しません。他のプラットフォームで欠けているのは、src/native/ax-driver.swift の信頼できる代替品です。
セキュリティ
ProBridge は、あなたがすでにサインインしている ChatGPT アプリを操作し、その後 ChatGPT が LocalAnt / DevSpace を使ってワークスペースにアクセスします。これはサンドボックスではなく、同一ユーザーによるローカル実行として扱ってください。
~/.chatgpt-pro-subagent 配下の実行時ファイルはプライベートです(0700 / 0600)。ワークスペースのジョブファイルは、可能な場合 .git/info/exclude によって git から除外されます。広範な個人フォルダはワークスペースとして拒否されます。
開発
npm test
npm run build:ax
node scripts/doctor.mjsライセンス
MIT
Available Tools
3 toolsgpt56_pro_followupA
Queue a follow-up in the verified same Quick Chat thread. The target must be the latest completed round and must have a captured chat title. Returns a child jobId; poll gpt56_pro_status.
| Name | Required | Description | Default |
|---|---|---|---|
| jobId | Yes | Latest completed job id in the Quick Chat thread. | |
| prompt | Yes | The follow-up task to send into that verified conversation. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the burden and it discloses key behavior: the operation is queued (non-blocking), returns a child jobId, and requires verification. It also tells the agent the next step (poll status). It stops short of describing error/failure behavior, but the core behavioral contract is transparent.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, front-loaded with the action and target, with the second sentence covering the return and polling behavior. No filler or repetition.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a two-parameter tool with no output schema, the description supplies the preconditions, the return value, and the follow-up polling action. It is slightly thin on failure/error conditions, but complete enough for an agent to invoke and process the result.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so both jobId and prompt are already documented. The description restates the recency constraint for jobId ('latest completed round') and frames prompt as a follow-up task, reinforcing but not adding meaning beyond the schema. Baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a precise action (queue a follow-up) and a specific resource (verified Quick Chat thread), clearly differentiated from siblings by emphasizing the same thread and returning a child jobId. It also names the polling sibling, so an agent can distinguish from gpt56_pro_start and gpt56_pro_status.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Gives explicit preconditions: the target must be the latest completed round and must have a captured chat title, and directs the agent to poll gpt56_pro_status. It does not explicitly name gpt56_pro_start as the alternative for new threads, but the phrase 'follow-up in the verified same Quick Chat thread' strongly implies it.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
gpt56_pro_startA
Queue one verified GPT-5.6 Sol / Effort Pro Quick Chat sub-agent job for this MCP workspace. Returns immediately with a jobId. The local daemon serializes full job execution, verifies the UI send, and keeps authoritative lifecycle state outside the workspace. Poll gpt56_pro_status.
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | Yes | The complete task for the LocalAnt / DevSpace-capable GPT-5.6 Pro sub-agent. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the burden and discloses key behavior: immediate return with jobId, daemon serialization, UI verification, and external lifecycle state. It does not mention failure modes or idempotency, but the async nature and polling requirement are clearly conveyed.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three sentences each serve a distinct purpose: stating the action, describing the return behavior, and explaining daemon internals and next step. The key information is front-loaded, and there is no filler or repetition.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a one-parameter async queue tool with no output schema, the description covers what to send, what is returned (jobId), and what to do next (poll status). It does not explicitly say how to use the jobId with siblings, but that is a minor inferable gap.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema already documents the single 'prompt' parameter with a full description (100% coverage), so the baseline is 3. The tool description adds no new parameter-specific detail beyond the schema's own description, merely restating that the prompt is the task.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb 'Queue' and a specific resource 'GPT-5.6 sub-agent job', making the tool's role clear. The phrase 'for this MCP workspace' scopes it further, and the sibling tools (status, followup) are implied to have different purposes. The description distinguishes this as the start action.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides clear context that this queues a job and returns immediately, and instructs to poll gpt56_pro_status afterward. However, it does not explicitly compare to the followup sibling or state when not to use this tool, so usage is more implied than fully specified.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
gpt56_pro_statusA
Read authoritative daemon state and the latest validated cooperative control-file report for a job in this MCP workspace.
| Name | Required | Description | Default |
|---|---|---|---|
| jobId | Yes | Job id returned by gpt56_pro_start or gpt56_pro_followup. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It signals this is a read operation (non-mutating, safe to call). However, terms like 'authoritative daemon state' and 'cooperative control-file report' are unexplained jargon that obscure the actual behavior and return semantics. The description gives hints (read-only, latest/validated data) but doesn't disclose what an agent will actually receive or whether repeated calls are safe.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single sentence with no filler words, front-loading the key verb 'Read' and specifying the resource. The structure is efficient — a busy agent can extract the action quickly. Points are deducted only because the dense, jargony phrasing ('authoritative daemon state', 'validated cooperative control-file report') achieves brevity at the expense of immediate clarity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a status-checking tool with no output schema and no annotations, the description carries significant responsibility, and it's mostly adequate: it conveys read-only semantics and a job-scoped scope. However, it doesn't clarify what an agent will do with the output (e.g., does it return a job state like pending/running/completed?) or how 'daemon state' differs from the 'control-file report.' The existence of siblings suggests a workflow (start → status → followup), but the description doesn't articulate where the boundaries lie.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3 with no additional parameter info needed. The description's phrase 'for a job in this MCP workspace' loosely references the job context, but the schema already documents that jobId comes from gpt56_pro_start or gpt56_pro_followup. The description adds no meaning beyond what the schema provides, which is acceptable given full coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb ('Read') and identifies a concrete resource ('authoritative daemon state and the latest validated cooperative control-file report') scoped to a job in the MCP workspace. It clearly distinguishes from siblings: start and followup are different operations, so an agent would not confuse this with them. The phrase 'in this MCP workspace' adds a scoping qualifier that reduces over-flagging as a general system status tool.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage context: check status of a job in the MCP workspace, presumably after gpt56_pro_start or gpt56_pro_followup. However, there's no explicit guidance on when to prefer this tool over siblings, when polling is appropriate, or what conditions would call for gpt56_pro_followup instead. The context is implied by the workflow rather than stated.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
3 tool updates
v1.2.0- First observed
gpt56_pro_followup - First observed
gpt56_pro_start - First observed
gpt56_pro_status
TDQS
Scored across 3 tools
Each tool corresponds to one distinct lifecycle action: starting an initial job, polling its status, and queueing a follow-up to a completed thread. There is no meaningful overlap, even though start and followup both create work.
All tools share a clear gpt56_pro_ prefix and consistent lowercase snake_case formatting. Minor deviation: start and followup are verbs while status is a noun, but the action each tool performs is still highly predictable.
Three tools is well-scoped for the server's apparent purpose: launch a job, check status, and continue the conversation. Each tool earns its place, and no unnecessary tools inflate the surface.
The primary start-status-followup workflow is fully covered and workable. The main gaps are optional lifecycle conveniences like canceling a queued/running job or listing all active jobs, but agents can work around these.
Maintenance
Related MCP Connectors
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
Build agents to automate any background task. Works with your ChatGPT/Claude subscription.
Real-time chat hub for AI agents — Claude Code, Cursor, Cline, Codex over MCP or REST.
Build and supervise fleets of agents from Claude Code, Codex or Cursor. Connects over OAuth.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceThe simplest way to bridge and collaborate across AI Agent sessions like Claude Code, Codex, Gemini, or Cursor. It allows your agents to combine their strengths to solve your most difficult tasks without leaving their current context.32 npm69MIT
- AlicenseAqualityDmaintenanceBridges any MCP client (like Claude Code, Zed, VS Code) to any ACP coding agent, enabling multi-agent orchestration from a single chat interface.24126 npm11Apache 2.0
- AlicenseAqualityAmaintenanceBridges multiple CLI coding agents (Codex, Cursor, OpenCode, Claude, Antigravity) into any MCP client, enabling delegation of prompts, parallel execution, and code review workflows.6253 npmMozilla Public 2.0
- AlicenseCqualityBmaintenanceBridges browser-based AI assistants with coding agents like Claude Code and Cursor via MCP, enabling chat relay, browser automation, and skill installation.362MIT