第四章. Codex MCP 协议与外部工具集成

4.1. MCP 协议原理

MCP（Model Context Protocol）是 Codex 与外部工具通信的标准协议。它的核心思想是：将外部工具的能力抽象为一组标准化的函数，供 AI 调用。

4.1.1. MCP 的架构设计

MCP Client 运行在 Codex 内部，负责管理所有 MCP Server 的连接。

MCP Server 是独立的进程，提供特定领域的能力。每个 Server 暴露一组 Tools（工具函数），如 read_file、query_db。

通信协议 基于 JSON-RPC，支持双向通信。Codex 可以调用 Server 的函数，Server 也可以主动推送事件（如文件变更通知）。

---

4.1.2. MCP 与传统 API 的区别

传统 API 是 “被动响应” 的：你发送请求，API 返回结果。

MCP 是 “主动协作” 的：

1. Codex 可以 发现 Server 提供的所有工具
2. Codex 可以 组合 多个工具完成复杂任务
3. Server 可以 推送 上下文变化（如数据库 Schema 更新）

这种设计让 Codex 能够像人类开发者一样，灵活使用各种工具。

---

4.2. MCP 服务器配置清单

为了方便统一管理，我们整理了一份包含 20+ 个常用 MCP 服务器的配置清单（Filesystem, GitHub, Docker, MySQL, Redis, Notion 等）。

👉 点击查看：20+ 实用 MCP 服务器配置大全

在该页面中，你可以利用标签页（Tabs）功能，直接复制适用于 Codex 的 config.toml 配置代码。

常用模块概览

我们把 MCP 服务器按功能划分为了几个模块，你可以在工具集中按需选择：

• 模块一：系统与文件控制 (基础必选)
  • Filesystem (文件系统读写)
  • Everything Search (Windows 秒搜)
• 模块二：Git 与 容器管理 (开发者标配)
  • GitHub / Git
  • Docker
• 模块三：后端与数据库
  • PostgreSQL / MySQL / Redis / Supabase
• 模块四：浏览器自动化
  • Chrome DevTools / Playwright
• 模块五：AI 增强与生产力
  • Sequential Thinking (深度思考)
  • Excel / Magic / Notion / Slack

---

4.3. 验证安装

修改完 config.toml 并保存后，重启 Codex，然后输入以下命令检查哪些工具加载成功：

codex mcp list

如果某个工具显示 Error，通常是因为：

1. Token 没填：检查 env 部分。
2. 依赖没装：比如 Python 的 uv 或 Node.js。
3. 路径错误：Windows 路径必须用双反斜杠 \\。

剩下的章节由于Codex skills与Claude Code一模一样，我们就不讲解Skills系统了

---