1. 麦当劳 MCP 是什么，为什么值得折腾
麦当劳 MCP 是麦当劳官方开放的 Model Context Protocol 服务，简单说就是把「查券、领券」这些原本要在 App 里点来点去的操作，封装成标准工具接口，让 Claude Code 这类支持 MCP 的客户端直接调用。MCP 全称 Model Context Protocol，由 Anthropic 推出，核心价值是让大模型用统一协议连接外部数据与工具，不用每家服务都写一套私有对接。
它适合谁？适合已经在用 Claude Code 写代码、又想让 AI 顺手处理生活事务的开发者。你不需要懂麦当劳后端，只要拿到官方 Token，把 MCP 地址配进 Claude Code，就能在终端里说一句「帮我查下麦当劳有什么券」，然后让它一键领取。整个过程和你平时调一个 HTTP 接口没本质区别，只是调用方从代码变成了对话。
我试过把这套流程跑通，最大的感受是：MCP 真正的门槛不在协议本身，而在「统一入口」和「稳定通道」。麦当劳 MCP 需要一个 Token，Claude Code 需要一个能稳定访问模型 API 的通道，这两件事分开配很容易乱。所以这篇会把 TaoToken 作为统一 Key/API 通道接进来，用一份 settings.json 骨架把模型通道和 MCP 配置理清楚，再走一遍从查券到领券的完整验证。
下面按「先备通道、再配 MCP、后验证领券」的顺序来，每一步都给可复制的命令和配置，你跟着敲就行。
2. 前置准备：TaoToken 统一 Key 与 API 通道
Claude Code 本身要连模型 API 才能工作，而 MCP 只是它调用的一个外部工具。如果你模型通道和 MCP 各自配一套鉴权，排查问题时很难分清是模型没通还是 MCP 没通。用 TaoToken 做统一通道的好处是：模型请求走一个 Key，MCP 的 Token 单独管，职责清晰。
TaoToken 官网地址是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 入口是 https://taotoken.net/api 。你需要先在控制台创建一个 API Key，这个 Key 用于 Claude Code 访问模型。
创建 Key 的入口在控制台的 API Keys 页面：https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite 。进去后新建一个 Key，复制保存，后面填进 settings.json。
这里有个容易踩的坑：很多人把模型 API Key 和麦当劳 MCP Token 搞混。记住两者完全不同——TaoToken 的 Key 是给 Claude Code 连模型用的，麦当劳的 Token 是给 MCP 服务鉴权用的，一个管「大脑」，一个管「手」。分开存，别写进同一个变量。
如果你还没决定用哪种模型通道，可以先到模型对话页面体验一下：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite ，确认模型可用后再回到 Claude Code 配置。
3. 可复制配置：settings.json 骨架与 MCP 接入
Claude Code 的配置分两块：模型通道写在 settings.json，MCP 服务用命令行添加。先给 settings.json 骨架。
在用户目录下找到或新建 Claude Code 的配置文件，路径通常是~/.claude/settings.json（Windows 是C:\Users\你的用户名\.claude\settings.json）。写入以下内容：
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "你的TaoToken_API_Key" }, "permissions": { "allow": [ "mcp__mcd-mcp__*" ] } }ANTHROPIC_BASE_URL指向 TaoToken 的 API 入口，ANTHROPIC_AUTH_TOKEN填你在控制台创建的 Key。permissions.allow里放行mcd-mcp的所有工具，避免每次调用都弹确认。
接着配置麦当劳 MCP。先去麦当劳开放平台 https://open.mcd.cn/mcp 用点餐手机号登录，进控制台激活 Token，复制保存。然后在终端执行：
claude mcp add mcd-mcp \ --transport http \ https://mcp.mcd.cn/mcp-servers/mcd-mcp \ --header "Authorization: Bearer 你的麦当劳MCP_Token"把你的麦当劳MCP_Token换成实际 Token。执行成功会提示已添加。如果你更习惯用 JSON 管理，也可以直接在 Claude Code 的 MCP 配置里写：
{ "mcpServers": { "mcd-mcp": { "type": "http", "url": "https://mcp.mcd.cn/mcp-servers/mcd-mcp", "headers": { "Authorization": "Bearer 你的麦当劳MCP_Token" } } } }注意type用http，url和baseUrl在部分客户端里需要同时给，Claude Code 命令行方式已经帮你处理了，用命令行最省事。
4. 验证请求：从查券到一键领券
配置完先验证 MCP 是否连上。在终端输入claude进入交互，然后输入/mcp，应该能看到mcd-mcp状态是connected。如果显示failed，先别急着改配置，往下看排障部分。
连接正常后，直接说：
帮我查一下麦当劳现在有什么优惠券Claude Code 会调用mcd-mcp的查询工具，返回当前可领的券列表。你会看到类似「9 张优惠券可领取」的结果。接着发：
帮我把这些券都领了它会逐张调用领取接口。跑完后打开麦当劳 App，在「我的优惠券」里核对，正常情况下券已经到账。
如果你想在代码里验证接口连通性，也可以先用 curl 探一下 MCP 端点是否可达：
curl -X POST https://mcp.mcd.cn/mcp-servers/mcd-mcp \ -H "Authorization: Bearer 你的麦当劳MCP_Token" \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'返回里能看到工具列表，说明 Token 和地址都没问题。这一步能把「MCP 不通」和「Claude Code 配置错」两类问题分开定位。
5. 本篇常见错排查
报错一：/mcp显示 disconnected 或 failed。先确认 Token 有没有带Bearer前缀，很多人只复制了 Token 本身，漏了前缀。再确认地址是https://mcp.mcd.cn/mcp-servers/mcd-mcp，少一段路径都会 404。
报错二：模型请求 401。这是 TaoToken 的 Key 问题，不是 MCP 问题。检查 settings.json 里ANTHROPIC_AUTH_TOKEN是否填对，Key 有没有多余空格。可以到 API Keys 页面重新生成一个：https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite 。
报错三：能查券但领不了。多半是 Token 没激活，或者手机号登录状态过期。回麦当劳开放平台控制台重新激活 Token，再重试。
报错四：调用 MCP 时一直弹权限确认。说明 settings.json 的permissions.allow没生效，检查 JSON 格式有没有写错，mcp__mcd-mcp__*中间是双下划线。
报错五：Claude Code 启动就报配置解析失败。用 JSON 校验工具过一遍 settings.json，常见是多了逗号或少了引号。改完重启 Claude Code。
排查顺序建议：先 curl 验 MCP 端点，再/mcp看连接状态，最后看模型请求日志。这样能快速锁定是通道问题还是工具问题。
6. 长期使用与入口选择
如果你只是偶尔领个券，上面这套配置就够了。但如果你打算把 Claude Code 当日常编码助手长期用，尤其是跑 Agent 任务、批量处理代码，建议走 Coding Plan，额度和稳定性更适合高频调用：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite 。
接入文档在这里，遇到通道配置细节可以对照查：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。Claude Code 相关的接入说明也有单独页面：https://taotoken.net/claude-code?utm_source=taotoken_aicg_blog_end&utm_content=claude_code&utm_campaign=rewrite 。
最后说个实用技巧：把「查券领券」写成一个 Claude Code 的自定义命令或提示词模板，以后一句「领券」就能触发，不用每次打完整句子。MCP 工具名是mcd-mcp，在提示词里明确指定它，能减少模型误调用其他工具的概率。配置一次，午饭长期有着落。
