chatgpt-mcp

Linuxコンピュータ上の明示的に設定された機能をChatGPTまたは互換性のあるMCPクライアントに公開するステートレスなMCPサーバー。

ChatGPT / MCP client
        |
        | MCP 2026-07-28
        v
chatgpt-mcp
        |
        | typed ComputerAdapter seam
        v
local operating system

ChatGPTは呼び出すツールを選択します。chatgpt-mcpはローカルの機能設定に対して呼び出しを検証し、操作を実行します。これは薄いプロトコルアダプタであり、第二のプランナーではなく、独自の対話型承認ループを追加しません。

アーキテクチャ: SPEC.md。提供履歴: PLAN.md。詳細なChatGPT/トンネルガイド: docs/CHATGPT.md。

機能

system.infoを除くすべてのファミリーはオプトインです。無効な機能ファミリーは、実用的な場合にMCPツールの検出から除外されます。

Related MCP server: AX Local Operations MCP Server

要件

コアサーバー:

• Linux

• Node.js 22+

• pnpm 11.20.0（インストーラはCorepackまたはnpxを介して固定バージョンを取得します）

• ./install.shによってインストールされる永続トンネル用のsystemdユーザーサービス

オプションのホストコマンドは、有効にする内容によって異なります:

• サービス: systemctl

• ブラウザを開く: xdg-open

• デスクトップ入力: xdotool

• スクリーンショット: grim、gnome-screenshot、scrot、またはImageMagick importのいずれか

クイックインストーラは、不足している場合に現在の公式OpenAI tunnel-clientと一般的なDebian/Ubuntuデスクトップヘルパーをインストールできます。

クイックインストール: ChatGPT + あなたのLinuxコンピュータ

1台のコンピュータの場合、推奨される方法は次のとおりです:

ChatGPT Developer Mode
        |
OpenAI Secure MCP Tunnel
        |
        | outbound HTTPS
        v
tunnel-client on your computer
        |
        | stdio
        v
chatgpt-mcp

パブリックなインバウンドリスナーは不要です。

クイックインストーラは意図的にconfig.full.example.jsonを使用します。これは、/からのファイルシステム読み取り/書き込み、ワイルドカードの実行可能ファイルアクセス、プロセス/サービス制御、ブラウザを開く、スクリーンショット、サポートされている場合はデスクトップ入力など、広範な所有者制御アクセスを許可します。より狭い権限が必要な場合は、代わりにconfig.example.jsonと手動セットアップを使用してください。

1. OpenAI MCPトンネルを作成する

開く:

https://platform.openai.com/settings/organization/tunnels

トンネルを作成し、そのIDをコピーします。次のようになります:

tunnel_0123456789abcdef0123456789abcdef

ChatGPTで使用するには、トンネルを表示できるChatGPTワークスペース/アカウントに関連付けます。

現在の権限の分割:

• トンネルの作成/編集/削除: Tunnels Read + Manage

• tunnel-clientを実行するか、ChatGPTでトンネルを選択: Tunnels Read + Use

2. ランタイムAPIキーを作成する

開く:

https://platform.openai.com/settings/organization/api-keys

通常のランタイムAPIキーを作成します。長期実行トンネルデーモンにはAdmin APIキーを使用しないでください。

インストーラは、非表示のターミナル入力で結果のsk-...値を要求し、制限付き権限で.secrets/runtime-api-keyにローカルに保存します。

トンネルにAPIキーが必要な理由

このキーは、tunnel-clientをOpenAIのトンネルコントロールプレーンに対して認証します。ローカルデーモンが選択したトンネルを使用することを許可されていることを証明します。

これは、chatgpt-mcpがOpenAIモデルAPIを呼び出すために使用されるものではありません。このセットアップでは、ChatGPTがすでにモデル/クライアントです。Secure MCP Tunnelは、そのChatGPT会話がローカルMCPサーバーに到達できるようにするプライベートトランスポートにすぎません。

tunnel_...   = which tunnel this computer belongs to
sk-...       = permission for tunnel-client to use that tunnel

chatgpt-mcpは、このランタイムキーを使用して/v1/responsesやその他のモデル推論リクエストを行いません。OpenAI APIモデルの課金はChatGPTサブスクリプションの使用とは別です。現在のSecure MCP Tunnelドキュメントには、個別のトンネル価格スケジュールは公開されていません。変更がある場合は、現在のOpenAIドキュメントを確認してください。

3. リポジトリをクローンしてインストーラを実行する

git clone https://github.com/alexcodeplace/chatgpt-mcp.git
cd chatgpt-mcp
./install.sh

インストーラ:

• トンネルIDとランタイムAPIキーがまだ提供されていない場合は要求します。

• 両方の値を.secrets/の下で保護します。

• 書き込み可能な/usr/bin Corepackシムを必要とせずに、プロジェクト固定のpnpm 11.20.0を取得します。

• 依存関係をインストールし、完全なプロジェクトゲートを実行します。

• 広範な制御テンプレートからconfig.local.jsonを作成します。

• サポートされているLinuxアーキテクチャで不足している場合、公式OpenAI tunnel-clientをインストールします。

• 必要に応じてDebian/Ubuntuに一般的なデスクトップヘルパーをインストールします。

• chatgpt-computerトンネルプロファイルを初期化します。

• 一時的なループバックヘルスポートを使用するため、ポート8080の既存サービスがインストールをブロックしません。

• tunnel-client doctor --explainを実行します。

• ~/.config/systemd/user/chatgpt-mcp-tunnel.serviceをインストールして起動します。

