OpenAI Codex CLIにMCPサーバーを追加

Codex は config.toml にサーバーを保存します。サーバーごとに [mcp_servers.<name>] テーブルを作成します。codex mcp add で追加することもできます。

macOS

~/.codex/config.toml

Windows

~/.codex/config.toml

Linux

~/.codex/config.toml

プロジェクトファイル

.codex/config.toml (trusted projects only)

トップレベルキー

mcp_servers

形式

toml

リモートサーバーのOAuth

●はい

設定例

この例では、GitHub のホスト型サーバーと Playwright のローカルサーバーを、このクライアントが想定する形式で追加します。

[mcp_servers.github]
url = "https://api.githubcopilot.com/mcp/"

[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]

codex mcp add github --url https://api.githubcopilot.com/mcp/
codex mcp add playwright -- npx @playwright/mcp@latest

注意点と仕様

• 同じ config.toml が Codex CLI、Codex IDE 拡張機能、ChatGPT デスクトップアプリで読み込まれます。
• プロジェクトの .codex/config.toml は、信頼済みのプロジェクトでのみ読み込まれます。
• env_vars は変数名を指定してシェルの変数を転送します。bearer_token_env_var は変数のトークンをリモートサーバーに送信します。
• サーバーごとのオプションには startup_timeout_sec、tool_timeout_sec、enabled_tools、disabled_tools があります。
• codex mcp login <name> を実行すると OAuth 認証が行われます。CIMD と動的登録の両方に対応しています。

OpenAI Codex CLIの設定を作成 →

その他のクライアント