MCP 可以理解为一种让 Codex 连接外部工具和资料的方式。比如文档系统、浏览器、数据库、设计工具、监控系统、代码托管平台等。

新手需要马上学 MCP 吗

不需要。第一周建议先把 Codex 当成本地编程助手用好:

  • 解释项目
  • 修改小功能
  • 跑测试
  • 审查 diff
  • 写文档

当你发现 Codex 经常因为“看不到某个外部系统”而卡住,再考虑 MCP。

什么情况适合接 MCP

适合的情况包括:

  • 经常要查内部文档
  • 经常要打开网页验证页面
  • 需要读 GitHub、Issue、PR 或项目管理系统
  • 需要访问数据库 schema
  • 需要和设计稿、监控、日志系统配合

核心判断是:这个外部上下文是否反复出现,且人工复制粘贴成本很高。

不适合接 MCP 的情况

如果只是一次性查一段公开文档,不一定需要 MCP。

如果外部系统包含敏感数据,先确认权限和最小访问范围。

如果你还没有稳定的 Codex 基础工作流,先不要把工具链搞复杂。

接入前的安全问题

你应该问清楚:

  • Codex 能访问哪些数据
  • 是否只读
  • 是否会写入外部系统
  • 授权 token 存在哪里
  • 是否能随时撤销

不要为了省事给过大的权限。

可以这样要求 Codex

这个任务需要查内部文档。
请先说明是否真的需要 MCP。
如果需要,请说明:
- 需要连接哪个系统;
- 需要什么权限;
- 只读是否足够;
- 不连接时有什么替代方案。

常见坑

不要把 MCP 当万能插件。工具越多,上下文越复杂,错误来源也越多。

不要让 Codex 同时连接太多系统。每次只接当前任务必要的工具。

不要把密钥写进仓库。授权信息应该放在安全配置里,而不是文档或代码里。

官方来源

  • https://developers.openai.com/codex/concepts/customization
  • https://developers.openai.com/codex/quickstart