第五章：Codex的MCP工作流

MCP 是什么

MCP 是 Model Context Protocol。让 Codex 通过协议连接外部工具

一句话：MCP 不是提示词，而是工具连接层。

App 中的 MCP 工作流

提示

App 主线应该这样学：

在 App Settings 或集成入口启用 / 配置 MCP。
回到线程。
用 /mcp 查看当前可见工具。
用自然语言要求 Codex 使用工具。
观察工具调用和权限提示。
Review 结果。

示例：

使用当前可用的文档 MCP，核对 README 里的安装步骤是否和官方文档一致。只读，不修改文件。

从 0 配一个 MCP 前先确认什么

不要一上来复制一段 MCP 配置。先确认四件事：

内嵌表格

问题	为什么重要
这个工具是本地命令还是远程服务？	决定是 stdio、HTTP 还是插件/连接器提供
需要什么账号或 token？	决定密钥放哪里，不能写进仓库
它默认能读写什么？	决定是否只读、是否需要审批
App 里是否已经有连接器或插件？	有现成入口时不要重复手写 MCP

App 里已经能通过 Connector / Plugin 完成的事情，优先用 App 入口。MCP 更适合“需要把一个具体工具暴露给 Codex 调用”的场景。

App 用户常见场景

内嵌表格

场景	MCP 怎么帮忙	注意事项
查官方文档	连接文档搜索工具	优先一手来源
查数据库	只读查询 schema / 样例数据	不要给生产写权限
浏览器验证	打开本地页面，点按钮，截图	需要明确目标 URL
设计稿核对	读取 Figma 等设计上下文	注意账号授权
内部 API	调用公司内部服务	最小权限和审计

CLI 管理 MCP 是辅助路径

当 App 里看不到 MCP，或团队要统一配置时，才用 CLI：

codex mcp --help

codex mcp list

codex mcp add --

也可以在 config.toml 中写 MCP server。具体字段以官方 Config Reference 为准。

CLI 配好后回到 App 仍要验收：

重启或刷新 Codex App。
打开项目线程。
输入 /mcp。
确认 server 名称、工具列表、连接状态。
用一个只读任务试跑。

不要把“CLI 显示配置存在”当成“App 已经能用”。最终以 App 线程里能看到并成功调用为准。

MCP Server 类型

常见类型：

内嵌表格

类型	说明
stdio	本地命令启动，适合本机工具
HTTP / SSE	远程服务，适合团队或云服务
插件携带	Plugin 安装后提供 MCP server

App 用户重点不是背协议，而是知道工具从哪里来、权限是什么、结果能否验证。

MCP、Plugins、Connectors、Skills 的区别

内嵌表格

能力	本质	例子
MCP	工具协议	浏览器、数据库、文档搜索
Plugin	能力包	打包 skills、MCP、apps、配置
Connector / App	外部账号连接	GitHub、Gmail、Drive、Slack
Skill	可复用工作流	审查 SOP、发布检查

不要把 MCP 当万能插件系统。如果只是写固定流程，用 Skill；如果要连接外部工具，用 MCP 或 Connector。

安全边界

配置 MCP 前先问：

它能读什么数据？
它能写什么数据？
它是否会联网？
它是否需要账号授权？
它是否会把数据发给第三方？
它能不能在只读模式下完成任务？

生产数据库、客户数据、内部文档、邮箱、云盘都要按最小权限配置。

验收清单

一个 MCP 配置写完后，必须过这张表：

内嵌表格

验收项	通过标准
App 可见	/mcp 能看到 server 和工具
最小权限	只给当前任务需要的读写范围
密钥安全	token 在环境变量、secret 或系统凭据里，不在仓库
只读试跑	能完成一个只读查询或读取任务
可审计	工具调用结果能回到线程中被 Review
可撤销	知道如何禁用 server、撤销 token 或卸载插件

常见错误

内嵌表格

错误	正确做法
以为 MCP 自动可用	用 /mcp 或 App 设置确认
把 MCP 配置写进教程后不验证	以当前 CLI / App 输出为准
给数据库写权限	默认只读
让 Codex “随便查”	明确目标和范围
把 API Key 写进 config 示例	使用环境变量或 secret

常见问题

Q1：App 里一定能管理所有 MCP 吗？

不一定。部分配置可能需要 CLI 或 config.toml。但 App 仍是使用主线。

Q2：MCP 工具会不会自动运行？

Codex 会根据任务调用工具，但是否需要审批取决于工具、权限和设置。

Q3：MCP 和 Web search 一样吗？

不一样。Web search 是搜索网页；MCP 是连接具体工具或服务。