Zenn Dev Nanananano B8022ca6aa1cc4
Codex の MCP 導入方法整理 — config.toml / Claude Code との比較(2026年6月時点)
日付: 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 形式。