MCP

Model Context Protocol (MCP) 将模型连接到 tools 和 context。可以用它让 Codex 访问 third-party documentation，或让 Codex 与你的 browser、Figma 等 developer tools 交互。

Codex 在 CLI 和 IDE extension 中都支持 MCP servers。

如果你为 Codex 构建或维护 MCP server，请用 instructions 描述跨工具 workflows、constraints，以及适用于整个 server 的 rate limits。前 512 个字符应自包含，确保 Codex 判断如何使用该 server 时能拿到最重要的 guidance。

Codex 会把 MCP configuration 与其他 Codex configuration settings 一起存储在 config.toml 中。默认位置是 ~/.codex/config.toml；你也可以用 .codex/config.toml 将 MCP servers 限定到某个项目（仅 trusted projects）。

CLI 和 IDE extension 共享这份 configuration。配置 MCP servers 后，可以在两个 Codex clients 之间切换，无需重新 setup。

要配置 MCP servers，请选择一种方式：

codex mcp add <server-name> --env VAR1=VALUE1 --env VAR2=VALUE2 -- <stdio server-command>

例如，要添加 Context7（一个面向 developer documentation 的免费 MCP server），可以运行以下 command：

codex mcp add context7 -- npx -y @upstash/context7-mcp

要查看所有可用的 MCP commands，可以运行 codex mcp --help。

在 codex TUI 中，使用 /mcp 查看 active MCP servers。

如果需要更细粒度地控制 MCP server options，请编辑 ~/.codex/config.toml（或项目级 .codex/config.toml）。在 IDE extension 中，可以从 gear menu 选择 MCP settings > Open config.toml。

在 configuration file 中，用 [mcp_servers.<server-name>] table 配置每个 MCP server。

env_vars 可以包含普通 variable names，也可以包含带 source 的 objects：

env_vars = ["LOCAL_TOKEN", { name = "REMOTE_TOKEN", source = "remote" }]

String entries 和 source = "local" 会从 Codex 的 local environment 读取。source = "remote" 会从 remote executor environment 读取，并且需要 remote MCP stdio。

如果你的 OAuth provider 要求固定 callback port，请在 config.toml 中设置 top-level mcp_oauth_callback_port。如果未设置，Codex 会绑定到 ephemeral port。

如果你的 MCP OAuth flow 必须使用特定 callback URL（例如 remote Devbox ingress URL 或 custom callback path），请设置 mcp_oauth_callback_url。Codex 会把这个值作为 base callback URL，然后追加 server-specific callback ID，生成登录期间发送的 OAuth redirect_uri。请向 OAuth provider 注册完整派生出的 redirect_uri，包括追加的 callback ID，以及任何已配置的 path、query 或 port，而不是只注册 base host 或不带 suffix 的 path。Local callback URLs（例如 localhost）会绑定到 local interface；non-local callback URLs 会绑定到 0.0.0.0，以便 callback 能到达 host。

如果 MCP server advertises scopes_supported，Codex 在 OAuth login 期间会优先使用这些 server-advertised scopes。否则，Codex 会 fallback 到 config.toml 中配置的 scopes。

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]
env_vars = ["LOCAL_TOKEN"]

[mcp_servers.context7.env]
MY_ENV_VAR = "MY_ENV_VALUE"

# Optional MCP OAuth callback overrides (used by `codex mcp login`)
mcp_oauth_callback_port = 5555
mcp_oauth_callback_url = "https://devbox.example.internal/callback"

[mcp_servers.figma]
url = "https://mcp.figma.com/mcp"
bearer_token_env_var = "FIGMA_OAUTH_TOKEN"
http_headers = { "X-Figma-Region" = "us-east-1" }

[mcp_servers.chrome_devtools]
url = "http://localhost:3000/mcp"
enabled_tools = ["open", "screenshot"]
disabled_tools = ["screenshot"] # applied after enabled_tools
default_tools_approval_mode = "prompt"
startup_timeout_sec = 20
tool_timeout_sec = 45
enabled = true

[mcp_servers.chrome_devtools.tools.open]
approval_mode = "approve"

已安装 plugins 可以在 plugin manifest 中打包 MCP servers。这些 servers 从 plugin 启动，因此 user config 不会设置它们的 transport command。User config 仍然可以在 plugins.<plugin>.mcp_servers.<server> 下控制开关状态和 tool policy。

[plugins."sample@test".mcp_servers.sample]
enabled = true
default_tools_approval_mode = "prompt"
enabled_tools = ["read", "search"]

[plugins."sample@test".mcp_servers.sample.tools.search]
approval_mode = "approve"

MCP servers 列表仍在增长。下面是一些常见选择：