ChatGPT Bridge Local Supervisor

ChatGPT ウェブ版を OpenAI 公式 Secure MCP Tunnel 経由で安全に、あなたが明示的に公開したローカルプロジェクトを閲覧・操作できるようにします。

次のようなワークフローに適しています：ChatGPT がプロジェクト全体を把握し、未コミットの進捗確認、差分レビュー、施工カードの作成を担当；ローカルの施工エージェントが実際の作業を担当します。必要に応じて、ChatGPT が許可範囲内のファイルを直接修正し、プロジェクト既存のチェックを実行してローカルプレビューを確認することもできます。

Windows ファースト、Node.js サードパーティ依存ゼロ。OpenAI 公式プロジェクトではありません。トンネルクライアントは OpenAI 公式のオープンソースプロジェクトを使用しています。

できること

• 設定済みプロジェクトとそのすべての Git worktree を動的に一覧表示。

• ファイルの読み取り、テキスト検索、Git の status・diff・log・commit 内容の確認。

• ファイルの作成；既存ファイルを上書きする前に、直近の読み取りで返された SHA-256 の提供が必須。

• 一意なテキスト断片の正確な置換。複数箇所の誤置換を防止。

• 削除はブリッジ自身の復元可能領域への移動に変更され、復元に対応。

• 明示的に列挙されたファイルのみコミット。無関係なステージ済みファイルの混入は拒否。

• 現在のブランチへの非強制プッシュのみ許可。明確な確認フレーズを要求。

• プロジェクト既存の check/test/lint/typecheck/verify スクリプトのみ実行。

• プロジェクト既存の dev/start スクリプトのみ起動。ログの読み取り、停止が可能。

• localhost ページのスクリーンショット取得による Web ページ検証の補助。

持っていません：任意シェル実行、強制プッシュ、ハードリセット、マージ、完全削除、またはキー読み取りのツール。

Related MCP server: OpenAI Secure MCP Tunnel

セキュリティ境界

ChatGPT web
    │
    ▼
OpenAI-hosted Secure MCP Tunnel endpoint
    ▲
    │ outbound HTTPS only
    │
tunnel-client on your PC
    │ local stdio
    ▼
this bridge ── allowlisted projects and Git worktrees
              denyRoots, secret filters, SHA write guard

サーバー側で以下のルールが強制されます。プロンプトだけで回避することはできません：

• config.json 内のプロジェクトルートとその Git worktree のみアクセス可能。

• denyRoots 配下のディレクトリは常に拒否。

• .env、資格情報、トークン、証明書、.ssh、.git 内部ディレクトリは拒否。

• シンボリックリンクやジャンクションによるワークスペース外への脱出は不可。

• ブリッジ自身のソースコード、設定、実行キー、ログはブリッジによる読み取り・変更が不可。

完全な脅威モデルは SECURITY.md を参照。

料金とプラン

本プロジェクトは Responses API や Chat Completions API を呼び出しません。モデル推論は通常の ChatGPT ウェブ会話内で行われます。Platform runtime API key は tunnel-client が OpenAI Tunnel コントロールプレーンへの認証にのみ使用します。

公開版は 2026-08-22 に ChatGPT Pro ウェブ版で読み書きの実測を完了しています。Plus や他のプランについては、プラン名だけで判断せず、あなたのアカウントで以下の入り口が実際に表示されるかを確認してください：

1. Developer mode；

2. カスタムプラグイン/アプリの作成；

3. Connection で Tunnel を選択可能；

4. 対象チャットでプラグインの書き込みツールの呼び出しが許可されている。

OpenAI は機能の提供範囲を調整する可能性があり、チームワークスペースは管理者の制御を受ける場合があります。そのため、本プロジェクトはすべての Plus アカウントでこれらの入り口が利用可能であることを保証しません。実際の判断基準は、現在のアカウントのインターフェースと、実際に行った低リスクの読み書きテストです。

準備

• Windows 10/11；

• Node.js 20 以降；

• Git；

• OpenAI 公式 tunnel-client の Windows 版；

• 1 つの Secure MCP Tunnel；

• Tunnels Read + Use 権限のみを持つ runtime API key 1 つ；

• ChatGPT で利用可能な Developer mode とカスタムプラグインの入り口。

公式資料：

• Secure MCP Tunnel ドキュメント

• OpenAI tunnel-client ソースコードとリリース

• ChatGPT / Codex MCP ドキュメント

クイックスタート

git clone https://github.com/VITASID57/chatgpt-local-supervisor-bridge.git
cd chatgpt-local-supervisor-bridge

公式 Release から Windows 版 tunnel-client.exe をダウンロードし、以下に配置：

vendor\tunnel-client.exe

初期化を実行。キー入力は表示されず、Windows DPAPI で現在のユーザーに暗号化されます：

.\scripts\setup.ps1

生成された config.json を編集し、ChatGPT に渡してもよいプロジェクトのみを記入し、すべてのプライベートディレクトリを denyRoots に入れます。その後、以下で確認：

.\scripts\start-tunnel.ps1 -Mode doctor
npm run check

フォアグラウンドで起動：

.\scripts\start-tunnel.ps1

接続が正常であることを確認したら、ログイン時の自動起動としてインストール可能：

.\scripts\install-autostart.ps1

ChatGPT ウェブ版での完全な接続手順は Windows 中国語インストールチュートリアル を参照。

推奨される最初のプロンプト

只使用 Local Supervisor Bridge。先调用 list_workspaces，选择目标项目，
再读取项目规则、NOW/README、Git 状态和未提交差异。
先给出当前事实、风险和下一张施工卡；除非我明确要求，否则先不要修改文件。

最初の書き込みは、重要ではない検収用ファイルの作成のみにしてください。その後 read_file で読み戻し、SHA-256 を照合します。検収後は move_to_trash でクリーンアップします。

停止と取り消し

.\scripts\uninstall-autostart.ps1

これによりログインタスクは停止・削除されますが、ソースコード、設定、DPAPI で暗号化されたキーは保持されます。完全に使用を終了する場合は、OpenAI Platform で runtime key を取り消し、不要になった Tunnel を削除してください。

開発

npm test
npm run smoke
npm run check
.\scripts\verify-public.ps1

Issue と PR を歓迎します。貢献ルールは CONTRIBUTING.md を参照。

ライセンス

MIT。OpenAI tunnel-client はこのリポジトリには含まれておらず、その独自の Apache-2.0 ライセンスが適用されます。