Subagent MCP

独立したハーネス。1つのCodexオーケストレーター。

1つのモデルが変更を計画し、実装し、レビューするとき、レビュー担当者は作成者のコンテキストと盲点を共有します。それは自分の計画をテストする代わりに確認してしまう可能性があります。

Subagent MCPは、Codexをメインエージェントかつ最終決定者として維持しながら、境界のある作業を外部エージェントランタイムに委任します。各ランタイムは、ネイティブハーネスとペアになったモデルであり、Codexは異なるコンテキストと前提を持つ独立したモデルから実装またはレビューを得ることができます。

これにより、Codexの効果的なサブエージェントプールが拡大し、すでに持っているプロバイダークォータを利用できます。Subagent MCPは、使用クレジットや有料超過を有効にしたり、購入したり、自動リロードしたり、黙ってオプトインしたりすることはありません。

アダプターは、すべてのネイティブハーネスを同じライフサイクル（委任、観察、操縦、終了）に変換します。コアはプロバイダーの役割やモデル名をハードコードしません。

安定版: 1.0.14はWindowsを対象としています。MCP、パッケージ、localhost UI、Claude CodeおよびDeepSeekネイティブハーネス統合は準備ができています。

ランタイムの状態

• Claude Code — 準備完了。 ネイティブのClaude Codeハーネス、プロバイダー固有のモデルと推論設定、サブスクリプションOAuth ID、および出力を受け入れる前にライブの超過なしの証拠を使用します。

• DeepSeek Harness — 準備完了。 ネイティブのACPトランスポートとハーネス公開のモデルカタログを境界のあるタスクに使用します。MCP再起動後の再開、正確なプロバイダークォータの証拠、対話型入力、宣言されたMCPは、明示的な機能ギャップのままです。

他のランタイムはまだサポートされていません。将来のランタイムは、コア内のプロバイダー固有の分岐ではなくアダプターを使用します。

Related MCP server: AI Knowledge Center MCP

クイックスタート

1. インストール

必要に応じてuvをインストールし、正確な分離リリースを登録して、そのバックグラウンドUIを起動します：

winget install --id=astral-sh.uv -e
codex mcp add subagent-mcp -- uvx --isolated --from subagent-harness-mcp==1.0.14 subagent-harness-mcp serve
uvx --isolated --from subagent-harness-mcp==1.0.14 subagent-harness-mcp ui --background

登録後に新しいCodexタスクを開始します。

2. ランタイムの設定

ブラウザでhttp://127.0.0.1:8765を開きます。バックグラウンドUIが停止している場合は、同じ正確なリリースを再度起動します：

uvx --isolated --from subagent-harness-mcp==1.0.14 subagent-harness-mcp ui --background

設定と読み取り専用のアクティビティUIは固定ループバックポートに留まり、アクティブなMCP接続に依存しません。

現在および最近のアクティビティは外部エージェントごとに一覧表示されます。行を選択して、そのモデル、ネイティブハーネス、ワークスペース、権限、書き込みセット、現在のステージ、ライフサイクル、経過時間、および編集されたターミナル結果を検査します。プロンプト、トランスクリプト、隠れた思考、および生のプロバイダーイベントは決して表示されません。

3. 委任

平易な言葉でCodexに依頼します：

Subagent MCPを使用して外部エージェントにこの変更をレビューさせ、その結果を独立して評価してください。

Codexは何を委任するかを選択し、結果を観察し、最終判断を保持します。ライフサイクル応答はデフォルトでコンパクトです。完全な編集済みレポートはローカル製品状態に残り、後でハッシュバインド参照で読み取ったり中継したりできます。

モデルとフォールバック順序

各ネイティブハーネスは独自のモデル選択を公開します。UIはフレンドリ名と順序付き優先度スタックを表示します。正確なプロバイダーIDは高度なルートで利用可能なままです。

プロバイダーが明示的にクォータまたはクレジットの枯渇（QUOTA_PAUSED）を報告した場合、Subagent MCPはその正確なモデルを将来のタスクのために最下部に移動します。失敗したタスクを再試行しません。あいまいな失敗、クラッシュ、タイムアウトはモデルを並べ替えたり、別の有料リクエストをトリガーしたりしません。

その失敗したタスクは終端のままですが、次の明示的な委任はプロバイダーを再度ライブでチェックします。キャッシュされたリセットクロックや待機チェックポイントはそのチェックの代わりにはなりません。ネイティブハーネスが安全な事前リクエストクォータエンドポイントを公開しない場合、ステータスは枯渇と推測されるのではなく不明のままです。

運用上の回復は3つのアクションに制限されています。ローカル状態の作業または明示的に再試行可能なプロバイダー前の失敗のみが再試行される場合があります。すでに失敗したプロバイダータスクが自動的に再送信されることはありません。

