向 OpenAI Codex CLI 添加 MCP 服务器

Codex 在 config.toml 中管理服务器，每个服务器对应一个 [mcp_servers.<name>] 表；也可使用 codex mcp add 添加。

macOS

~/.codex/config.toml

Windows

~/.codex/config.toml

Linux

~/.codex/config.toml

项目文件

.codex/config.toml (trusted projects only)

顶层键

mcp_servers

格式

toml

远程服务器的 OAuth

●是

配置示例

此示例按该客户端所需的格式，添加 GitHub 托管的服务器和作为本地服务器的 Playwright。

[mcp_servers.github]
url = "https://api.githubcopilot.com/mcp/"

[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]

codex mcp add github --url https://api.githubcopilot.com/mcp/
codex mcp add playwright -- npx @playwright/mcp@latest

注意事项和特殊情况

• Codex CLI、Codex IDE 扩展和 ChatGPT 桌面应用读取的是同一个 config.toml。
• 只有在受信任的项目中，才会读取项目的 .codex/config.toml。
• env_vars 按名称转发 shell 中的变量；bearer_token_env_var 会将变量中的 token 发送到远程服务器。
• 每个服务器都可以设置 startup_timeout_sec、tool_timeout_sec、enabled_tools 和 disabled_tools。
• 运行 codex mcp login <name> 可进行 OAuth 登录；支持 CIMD 和动态注册。

生成 OpenAI Codex CLI 配置 →

其他客户端