Codex 使用技巧：接入 MCP 服务器，让编程助手用上外部工具

想让 Codex 查最新的开发文档、读工单系统里的记录，光靠它自己是做不到的，需要接上 MCP 服务器。本文按 OpenAI 官方文档，讲清 Codex 怎么添加 MCP 服务器、配置文件怎么写，以及几个能让工具更好用、更安全的设置技巧。

MCP 是什么

MCP（Model Context Protocol，模型上下文协议）让 ChatGPT 和 Codex 能使用其他系统里的工具和信息。MCP 服务器负责告诉 Codex 有哪些工具可用，并处理具体请求，例如查一张工单、取一段文档。

Codex 支持两类服务器：

• STDIO 服务器：在本机作为一个进程运行，用一条命令启动，可以传环境变量；
• 可流式 HTTP 服务器：通过网址访问，支持 Bearer 令牌和 OAuth 登录。

一个省事的地方：ChatGPT 桌面 App、Codex 命令行和编辑器扩展共用同一份 MCP 配置，在一处配好，换个客户端不用重新设置。

方法一：用命令添加（最快）

命令格式如下，-- 后面是启动服务器的命令：

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

官方举的例子是添加 Context7（一个免费的开发文档 MCP 服务器）：

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

常用的几条配套命令：

• codex mcp list：列出已经配置的服务器；
• codex mcp --help：查看全部 MCP 命令；
• codex mcp login <server-name>：给支持 OAuth 的服务器登录；
• 在 codex 交互界面里输入 /mcp：查看当前生效的服务器。

方法二：直接改配置文件

MCP 配置写在 config.toml 里，默认位置是 ~/.codex/config.toml。也可以在项目里放一份 .codex/config.toml，只对这个项目生效（仅限受信任的项目）。

每个服务器写成一个 [mcp_servers.<名字>] 段落。本机运行的 STDIO 服务器，command 必填，args、env、env_vars、cwd 可选：

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

通过网址访问的服务器，url 必填；需要令牌时，用 bearer_token_env_var 写环境变量的名字，Codex 会从这个环境变量读取令牌，配置文件里不用写明文：

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

实用技巧

1. 只开放需要的工具

一个服务器往往提供很多工具。用 enabled_tools 写允许清单，用 disabled_tools 写禁用清单（禁用清单在允许清单之后生效），让 Codex 只看到你需要的那几个。

2. 给写操作加一道确认

default_tools_approval_mode 控制这个服务器的工具调用要不要先问你，可选 auto、prompt、writes、approve。其中 writes 会在调用没有标记为只读的工具时先询问，查询类工具照常直接用。单个工具还可以用 tools.<工具名>.approval_mode 单独设置。

3. 暂停而不删除

临时不想用某个服务器，加一行 enabled = false 即可，配置保留，以后改回来就能用。反过来，某个服务器必不可少时，设 required = true，这个服务器初始化失败时 Codex 的启动也会失败，问题能第一时间暴露出来。

4. 调整超时时间

启动慢的服务器，调大 startup_timeout_sec（默认 10 秒）；单次工具运行时间长的，调大 tool_timeout_sec（默认 60 秒）。

5. 控制工具输出长度

某个工具返回的内容特别长时，用 tools.<工具名>.output_token_limit 给它设一个输出上限，避免一次结果占掉太多上下文。

6. 保管好密钥

用 OAuth 预注册客户端时，如果加了 --oauth-client-secret，Codex 会把密钥存进 config.toml。官方提醒：这个文件要自己保管好，不要提交到版本库。

上手建议

1. 先用 codex mcp add 加一个文档类服务器（例如上面的 Context7），在 /mcp 里确认它已生效；
2. 让 Codex 用它查一次你正在用的库的文档，感受一下效果；
3. 再按需要改 config.toml：收紧工具清单、给写操作加确认。

Codex 用 ChatGPT 账号登录使用。还没有会员的，可以在 BuyBuy代充（buybuytopup.cn） 开通 ChatGPT Plus；任务量大、经常长时间跑 Codex 的，可以看看 Pro 套餐。