Codex│MCPサーバーの追加方法｜codex mcp addとconfig.tomlの書き方

2026年9月29日

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_TOKEN

Added 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 list

Name        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 token

codex mcp get everything

everything
  enabled: true
  transport: stdio
  command: npx
  args: -y @modelcontextprotocol/server-everything
  cwd: -
  env: -
  remove: codex mcp remove everything

codex mcp remove docs

Removed 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 サーバーのログイン・ログアウト

codex mcp –help と公式ドキュメントをもとに作成

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	使うツール・使わないツール