如何在 OpenAI Codex 中添加 MCP 服务器（config.toml）

使用 codex mcp add 或 ~/.codex/config.toml 为 Codex CLI、IDE 扩展和应用配置 MCP 服务器。

使用 CLI

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

用 --env VAR=VALUE 传入密钥。codex mcp list 会显示已配置的服务器。

或编辑 config.toml

Codex 将 MCP 配置保存在 ~/.codex/config.toml（受信任项目中则为 .codex/config.toml）。每个服务器是一个 [mcp_servers.<name>] 表：

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

[mcp_servers.example]
url = "https://mcp.example.com"

验证

在 Codex 终端界面（或 ChatGPT 桌面应用的输入框）中输入 /mcp 查看已连接的服务器。CLI、IDE 扩展和桌面应用共用同一份配置。对于需要 OAuth 的服务器，运行 codex mcp login <name>。