Codex MCP 集成：接入外部工具生态
2026-08-22 14:28:56阅读 3
Codex 自带的能力再强，也够不着你的私有系统——GitHub 仓库、内部 API、数据库、Figma 设计稿……MCP（Model Context Protocol，模型上下文协议）就是连接这些的通用插座：让 Codex 通过一个标准协议，调用外部工具和上下文。
MCP 是什么，为什么需要它
MCP 是一个开放协议，把 "模型" 和 "工具/上下文" 解耦。对 Codex 用户的意义：
- 生态复用：大量现成 MCP 服务器，接入即用
- 一次配置，多处共享：桌面 App、CLI、IDE 扩展共享同一份 MCP 配置（官方原文）——配一次，三个入口都能用
- 私有集成：公司内部系统包一层 MCP 服务器，Codex 就能调
官方支持的 MCP 服务器类型
官方文档原文确认两种：
| 类型 | 是什么 | 认证方式 |
|---|---|---|
| STDIO 服务器 | 作为本地进程运行（命令启动） | 环境变量 |
| 可流式传输的 HTTP 服务器 | 通过地址访问的远程服务器 | Bearer token / OAuth（含 CIMD/DCR） |
简单说：本地工具用 STDIO，远程服务用 HTTP。
能干什么：三个真实场景
场景一：访问第三方文档
配置一个 MCP 服务器，让 Codex 查询最新 API 文档再写代码。场景二：与开发者工具交互
接上浏览器或 Figma 的 MCP，让 Codex 读取设计稿约束并生成对应前端代码。（浏览器/Figma 都是官方点名的典型 MCP 用例）
场景三：操作 GitHub 等外部系统
通过 MCP 服务器，让 Codex 直接创建 issue、提 PR。配置要点（少踩坑）
- 服务器指令：官方提到 Codex 会读取 MCP 服务器初始化时返回的
instructions字段，作为服务器级指南——给服务器写清楚 "什么时候用、怎么用"，Codex 用得更准 - 凭据安全：token、密钥走环境变量或 OAuth，别写进配置明文
- 共享配置：因为桌面 App/CLI/IDE 共享配置，改一次生效三处，改前想清楚影响面
和 Skills、插件的关系
- MCP：接入外部工具
- Skills：封装流程（详见Skills 技能篇）
- 插件（Plugin）：可安装的组合包，可以包含连接器（MCP server）（官方原文）
想要 "现成工作流直接装"？找插件；想要 "自己接某个系统"？配 MCP。
常见问题
| 问题 | 解答 |
|---|---|
| 配置了但 Codex 不调用？ | 检查服务器是否启动成功、工具描述是否清晰 |
| STDIO 和 HTTP 选哪个？ | 本地工具用 STDIO，远程服务用 HTTP |
| 认证怎么做？ | HTTP 支持 Bearer token 和 OAuth（官方原文） |
| 配置在哪？ | 与 Codex 主目录配置相关，见config 篇 |
一句话总结
MCP 是 Codex 的 "万能接口"，把它接到你的系统上，Codex 就从 "开发助手" 升级成 "全栈执行器"。
接下来读什么
- MCP 配置写在哪 → config.toml 配置详解
- 权限边界 → 权限与安全篇
← 上一篇：4.2 Skills 技能教程 | 下一篇：4.4 config.toml 配置详解 →
↑ 返回 教程总目录
