MCP 协议集成

15.1 MCP 是什么

MCP(Model Context Protocol) 是一个开放标准,用于把 Codex 连接到外部工具和系统。官方 best practices 说明:

Use MCPs when the context Codex needs lives outside the repo. It lets Codex connect to the tools and systems you already use, so you don’t have to keep copying and pasting live information into prompts.

MCP 的价值不是“把所有工具都接进去”,而是让 Codex 能稳定访问某些真正高频、会变化、和任务强相关的信息。

15.2 何时用 MCP

官方推荐用 MCP 的场景:

• 需要的 context 在仓库外(issue 系统、文档系统、数据库、监控)
• 数据变化频繁(日志、监控指标)
• 希望 Codex 用工具而不是依赖粘贴的指令
• 需要跨用户、跨项目可重复的集成

15.3 支持的传输协议

Codex 支持两种 MCP 服务器传输:

传输	特点
STDIO	本地进程通信,适合本地工具
Streamable HTTP + OAuth	远程服务,带鉴权

15.4 添加 MCP 服务器

CLI 方式

codex mcp add <name> <url> [其他参数]

Codex App 方式

进入 Settings → MCP servers,可看到自定义和推荐的 MCP 服务器。

💡 官方提示:你甚至可以直接让 Codex 帮你安装需要的 MCP 服务器——“Often, Codex can help you install the needed servers. All you need to do is ask.”

15.5 适合接 MCP 的场景

来自官方与社区整理:

• 经常需要查 issue / PR / CI 状态(GitHub MCP)
• 经常需要读内部文档(Notion / Confluence MCP)
• 经常需要查日志或监控
• 多人协作时希望上下文来源一致
• 需要数据库查询
• 需要设计稿接入

15.6 起步原则:不要一上来全接

官方强调:

Add tools only when they unlock a real workflow. Do not start by wiring in every tool you use. Start with one or two tools that clearly remove a manual loop you already do often, then expand from there.

正确做法:

1. 找一个你每天都在手动复制的信息源(比如 GitHub issue)
2. 把它接好
3. 用顺了再扩展

15.7 codex mcp 子命令

# 添加
codex mcp add <name> <url>

# 查看已配置的 MCP 服务器
codex mcp list

# 启动 MCP 服务器(Codex 自己也可以作为 MCP server 提供)
codex mcp-server

15.8 与 Skills 的区别

概念	作用	例子
MCP	接入外部系统/数据源	GitHub、Notion、数据库
Skill	封装稳定工作流	日志排查流程、release notes 生成

简单记:MCP 接外部,Skill 封流程。

资料来源

• OpenAI 官方 Codex best practices——MCP 章节
• CSDN《Codex 使用最佳实践》——MCP 中文解读
• CSDN《Codex 完整指南(四)》——codex mcp / codex mcp-server 子命令
• 官方 MCP 文档