Codex に MCP サーバーを足すと、外のツールやデータを Codex から使えるようになります。
- コマンドのサーバー：codex mcp add 名前 — 起動するコマンド
- URL のサーバー：codex mcp add 名前 –url https://… –bearer-token-env-var 変数名
- 設定は ~/.codex/config.toml の [mcp_servers.名前] に書かれる
- CLI・デスクトップアプリ・IDE の拡張機能で同じ設定を使う
この記事は、OpenAI の Codex の公式ドキュメント（developers.openai.com/codex、2026年9月29日に確認）にもとづいています。
手元の確認は、Codex CLI 0.158.0 で、ふだんの設定に触れないよう、練習用の設定フォルダー（CODEX_HOME=C:\demo\codex-mcp）を使って行いました。
追加して、config.tomlの中身を見た
$env:CODEX_HOME = "C:\demo\codex-mcp"
codex mcp add everything -- npx -y @modelcontextprotocol/server-everything
codex mcp add docs --url https://example.com/mcp --bearer-token-env-var DOCS_TOKENAdded global MCP server 'everything'.
Added global MCP server 'docs'.config.toml には、次のように書かれました。
[mcp_servers.everything]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-everything"]
[mcp_servers.docs]
url = "https://example.com/mcp"
bearer_token_env_var = "DOCS_TOKEN"トークンそのものではなく、トークンを入れた環境変数の名前（DOCS_TOKEN）が書かれます。
一覧・確認・削除
codex mcp listName Command Args Env Cwd Status Auth
everything npx -y @modelcontextprotocol/server-everything - - enabled Unsupported
Name Url Bearer Token Env Var Status Auth
docs https://example.com/mcp DOCS_TOKEN enabled Bearer tokencodex mcp get everythingeverything
enabled: true
transport: stdio
command: npx
args: -y @modelcontextprotocol/server-everything
cwd: -
env: -
remove: codex mcp remove everythingcodex mcp remove docsRemoved global MCP server 'docs'.削除すると、config.toml から [mcp_servers.docs] の表が消えました。
| コマンド | 働き |
|---|---|
| codex mcp add | 追加（–env でサーバーに渡す環境変数、–url で HTTP） |
| codex mcp list / get | 一覧・1件の表示（–json も可） |
| codex mcp remove | 削除 |
| codex mcp login / logout | OAuth に対応した HTTP サーバーのログイン・ログアウト |
config.tomlの主な項目
| 項目 | 意味 |
|---|---|
| command・args | 起動するコマンドと引数（STDIO） |
| env | サーバーに設定する環境変数 |
| env_vars | 手元の環境から引き継ぐ変数の名前 |
| url | HTTP のサーバーの URL |
| bearer_token_env_var | ベアラートークンを入れた環境変数の名前 |
| startup_timeout_sec | 起動の待ち時間（初期値10秒） |
| tool_timeout_sec | ツールの実行の待ち時間（初期値60秒） |
| enabled = false | 消さずに止める |
| enabled_tools・disabled_tools | 使うツール・使わないツール |
プロジェクトごとの設定は .codex/config.toml に書けますが、信頼したプロジェクトでだけ読まれます。
config.toml のほかの項目は、Codexのconfig.tomlの設定一覧で紹介しています。
起動しないとき
- 起動に時間がかかるサーバーは startup_timeout_sec を延ばす
- Codex の画面で /mcp を開き、有効なサーバーを確かめる
- npx のサーバーは、Node.js が入っていて PATH が通っているか確かめる
Claude Code での追加は、Claude CodeのMCPサーバーの追加で紹介しています。
まとめ
- codex mcp add 名前 — コマンド、または –url
- 設定は config.toml の [mcp_servers.名前]
- トークンは環境変数の名前で渡す（bearer_token_env_var）
- list・get・remove で管理する
参考：OpenAI「Model Context Protocol」「Codex CLI reference」（2026年9月29日に確認）と、Codex CLI 0.158.0 での実行結果。
よくある質問：CodexにMCPサーバーを追加するとき
CodexにMCPサーバーを追加するには、どうしますか？
コマンドで起動するサーバーは codex mcp add 名前 — 起動するコマンド、URLのサーバーは codex mcp add 名前 –url https://… –bearer-token-env-var 変数名 で追加します。設定は ~/.codex/config.toml の [mcp_servers.名前] に書かれます。
トークンは、config.toml にそのまま書かれますか？
書かれません。トークンそのものではなく、トークンを入れた環境変数の名前（記事の例では DOCS_TOKEN）が書かれます。URLのサーバーでは、bearer_token_env_var に環境変数の名前を指定します。
追加したサーバーを、一覧・確認・削除するには？
codex mcp list で一覧、codex mcp get で1件の表示ができ（–json も可）、codex mcp remove で削除します。削除すると、config.toml から [mcp_servers.名前] の表が消えます。OAuthに対応したHTTPサーバーのログイン・ログアウトは、codex mcp login / logout です。
CLI、デスクトップアプリ、IDEで、設定は別々ですか？
同じ設定を使います。CLI・デスクトップアプリ・IDEの拡張機能のどれでも、config.toml の設定が共通です。
config.toml の主な項目には、何がありますか？
command・args（起動するコマンドと引数）、env（サーバーに設定する環境変数）、env_vars（手元の環境から引き継ぐ変数の名前）、url（HTTPサーバーのURL）、bearer_token_env_var、startup_timeout_sec（起動の待ち時間、初期値10秒）、tool_timeout_sec（ツールの実行の待ち時間、初期値60秒）、enabled = false（消さずに止める）、enabled_tools・disabled_tools（使うツール・使わないツール）などです。
プロジェクトごとに、MCPの設定を分けられますか？
.codex/config.toml に書けますが、信頼したプロジェクトでだけ読まれます。
MCPサーバーが起動しないときは？
起動に時間がかかるサーバーは startup_timeout_sec を延ばします。Codexの画面で /mcp を開き、有効なサーバーを確かめます。npx のサーバーは、Node.js が入っていてPATHが通っているかを確かめます。
記事の内容は、実機で確認されていますか？
手元の確認は、Codex CLI 0.158.0 で、ふだんの設定に触れないよう練習用の設定フォルダーを使って行ったと書かれています。それ以外は、OpenAIの公式ドキュメント（2026年9月29日に確認）にもとづきます。バージョンによって動きが変わることがあるので、最新は公式ページで確認してください。
