Codex CLI に MCP サーバーを設定する:config.toml の書き方と接続確認

公式ドキュメントが OAuth ログインの手順として挙げているのは CLI のコマンドです。「For a server that supports OAuth, run codex mcp login <server-name>」と書かれています。デスクトップアプリのボタンについての記載はありません。CLI で通るなら、まずそちらを正規の手順として扱ってください。

設定は 3 つのクライアント(ChatGPT デスクトップアプリ、Codex CLI、IDE 拡張)で共有されます。既定の保存先は ~/.codex/config.toml です。つまり CLI でログインした結果は、同じ設定を読む他のクライアントからも使えます。

事前登録済みのクライアントを使う場合、クライアント ID はサーバーの追加時に渡します。

codex mcp add example --url https://mcp.example.com --oauth-client-id my-client

機密クライアントなら、シークレットも渡します。環境変数から読む形にしてください。

codex mcp add example --url https://mcp.example.com \
  --oauth-client-id my-client --oauth-client-secret "$MCP_CLIENT_SECRET"

クライアント ID とコールバックは、次の形で config.toml に保存されます。

[mcp_servers.example]
url = "https://mcp.example.com"

[mcp_servers.example.oauth]
client_id = "my-client"
callback_url = "http://127.0.0.1/callback"

コールバックの既定は http://127.0.0.1/callback です。ポートや URL を変える必要があれば、mcp_oauth_callback_port と mcp_oauth_callback_url で上書きできます。登録方式を 1 回のログインだけ指定したい場合は codex mcp login <server-name> --oauth-client-registration cimd(または dcr)を使います。既定は auto で、この指定は config.toml には保存されません。

設定済みのサーバーの一覧は codex mcp list、対話中の状態は /mcp で確認できます。サーバーの追加方法は Codex CLI に MCP サーバーを追加する config.toml の書き方 にまとめてあります。

まず仕様として確認できる部分と、確認できない部分を分けます。

確認できる部分: ツール単位の承認は公式に設定できます。サーバー全体の既定が default_tools_approval_mode、個別のツールの上書きが tools.<tool>.approval_mode です。公式ドキュメントの記述は「Default approval behavior for tools from this server. Supported values are auto, prompt, writes, and approve」と「Per-tool approval behavior override」です。

[mcp_servers.google-ads]
command = "..."
default_tools_approval_mode = "prompt"

[mcp_servers.google-ads.tools.list_accounts]
approval_mode = "approve"

確認できない部分: 4 つの値のうち、公式ドキュメントが意味を説明しているのは writes だけです(「The writes mode prompts for tools that aren't marked read-only」)。auto、prompt、approve が具体的に何をするかは、設定リファレンスにも MCP のページにも書かれていません。

ただし公式の設定例は、サーバーの既定を prompt にしたうえで、特定のツールだけ approval_mode = "approve" にする形になっています。この並びからは approve の方が緩い(プロンプトを出さない)側として使われていると読めますが、ドキュメントがそう明言しているわけではありません。

「Always allow」の持続範囲: UI で選ぶ「Always allow」がチャットをまたいで残るかどうかは、公式ドキュメントでは確認できませんでした。Codex のドキュメントで「Always allow」の持続について書かれているのは Browser Use と Windows の Computer Use の項目で、MCP ツールについての記述はありません。

承認を出さずに済ませる別の手として、enabled_tools(公開するツールの許可リスト)と disabled_tools(その後に適用される拒否リスト)があります。ただしこれはツールを出すかどうかの制御で、承認の挙動を変えるものではありません。

MCP サーバーの設定の全体像は Codex に MCP サーバーを追加する にまとめてあります。