1. 为什么你配了 MCP 却总是连不上
MCP（Model Context Protocol）是一套让大模型标准化调用外部工具的协议，你可以把它理解成 AI 世界里的 USB 接口标准。以前每接一个工具都要单独写适配代码，现在工具按协议暴露能力，模型按协议调用，插上就能用。它适合已经在用 Codex、Cursor 或 AI IDE，听过 MCP 但一配置就报错，想让 AI 真正会用工具干活的人。
我见过太多人卡在同一个地方：MCP 服务装了一堆，npx 和 Node 版本各种玄学，Windows 环境一堆坑，工具是有了但 AI 不知道什么时候该用。这篇教程按真实上手顺序走一遍，从原理到环境到 Router 接通，最后交付一份可复制的 config.toml 骨架和 AGENTS.md 配置片段，帮你在 TaoToken 统一 Key 通道下完成从零到可运行的最小闭环。
整体结构先看一眼，建议截图保存：
Codex / IDE ↓ MCP Router（可选但强烈推荐） ↓ 各种 MCP 服务 ├─ 搜索 ├─ 文档 ├─ 任务规划 └─ 代码语义分析Codex 本体负责和模型对话，Router 负责统一管理所有 MCP 服务，Codex 只连 Router 一个入口。这样做的原因是：如果你直接在 config.toml 里写一堆[mcp_servers.xxx]，大概率会遇到启动慢、超时、Windows 找不到 npx、一个服务挂了拖死全局。新手加 Windows 加多工具，用 Router 是最稳的路。
2. 前置准备：TaoToken 通道与本地环境
2.1 拿到统一 Key 和 API 地址
TaoToken 提供统一的 Key 和 API 通道，Codex 的模型请求走这里，MCP 服务本身不需要额外配置模型。你需要准备两样东西：一个 API Key，以及 API 地址https://taotoken.net/api。Key 在控制台的 API Keys 页面生成，建议单独建一个给 Codex 用，方便后续排查和轮换。
模型对话入口可以用来验证 Key 是否可用，地址是 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=api-keys 。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=doc ，遇到 wire_api 或 base_url 不确定时对照文档确认。
2.2 安装 Node.js（必须 20.x 以上）
很多 MCP 服务在 Node 18 或更低版本会直接报错，这一步不过关后面全是玄学失败。推荐用 nvm 管理 Node。
Mac / Linux：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.zshrc # 或 ~/.bashrc nvm install 20 nvm use 20Windows 搜索 nvm-windows 安装后执行：
nvm install 20 nvm use 20检查是否成功，三个命令都能正常输出版本才算过关：
node -v npm -v npx -v2.3 安装 uv / uvx（给 Python 写的 MCP 用）
有些 MCP 服务是 Python 写的，不装会报错：
pip install uv pip install uvx3. 先把 Codex 本体跑通，别急着上 MCP
MCP 是外挂，本体不通先别折腾。先确保 Codex 能正常调用模型。
3.1 config.toml 放哪
路径没有就新建：
Windows：C:\Users\你的用户名\.codex\config.toml
Mac/Linux：~/.codex/config.toml
3.2 最小可用 config.toml
model = "gpt-5-codex" model_provider = "taotoken" model_reasoning_effort = "high" network_access = "enabled" [model_providers.taotoken] name = "taotoken" base_url = "https://taotoken.net/api" wire_api = "responses"model_reasoning_effort = "high"更适合写代码和分析。wire_api具体看你用的通道说明，TaoToken 这边按文档填responses即可。
3.3 配置 API Key
CLI 模式可以写进环境变量，但 VS Code / Cursor 插件通常不读环境变量，必须单独配。文件路径~/.codex/auth.json，内容：
{ "OPENAI_API_KEY": "sk-xxxxxx" }把sk-xxxxxx换成你在 TaoToken 控制台生成的 Key。这一步很多人卡住，因为插件和 CLI 读的是不同位置，两边都配一遍最省事。
4. 用 MCP Router 接管所有工具
4.1 安装 mcpr-cli
npm install -g mcpr-cli@latest4.2 在 Router 里添加 MCP 服务
推荐新手必装这几个：
| 服务 | 用途 |
|---|---|
| sequential-thinking | 任务规划 |
| context7 | 官方文档 |
| duckduckgo-mcp-server | 搜索 |
| serena | 代码语义分析 |
Serena 有个重要提醒：Arguments 一定要加--context codex，否则 Codex 侧识别不到。
4.3 生成 MCPR_TOKEN
在 Router 中添加一个 App，比如叫 codex，复制生成的 MCPR_TOKEN。
4.4 Codex 连接 Router
在 config.toml 中只保留这一段 MCP 配置，其他[mcp_servers.xxx]全部删掉：
[mcp_servers.mcp-router] command = "npx" args = ["-y", "mcpr-cli@latest", "connect"] env = { MCPR_TOKEN = "你的token" }4.5 Windows 用户终极避坑
如果上面方式连不上，用绝对路径。先用where node找到 node.exe 路径：
[mcp_servers.mcp-router] command = "C:\\路径\\node.exe" args = ["C:\\路径\\mcpr.js", "connect"] env = { SystemRoot = "C:\\WINDOWS", COMSPEC = "C:\\WINDOWS\\system32\\cmd.exe", MCPR_TOKEN = "你的token" }把路径换成你机器上的实际路径。这个写法能绕开 Windows 下 npx 找不到、cmd 环境变量缺失的问题。
5. 验证请求与成功结果
5.1 验证 Codex 本体
在项目目录下启动 Codex，输入一句简单的话，比如「用一句话解释什么是闭包」。如果模型正常返回，说明 Key 和 base_url 通了。如果报 401，检查 auth.json 里的 Key；如果报连接错误，检查 base_url 是否带了多余路径。
5.2 验证 Router 接通
启动 Codex 后，看它是否能列出 MCP 工具。正常情况下你会看到 mcp-router 下的工具列表。如果列表为空，说明 Router 没连上，回到 4.5 用绝对路径重试。
5.3 让 AI 真正会用工具：AGENTS.md
很多人做到这一步会说「工具是有了，但 AI 怎么还是不太聪明」。原因只有一个：你没教它什么时候该用工具。在项目根目录创建 AGENTS.md：
# AGENTS.md 你是我的技术搭档，请按以下规则工作： - 先理解需求，再动手 - 优先最小改动 - 一轮最多调用一个 MCP 工具 工具使用规则： - 规划 → sequential-thinking - 查官方文档 → context7 - 查最新信息 → duckduckgo - 查/改代码 → serena 使用 MCP 后，必须在结尾输出【工具调用简报】5.4 Serena 激活
进入项目目录后，在 Codex 对话框输入：
使用 serena 将当前目录激活为项目看到它开始索引代码，说明成功。这一步很多人失败，是因为没加--context codex参数，或者没在项目根目录执行。
6. 本篇常见错排查
npx 找不到或版本不对：先跑node -v确认是 20.x，再跑npx -v。如果 npx 报错，重装 Node 或用 nvm 切版本。
Windows 下 Router 连不上：用 4.5 的绝对路径写法，where node找到真实路径，注意反斜杠要双写。
Codex 插件读不到 Key：插件不读环境变量，必须配~/.codex/auth.json。
工具列表为空：检查 config.toml 里是否只保留了 mcp-router 一段，其他 mcp_servers 是否删干净。
AI 不调用工具：检查 AGENTS.md 是否放在项目根目录，规则是否写清楚。
Serena 索引失败：确认 Arguments 加了--context codex，且在项目根目录执行激活命令。
长期做编码和 Agent 任务的话，Coding Plan 比按量调用更划算，地址是 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=coding-plan 。模型对话验证在 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=models ，控制台在 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=console 。Claude Code 相关接入参考 https://taotoken.net/claude-code-anthropic?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=claude-code-anthropic 。
照这个顺序来成功率最高：Node 升到 20+，Codex 本体跑通，MCP Router 接管工具，config.toml 只连 Router，AGENTS.md 教 AI 怎么用工具，Serena 手动激活一次。每一步都验证过再往下走，比一口气全配完再排查要快得多。