DeepSeekルートは、ユーザーが承認した既存のサブスクリプション、無制限オファー、または資金提供された残高を使用する場合があります。Subagent MCPはその残高を購入、再ロード、または増加させることはありません。

並行ライター

書き込みタスクは、write_set内で最大32のリポジトリ相対ファイルまたはディレクトリルートを宣言できます。外部ライターは、それらの正規の絶対セットが互いに素である場合に並行して実行できます。等しいパスと親/子パスは競合します。タスク名とレーン名はロックに影響しません。

write_setを省略すると、後方互換性のために実行にワークスペース全体が与えられます。各アダプターは、ネイティブハーネス境界で正規化されたパスも強制します。現在のDeepSeek Harnessネイティブセッションは1つの書き込み可能なルートを受け入れます。マルチルートタスクは、拡大されるのではなく、コントローラーによっていくつかの互いに素なライター呼び出しに分解されます。真のシングルセッションマルチルートは、公式のACP additionalDirectoriesを宣伝し、それをネイティブに強制する将来のハーネスのために予約されています。これらのリースはSubagent MCP実行を調整します。それらは無関係なローカルプロセスのオペレーティングシステムサンドボックスではありません。

全体の構成

flowchart LR
    C["Codex<br/>Main agent & orchestrator"]
    M["Subagent MCP<br/>Gateway"]
    UI["Localhost UI<br/>Settings & activity"]

    C -->|"delegate · steer · observe"| M
    UI --> M

    subgraph E["External agent runtimes — adapter-driven"]
        R1["Model<br/>+<br/>native harness"]
        R2["Model<br/>+<br/>native harness"]
        RN["Future runtimes<br/>via adapters"]
    end

    M -->|"normalized lifecycle"| R1
    M -->|"normalized lifecycle"| R2
    M -->|"normalized lifecycle"| RN

Subagent MCPは、ライフサイクル正規化、ステータス、編集、リース、および回路を所有します。各アダプターはその契約をネイティブハーネスに変換します。完全な契約についてはアーキテクチャを参照してください。

Windowsでの更新またはロールバック

まだ実行中の可能性がある環境を再インストールせずにバージョンを切り替えます。最初のコマンドはソースバージョンを使用します。add/startコマンドはターゲットバージョンを使用します。この例では1.0.13から1.0.14にアップグレードします：

uvx --isolated --from subagent-harness-mcp==1.0.12 subagent-harness-mcp ui --stop
codex mcp remove subagent-mcp
codex mcp add subagent-mcp -- uvx --isolated --from subagent-harness-mcp==1.0.14 subagent-harness-mcp serve
uvx --isolated --from subagent-harness-mcp==1.0.14 subagent-harness-mcp ui --background

エントリを変更した後、新しいCodexタスクを開始します。既存のタスクは終了するまで古いランタイムを保持します。ロールバックするには、正確なバージョンを逆にして同じシーケンスを使用します。

UPDATE_QUARANTINEDを報告する実行中のMCPは、置き換えを安全にホットロードできません。その常駐を再試行しないでください。ネイティブフォールバックで終了し、新しいタスクから新しい正確な登録を使用してください。

直接のsubagent-harness-mcp serveエントリからの1回限りの移行では、最初に登録を置き換え、レガシータスクを自然に終了させます。置き換えた後、オプションで不要になった永続ツールを削除する前に、すべてのCodexウィンドウを一度閉じます。上記のすべての新しいコマンドがuvx --isolatedを使用するため、インストールしたままにしても安全です。

Subagent MCPは、Codex設定を編集したり、Codex/プロバイダープロセスを強制終了したり、uvキャッシュを独自にクリアしたりしません。

安全性と請求

• Subagent MCPは使用クレジットを有効にしたり、請求設定を変更したりしません。

• Claudeタスクは含まれるサブスクリプションクォータを消費できます。各タスクは、バインドされたCLI、サブスクリプション認証、資格情報の優先順位、および制御接続を検証し、その出力を受け入れる前に同じ応答からの安全なレート証拠を要求します。

• プロバイダーリフレッシュはモデルプロンプトを送信しません。ネイティブハーネスが応答前に正確なレート証拠を公開できない場合、ステータスはクォータ結果を発明したりリセットクロックを使用したりするのではなく不明のままです。

• フォールバックは明示的なクォータ枯渇後にのみ発生します。安全でないまたはあいまいな証拠が別の有料リクエストをトリガーすることはありません。

• ネイティブトランスクリプトはネイティブハーネスが所有します。製品状態は明示的なローカルルートに留まり、エージェント出力は信頼できないアドバイスとして扱う必要があります。

書き込みアクセスを有効にする前に、セキュリティと脅威モデルをお読みください。

プロジェクト

• アーキテクチャ

• アダプター作成

• コントリビューティング

• 変更履歴

• MITライセンス