Codex MCP 与工具扩展
1. 在 Codex 里，MCP 是什么
MCP 可以把 Codex 从“只会读本地仓库”的代理，扩展成“能连设计、数据库、浏览器、内部系统”的代理。
最简单的理解：
Skills是做事方法MCP是外部工具能力
2. Codex 里常见的配置位置
| 级别 | 典型位置 | 作用范围 |
|---|---|---|
| 用户级 | ~/.codex/config.toml | 当前机器上的所有项目 |
| 项目级 | .codex/config.toml | 当前仓库，适合团队共享 |
3. 最常见的两种配置方式
方式一：命令行添加
bash
codex mcp add github --env GITHUB_TOKEN=your-token -- npx -y @modelcontextprotocol/server-github方式二：手动维护 TOML
toml
[mcp_servers.github]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
[mcp_servers.github.env]
GITHUB_TOKEN = "your-token"
实操上，MCP 配置通常还是会配合编辑器或终端界面一起调试，因此这类截图对教学很有帮助。
4. 推荐先接哪类 MCP
如果你是给学员或团队讲，推荐按这个顺序：
- 文件系统 / GitHub
- 数据库
- 浏览器自动化
- 设计工具
- 内部 API / 内网系统
因为学习成本是逐步上升的。
5. 最容易踩的坑
- 全局配置和项目配置混在一起
- token 直接写死在仓库里
- 一上来就接太多服务器，排错成本很高
- 学员还没搞懂主流程，就先学太多工具
6. 和其他页面怎么配
- Subagents、AGENTS.md、Skills 与 MCP 讲的是整体协作关系
- 本页更偏“怎么配置、怎么落地”