コンテンツにスキップ
Zenn Dev Nanananano B8022ca6aa1cc4

Codex の MCP 導入方法整理 — config.toml / Claude Code との比較(2026年6月時点)

  • URL: https://zenn.dev/nanananano/articles/b8022ca6aa1cc4

  • 日付: 2026-06-14

  • Tier: Tier 3

  • 要旨: Codex の MCP 設定方法(config.toml)を Claude Code との違いに触れながら整理。設定スコープ(ユーザー/プロジェクト)、stdio/Streamable HTTP の2トランスポート、codex mcp add コマンドと config.toml 直接編集の2方法を解説。CLI と IDE 拡張は同じ設定レイヤーを参照する。

詳細

  • 設定スコープ: ユーザー(~/.codex/config.toml)とプロジェクト(.codex/config.toml、信頼済みのみ)。優先順位: CLI フラグ > プロジェクト config > プロファイル config > ユーザー config > システム config。
  • stdio サーバー設定: [mcp_servers.name] テーブルに command/args/cwd を記述。環境変数は env_vars(既存環境変数を許可)か [mcp_servers.name.env](固定値)で渡す。
  • Streamable HTTP: url を指定。--url フラグで CLI 追加。OAuth 対応あり(codex mcp login)。Bearer Token は --bearer-token-env-var で環境変数から読み込む。
  • Claude Code との主な違い: Codex は .claude/settings.json ではなく .codex/config.toml で管理。Claude Code は JSON 形式、Codex は TOML 形式。