第 4 章：认识 MCP

4.1 MCP 是什么

MCP 全称是 Model Context Protocol，可以理解成让 Codex 连接外部工具和外部数据的一套协议。

如果把 Codex 看成一个会思考和执行任务的助手，那么 MCP 就像“外部系统插座”。通过 MCP，Codex 可以访问本地之外的工具、服务和资料。

可以这样理解：

1
2
3
4
Codex = 使用工具的人
Skill = 做事流程说明书
MCP = 连接外部工具和数据的接口
外部系统 = Notion、Gmail、GitHub、浏览器、Figma、Sentry 等

4.2 MCP 能提供什么能力

MCP 服务器通常可以提供三类能力：

  • Tools：可执行动作，例如创建 Notion 页面、搜索邮件、读取 GitHub PR。
  • Resources：可读取资料，例如文档、页面内容、数据库结构。
  • Prompts：可复用提示模板。

这三类能力的权限不同，风险也不同。读取资料通常风险较低，执行动作则可能涉及修改外部系统，所以需要更明确的边界和授权。

4.3 什么时候需要 MCP

当任务需要访问 Codex 本地环境之外的系统时，就可能需要 MCP。

常见例子：

  • 读写 Notion。
  • 搜索或整理 Gmail 邮件。
  • 查看 GitHub Issue、PR、CI 状态。
  • 控制浏览器或读取网页调试信息。
  • 访问 Figma 设计稿。
  • 查询 Sentry 日志。
  • 搜索最新官方开发文档。

如果任务只需要本地文件、命令行和脚本，通常不需要 MCP。

例如 publish-article-to-website Skill 主要是复制本地 Markdown 到 OneDrive 发布目录，不需要 MCP。
但“把对话归档到 Notion”需要真正写入 Notion，就需要 Notion 连接器或 MCP 工具。

4.4 MCP、Skill、Plugin 和 AGENTS 的区别

这几个概念可以这样分工：

1
2
3
4
AGENTS.md = 长期规则
Skill = 可复用流程
MCP = 外部工具接口
Plugin = 打包 Skill、MCP、App 连接能力的安装包

举例：

  • AGENTS.md 写“总结时归档到 Notion，不保存敏感凭据”。
  • Skill 写“归档时按背景、需求变化、结论、待办的结构整理”。
  • MCP 提供“真的创建或更新 Notion 页面”的能力。
  • Plugin 可能把 Notion Skill、Notion 工具、连接配置一起打包。

所以，Skill 和 MCP 常常配合使用：

1
2
Skill 负责怎么做
MCP 负责连到哪里做

4.5 MCP 在哪里配置

MCP 配置通常写在 Codex 的配置文件里：

1
C:\Users\Lenovo\.codex\config.toml

也可以在受信任项目中使用项目级配置：

1
项目目录\.codex\config.toml

常见 MCP 形式：

  • STDIO：本地启动一个进程作为 MCP 服务器。
  • Streamable HTTP：连接到一个远程 MCP 服务地址。
  • 插件自带：安装插件后，插件清单里可以包含 MCP 服务器配置。

当前已经接触到的例子：

  • Notion 工具：用于搜索、读取、创建、更新 Notion 页面。
  • OpenAI Docs MCP：用于搜索和读取 OpenAI 官方开发文档。
  • Node REPL MCP：用于在 Node 运行时中执行 JavaScript 或控制相关能力。

4.6 学习 MCP 的重点

初学 MCP 时，不需要马上会写 MCP 服务器。

先理解三件事：

  1. MCP 是 Codex 连接外部系统的接口。
  2. MCP 工具可能会读取或修改外部数据，所以要关注权限和安全。
  3. Skill 和 MCP 可以配合：Skill 规定流程，MCP 提供外部动作能力。

后续可以继续学习：

  • 如何查看当前有哪些 MCP 工具。
  • 如何判断某个任务是否需要 MCP。
  • 如何在 config.toml 中配置 MCP。
  • 插件自带 MCP 和手动配置 MCP 有什么区别。