codex-mcp-bridge

ChatGPT と公式ローカル Codex MCP サーバー間の小さなポリシーレイヤー。

ChatGPT
  -> OpenAI Secure MCP Tunnel
  -> codex-mcp-bridge (loopback HTTP)
  -> codex mcp-server (stdio)
  -> one explicitly allowed repository

公式の Codex MCP サーバーはすでに codex と codex-reply を提供しています。このブリッジは、ChatGPT から日常的に安全に使用するために必要なコントロールのみを意図的に追加します：

• bridge_status: アクティブなポリシーを検査します。

• codex_read: 読み取り専用の Codex セッションを強制します。

• codex_run: ポリシーで制限された読み取りまたは書き込みセッションを開始します。

• codex_reply: このブリッジを介して作成されたスレッドのみを続行します。

• codex_job_status: 長時間実行される結果を取得します。

セキュリティのデフォルト

• 127.0.0.1 にバインドします。

• ルートが明示的に設定されていない限り、1 つのカレントワーキングディレクトリを許可します。

• read-only Codex サンドボックスを使用します。

• on-request 承認ポリシーを使用します。

• danger-full-access を公開しません。

• ブリッジ所有者が書き込みプロファイルを開始しない限り、ワークスペースへの書き込みをブロックします。

• 設定された実パスルートの外側のパスを拒否します。

• 所有者が事前チェックを明示的に無効にしない限り、一般的なシークレットファイル名を含むリポジトリを拒否します。

• プロンプトサイズと同時 Codex ジョブを制限します。

• ローカルデバッグログが有効でない限り、アップストリームの Codex stderr を抑制します。

これらの制御はポリシーレイヤーであり、OS レベルの分離ではありません。厳格な分離が必要な場合は、ステージングコピー、コンテナ、VM、または別の OS ユーザーを使用してください。

Related MCP server: mcp-governance-proxy

必要条件

• Node.js 20 以降。Node.js 22 を推奨します。

• Codex CLI がインストールされ、認証され、codex mcp-server を提供していること。

• ChatGPT アクセス用の tunnel-client と OpenAI Secure MCP Tunnel。

公式リファレンス：

• Run Codex as an MCP server

• Secure MCP Tunnel

インストール

npm ci
npm run check

ローカルスモークテスト

ローカルモードはパブリックエンドポイントを作成しません：

npm run bridge:local -- --root /absolute/path/to/repository

MCP エンドポイントは http://127.0.0.1:8876/mcp、ヘルスエンドポイントは http://127.0.0.1:8876/healthz です。

セキュア MCP トンネル

OpenAI Platform でトンネルを作成し、このリポジトリの外でそのランタイム認証情報を提供します：

export CONTROL_PLANE_API_KEY="<runtime-key>"
export CONTROL_PLANE_TUNNEL_ID="tunnel_..."

npm run bridge:secure -- --root /absolute/path/to/repository

ランチャーはブリッジをビルドし、ループバックで起動し、トンネルプロファイルを初期化し、tunnel-client doctor を実行して、トンネルクライアントを実行し続けます。

意図的な書き込みセッションの場合：

npm run bridge:secure -- --root /absolute/path/to/repository --write

不要なのに書き込みプロファイルを実行したままにしないでください。

macOS キーチェーン

security add-generic-password -a "$USER" -s "codex-mcp-bridge:control-plane-api-key" -w "<runtime-key>" -U
security add-generic-password -a "$USER" -s "codex-mcp-bridge:control-plane-tunnel-id" -w "tunnel_..." -U

CODEX_MCP_BRIDGE_ROOT=/absolute/path/to/repository npm run bridge:secure:keychain

意図的な書き込みセッションにのみ bridge:secure:write:keychain を使用してください。

設定

古い CODEX_GPT_BRIDGE_* 変数プレフィックスは、アップストリーム互換性のために一時的に受け入れられます。

ChatGPT のセットアップ

docs/chatgpt-setup.md を参照してください。

アップストリーム

このリポジトリは DeepCogNeural/codex-gpt-bridge から MIT ライセンスの下で派生しています。このフォークの範囲については UPSTREAM.md を参照してください。