• サービスとトンネルの診断を検証します。

非対話型セットアップもサポートされています:

export CONTROL_PLANE_TUNNEL_ID='tunnel_0123456789abcdef0123456789abcdef'
export CONTROL_PLANE_API_KEY='sk-...'
./install.sh --yes

APIキーを./install.sh ...コマンドラインに直接置いたり、Gitにコミットしたりしないでください。

オプションのデスクトップパッケージのインストールをスキップするには:

./install.sh --no-desktop

4. ChatGPTに追加する

トンネルサービスが実行されている間:

1. ChatGPT WebでSettings → Security and login → Developer modeを開き、有効にします。

2. **https://chatgpt.com/plugins**を開きます。

3. プラスボタンを選択し、開発者モードアプリを作成します。

4. ConnectionでTunnelを選択します。

5. 作成したトンネルを選択するか、提供されたときにそのtunnel_idを貼り付けます。

6. 会話で新しいアプリを有効にします。

7. 最初のテスト: Use my computer MCP's system.info tool and report the hostname and enabled capabilities.

トンネルが一覧にない場合は、そのChatGPTワークスペースの関連付けとTunnels Read + Use権限を確認してください。

ステータスとアンインストール

./scripts/tunnel-status.sh

ステータスコマンドは保存されたランタイムキー自体をロードし、一時的なヘルスリスナーを使用するため、診断を実行するためだけにCONTROL_PLANE_API_KEYを手動でエクスポートする必要はありません。

ローカル設定/シークレットをそのままにして、永続ユーザーサービスを削除します:

./scripts/tunnel-uninstall.sh

手動インストール / 開発

リポジトリはpnpm 11.20.0を固定しています。Corepackはcorepack enableなしでその正確なバージョンを強制できます:

git clone https://github.com/alexcodeplace/chatgpt-mcp.git
cd chatgpt-mcp
corepack pnpm@11.20.0 install
corepack pnpm@11.20.0 gate

pnpm gateは型チェック、動作テスト、TypeScriptビルドを実行します。

Corepackが利用できない場合は、代わりにnpx -y pnpm@11.20.0を使用してください。

手動で設定する

cp config.example.json config.local.json
export CHATGPT_MCP_CONFIG="$PWD/config.local.json"

デフォルト設定ではsystem.infoのみが公開されます。すべての機能ファミリーについてはconfig.example.jsonを参照してください。config.local.jsonと.secrets/はgitignoreされています。

意図的に広範な権限が必要な場合は、代わりにconfig.full.example.jsonをコピーしてください。

stdioで起動する

corepack pnpm@11.20.0 build
CHATGPT_MCP_CONFIG="$PWD/config.local.json" node dist/src/stdio.js

stdoutはMCPプロトコルトラフィック用に予約されています。診断はstderrに出力されます。

HTTPで起動する

corepack pnpm@11.20.0 build
CHATGPT_MCP_CONFIG="$PWD/config.local.json" corepack pnpm@11.20.0 start:http

デフォルトエンドポイント:

http://127.0.0.1:3210/mcp

ヘルスチェック:

curl http://127.0.0.1:3210/healthz

HTTPはステートレスです。許可されたホストが明示的に設定されていない限り、非ループバックバインドは拒否されます。

信頼境界

• ファイルシステム操作は、トラバーサル、兄弟プレフィックスのトリック、シンボリックリンクエスケープを拒否する中央パス認証を通過します。

• shell.execは、暗黙のsh -cなしで、直接実行可能ファイル+引数配列のスポーンを使用します。

• サービスとアプリケーションは、呼び出し前に設定された権限に対してチェックされます。

• ブラウザスキームは開く前に検証されます。

• デスクトップ入力とスクリーンショットは、境界のある入力/出力を持つ個別のオプトイン機能です。

完全な契約についてはSPEC.mdを参照してください。

開発

corepack pnpm@11.20.0 typecheck
corepack pnpm@11.20.0 test
corepack pnpm@11.20.0 build
corepack pnpm@11.20.0 gate

GitHub Actionsは、プッシュとプルリクエストで同じゲートを実行し、インストーラスクリプトの構文チェックを行います。

プラットフォームの制限

• 具体的なアダプタはLinux向けです。

• process.listはpsを使用します。

• service.*はデフォルトでsystemdのsystemctlを使用します。

• input.*はxdotoolを使用します。ネイティブWaylandではXWaylandまたは将来のコンポジタ固有アダプタが必要になる場合があります。

• screen.captureは一般的なLinuxスクリーンショットコマンドをサポートします。デスクトップ/セッションの権限は引き続き適用されます。

• 自動インストーラはLinux amd64/arm64とsystemdユーザーサービスを対象としています。

• 外部ChatGPT/トンネルスモークテストには、オペレータ自身のOpenAIトンネルID/ランタイム資格情報が必要です。リポジトリCIはそれらを偽装できません。

上流の参照

• MCP TypeScript SDK: https://github.com/modelcontextprotocol/typescript-sdk

• MCP仕様: https://modelcontextprotocol.io/specification/2026-07-28

• OpenAI Secure MCP Tunnel: https://developers.openai.com/api/docs/guides/secure-mcp-tunnels

• OpenAI tunnel-client: https://github.com/openai/tunnel-client

• OpenAIトンネル管理: https://platform.openai.com/settings/organization/tunnels

• OpenAIランタイムAPIキー: https://platform.openai.com/settings/organization/api-keys

• ChatGPT開発者モード: https://developers.openai.com/api/docs/guides/developer-mode