1. 为什么你配了 MCP 却总是连不上MCPModel 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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi-keys 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc 遇到 wire_api 或 base_url 不确定时对照文档确认。2.2 安装 Node.js必须 20.x 以上很多 MCP 服务在 Node 18 或更低版本会直接报错这一步不过关后面全是玄学失败。推荐用 nvm 管理 Node。Mac / Linuxcurl -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 本体跑通别急着上 MCPMCP 是外挂本体不通先别折腾。先确保 Codex 能正常调用模型。3.1 config.toml 放哪路径没有就新建WindowsC:\Users\你的用户名\.codex\config.tomlMac/Linux~/.codex/config.toml3.2 最小可用 config.tomlmodel 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 responsesmodel_reasoning_effort high更适合写代码和分析。wire_api具体看你用的通道说明TaoToken 这边按文档填responses即可。3.3 配置 API KeyCLI 模式可以写进环境变量但 VS Code / Cursor 插件通常不读环境变量必须单独配。文件路径~/.codex/auth.json内容{ OPENAI_API_KEY: sk-xxxxxx }把sk-xxxxxx换成你在 TaoToken 控制台生成的 Key。这一步很多人卡住因为插件和 CLI 读的是不同位置两边都配一遍最省事。4. 用 MCP Router 接管所有工具4.1 安装 mcpr-clinpm install -g mcpr-clilatest4.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-clilatest, 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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding-plan 。模型对话验证在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmodels 控制台在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentconsole 。Claude Code 相关接入参考 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentclaude-code-anthropic 。照这个顺序来成功率最高Node 升到 20Codex 本体跑通MCP Router 接管工具config.toml 只连 RouterAGENTS.md 教 AI 怎么用工具Serena 手动激活一次。每一步都验证过再往下走比一口气全配完再排查要快得多。