IAF Agent Bridge について
IAF Agent Bridgeは、CodexやClaude CodeなどのstdioホストからCursor Agentへ実装作業を委任するMCPサーバーです。セッションIDで同じCursorセッションを再開でき、続行・完了・保留の判断は監督側が行います。
主な機能
- 01Cursor Agentへのタスク委任
- 02sessionIdによるセッション再開
- 03実行中ターンのキャンセル
- 04環境と認証状態の確認
- 05破壊的操作のデフォルト制限
活用シーン
- 01Codexからコード変更を委任
- 02複数ターンにわたるCursor作業の継続
- 03実行中のCursorターンの停止
- 04ローカルCursor CLI環境の確認
MCP 対応
stdio経由でMCPホストに`delegate`、`cancel`、`doctor`ツールを公開します。ACP経由でローカルのCursor CLIと通信し、後続呼び出し用のセッションIDを返します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
3掲載時のツール一覧 · 3 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| fast | boolean | いいえ | Cursor の高速ティアをリクエストします。ユーザーから要望がない限り false のままにしてください。料金が高くなります。 |
| mode | enum | いいえ | agent は Cursor に実装させます。plan は Cursor に計画を作成させて停止します。ask は読み取り中心の質問に使います。モードは Cursor への指示です。agent | plan | ask |
| model | string | いいえ | 任意の Cursor モデル ID。省略すると、Cursor の現在のデフォルトが使われます。 |
| effort | string | いいえ | 選択したモデルが提示する正確な effort 値。無効な値の場合、プロンプト送信前に失敗し、受け入れ可能な値の一覧が示されます。 |
| prompt | string | はい | Cursor 向けの自然なプロンプトです。そのまま送信します。内容を貼り付けるのではなく、ファイルやプロジェクト文書を指定してください。 |
| context | string | いいえ | モデルがコンテキストウィンドウのオプションを提示している場合に指定します（例：272k、1m）。ユーザーから要求がない限り省略してください。 |
| sessionId | string | いいえ | この Cursor セッションを再開します。省略すると新しいセッションを開始します。後続の作業には前回の結果の sessionId を使用してください。 |
| workspace | string | はい | Cursor が作業する既存のプロジェクトディレクトリです。ホームディレクトリまたはファイルシステムのルートディレクトリは指定できません。 |
| contextFiles | array | いいえ | 添付するファイルです。テキストはリソースリンクとして渡されます。Cursor が画像を受け付ける場合、画像（png、jpg、gif、webp、5MB 未満）はインラインで送信されます。ファイルが見つからない場合は警告されますが、失敗にはなりません。 |
詳細
IAF Agent Bridge
Codex、Claude Code、または別の stdio ホストから Cursor Agent に作業を依頼し、要求された作業が完了するまで同じ Cursor セッションを継続できる MCP サーバーです。
このブリッジは、プロンプト、セッション、Cursor の応答を受け渡します。次に何をするかはスーパーバイザーが決定します。実装は Cursor が行います。
delegate は、Cursor のターンが完了してから結果を返します。作業完了を伝えるメッセージがあっても、Cursor がツール、サブエージェント、または追加の処理を実行中であれば、呼び出しは終了しません。Cursor はその内部処理を引き続き制御します。スーパーバイザーには 1 つの結果が返され、その後、CONTINUE、COMPLETE、または BLOCKED を選択します。
ステータス： npm [email protected] は現在公開中のパッケージです。GitHub Release v1.1.0 はこれと一致しています。v1.0.2、v1.0.1、v1.0.0 も引き続き公開されています。Official MCP Registry のエントリーは io.github.francescoveryra-dot/iaf-agent-bridge、バージョンは 1.1.0 です。
Supervisor (Codex, Claude Code, or another MCP host)
|
| MCP over stdio
v
IAF Agent Bridge
|
| ACP over stdio
v
Cursor Agent
|
v
Your repository
Cursor Agent が本番環境で使用する唯一の実行者です。Codex と Claude Code はスーパーバイザーです。Cursor 自身が編集中のリポジトリの Cursor MCP 設定に、このサーバーをインストールしないでください。このようなループは拒否されます。
できること
- MCP ホストから Cursor セッションを開始し、
sessionIdを使って再開できます。 - すべてのツール呼び出しを承認しなくても、通常の開発を続行できます。
IAF_PERMISSION_MODE=allow-allを明示的に設定しない限り、強制プッシュ、履歴の書き換え、破壊的な SQL、プロジェクト外の削除、シークレットのステージングを拒否します。- リポジトリに Master Prompt がある場合はそれを使用します。ない場合も通常どおり動作します。
前提条件
- Node.js 20 以降。テストスイートの実行には Node.js 22 が必要です。
- Cursor CLI が
PATH上でagentとして使用できること。 - そのマシンで
agent loginが完了していること。
ローカル stdio サーバーに OpenAI API キーは必要ありません。
Personal Private モードはローカル stdio サーバーとは別のものです。Secure MCP Tunnel と制限付きランタイムキーを自分で作成します。npx iaf-agent-bridge setup chatgpt --project my-project=/absolute/path を実行すると、そのエイリアスがローカルに保存され、npx iaf-agent-bridge chatgpt は自分のユーザーだけが開けるソケットで待ち受けます。IAF はリレーをホストしません。通常の ChatGPT から delegate を呼び出すには、そのワークスペースで Full MCP write tools が利用できる必要があります。テスト済みの ChatGPT Plus アカウントでは利用できませんでした。このブリッジはプランを検出しません。詳細：docs/remote-chat.md。
インストール
| チャネル | 状態 | 方法 |
|---|---|---|
| npm | 利用可能 | npx -y [email protected] |
| Official MCP Registry | 利用可能 | io.github.francescoveryra-dot/iaf-agent-bridge 1.1.0 |
| Cursor プラグイン | 直接インストール可能 | agent plugin marketplace add https://github.com/francescoveryra-dot/IAF-Agent-Bridge.git |
| Cursor Marketplace | 提出済み — 審査待ち | まだ一般公開インストールには対応していません。直接インストールする場合は、引き続き agent plugin marketplace add https://github.com/francescoveryra-dot/IAF-Agent-Bridge.git を使用してください。 |
| Claude Code | 直接インストール可能 | claude plugin marketplace add francescoveryra-dot/IAF-Agent-Bridge の後に claude plugin install iaf-agent-bridge@iaf-agent-bridge |
| GitHub Copilot CLI | 直接インストール可能 | copilot plugin marketplace add francescoveryra-dot/IAF-Agent-Bridge の後に copilot plugin install iaf-agent-bridge@iaf-agent-bridge |
| Codex / ChatGPT GitHub プラグイン | 直接インストール可能 | codex plugin marketplace add https://github.com/francescoveryra-dot/IAF-Agent-Bridge.git --ref main の後に codex plugin add iaf-agent-bridge@iaf-agent-bridge |
| OpenAI プラグインディレクトリ | このローカルサーバーには該当しません | 公開ディレクトリでは、ホストされた HTTPS MCP エンドポイントが審査されます。このブリッジはお使いのマシン上で実行され、ローカルの Cursor CLI と通信します。 |
| VS Code MCP ギャラリー | 掲載なし | VS Code は GitHub MCP レジストリを参照します。このサーバーは Official MCP Registry に登録されており、そのギャラリーには掲載されていません。npx -y iaf-agent-bridge で追加してください。 |
手動の MCP 設定も引き続き代替手段として利用できます。docs/installation.md と docs/hosts.md を参照してください。
クイックスタート
git clone https://github.com/francescoveryra-dot/IAF-Agent-Bridge.git
cd IAF-Agent-Bridge
npm install
npm run build
node dist/cli.js doctor
doctor に Cursor の実行ファイルと Authenticated: true が表示されるはずです。アカウント情報は出力されません。
公開済みパッケージを MCP ホストに指定します。
command: npx
args: ["-y", "[email protected]"]
ソースをチェックアウトした場合は、npm run build の後に node と dist/cli.js を使用できます。その後、スーパーバイザーに Cursor を使って作業を実装するよう依頼し、依頼された作業が残っている間は、返された sessionId を指定して delegate を再度呼び出すよう伝えてください。
ホストごとのインストール
| ホスト | 方法 | 詳細 |
|---|---|---|
| Codex | このリポジトリのプラグインマニフェスト、または config.toml | docs/hosts.md |
| Claude Code | claude mcp add、または .claude-plugin/ 内のプラグイン | docs/hosts.md |
| Cursor | マーケットプレイスへの提出用プラグインマニフェストです。Cursor から Cursor への委任には使用しないでください。 | docs/marketplaces.md |
| 任意の stdio MCP クライアント | node + dist/cli.js | docs/installation.md |
npm インストール（npx -y iaf-agent-bridge）では 1.1.0 がインストールされます。docs/installation.md と docs/release.md を参照してください。
ツール
| ツール | 用途 |
|---|---|
delegate | プロンプトを送信します。同じ Cursor の会話を続けるには sessionId を渡します。 |
cancel | 実行中のターンを停止します。セッションは引き続き再開できます。 |
doctor | Node、ブリッジ、Cursor CLI、認証を確認します。 |
フォローアップの例：最初の delegate は "sessionId": "..." を返します。次の呼び出しではその ID と、まだ不足している内容を指定したプロンプトを使用します。
スーパーバイザーの動作
result は、Cursor の返信を会話に貼り付けたかのように読み取ってください。そのうえで、次のいずれかの状態を選択します。
- CONTINUE：依頼された作業が残っており、Cursor が引き続き対応できる場合です。これが通常の結果です。計画、TODO、モック、未実装のレイヤーは CONTINUE です。
- COMPLETE：依頼された作業が実際に完了している場合です。
- BLOCKED：外部の判断、シークレット、または取り消し不能な承認が本当に必要な場合に限ります。
ブリッジは、ターンごとに新たな lint の実行、エンドツーエンドテストスイート、またはカバレッジゲートを要求しません。詳細：docs/supervisor-loop.md。
リポジトリに MASTER_PROMPT.md または docs/supervisor-loop.md に記載されている他のプロジェクトファイルが含まれている場合、最初の結果でそれらが示されます。含まれていない場合、何も作成されません。
設定とトラブルシューティング
環境変数：docs/configuration.md。
doctor で Cursor が見つからないと表示された場合は、CLI をインストールして、新しいシェルを開いてください。認証されていないと表示された場合は、agent login を実行してください。その他のケース：docs/troubleshooting.md。
セキュリティ
ブリッジは、指定したワークスペースを Cursor に編集させたり、そのワークスペースでコマンドを実行させたりできます。SECURITY.md と docs/security-model.md をお読みください。
脆弱性は非公開で報告してください：Security advisories。トークン、認証情報、または動作するエクスプロイトを含む公開 issue は作成しないでください。
コントリビュート
CONTRIBUTING.md。issue やプルリクエストを歓迎します。サポート窓口は SUPPORT.md に記載されています。
ライセンス
MIT。LICENSE をご覧ください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。