麦当劳 MCP 点餐技能 (mcd-mcp)#

通过麦当劳中国 MCP 接口，实现麦乐送/到店取餐/团餐点餐、优惠券查询、积分兑换等功能。

---

1. 前置条件：获取 MCP Token#

必须先让用户提供 MCP Token。 用户需自行前往 https://open.mcd.cn/mcp 申请：

1. 点右上角「登录」，用手机号验证登录
2. 登录后右上角变成「控制台」，点击进入
3. 点击「激活」按钮，同意服务协议
4. 复制生成的 MCP Token

⚠️ MCP Token 代表麦当劳会员身份，严禁分享给他人。

---

2. 配置 MCP Server 到 OpenClaw#

获取到 Token 后，使用以下命令配置：

bash

openclaw mcp set mcd-mcp \
  --transport streamable-http \
  --url https://mcp.mcd.cn \
  --header "Authorization" "Bearer YOUR_MCP_TOKEN"

注意： YOUR_MCP_TOKEN 需要替换为用户提供的实际 Token。

如果 openclaw mcp set 命令不可用，也可以直接编辑 ~/.openclaw/openclaw.json，在根对象添加 mcp.servers 配置：

json

{
  "mcp": {
    "servers": {
      "mcd-mcp": {
        "url": "https://mcp.mcd.cn",
        "transport": "streamable-http",
        "headers": {
          "Authorization": "Bearer YOUR_MCP_TOKEN"
        }
      }
    }
  }
}

配置完成后，可以通过 MCP 协议调用 McDonald's 的所有工具。

---

3. MCP 工具清单#

工具名中文名用途list-nutrition-foods餐品营养信息列表查热量、营养成分delivery-query-addresses获取配送地址列表查已有外送地址delivery-create-address新增配送地址创建新外送地址query-nearby-stores查询附近门店搜附近麦当劳query-store-coupons查询门店可用券查当前门店可用优惠券query-meals查询门店可售餐品查看菜单query-meal-detail查询餐品详情查看套餐内容calculate-price价格计算计算总价create-order创建订单下单query-order查询订单查订单状态campaign-calendar活动日历查当月活动available-coupons麦麦省券列表查可领取的券auto-bind-coupons一键领券自动领取所有可用券query-my-coupons我的优惠券查我已领取的券query-my-account积分查询查积分余额mall-points-products积分兑换商品查可兑换商品mall-product-detail积分商品详情查具体商品信息mall-create-order积分兑换下单用积分兑换商品

---

4. 点餐流程（完整工作流）#

4.1 麦乐送（外送）点餐#

text

1. 问用户想吃什么、送到哪里
2. 调用 delivery-query-addresses(beType=2) 获取已存地址列表
   → 如果没有地址，调用 delivery-create-address 新建
   → 从返回值获取 addressId、storeCode、beCode
3. 调用 query-meals(storeCode, beCode, orderType=2) 查看门店菜单
   → 向用户展示餐品，让其选择
4. 调用 query-store-coupons(storeCode, beCode, orderType=2) 查看可用券
   → 问用户是否要用券
5. 调用 calculate-price() 计算价格，让用户确认
   ⚠️ 参数字段为 items（数组），不是 productList/products！
6. 用户确认后，调用 create-order() 创建订单
7. 返回支付链接给用户完成支付

4.2 到店取餐#

text

1. 问用户想去哪家店
2. 调用 query-nearby-stores(searchType=2, beType=1, city=..., keyword=...) 找附近门店
   → 获取 storeCode
3. 调用 query-meals(storeCode, beCode=null, orderType=1) 查看菜单
4. 调用 query-store-coupons(storeCode, beCode=null, orderType=1) 查看可用券
5. 计算价格并确认
6. 创建订单并获取取餐码

4.3 积分兑换#

text

1. 调用 query-my-account 查用户积分
2. 调用 mall-points-products 查可兑换商品
3. 调用 mall-product-detail 查看具体商品详情
4. 用户确认后调用 mall-create-order 兑换

4.4 团餐#

text

与麦乐送相同，但 beType=6

---

5. ⚠️ 踩坑记录与解决方案#

5.1 calculate-price 和 create-order 参数格式（2026-04-01）#

问题：调用时一直报 "缺少参数" 或 "参数缺失"。

原因： items 参数必须是 JSON 对象数组（不能是字符串），且需与 storeCode、 beCode、 addressId 一起作为顶层参数传入。

正确格式（传 JSON）：

javascript

// 调用 MCP 工具时，args 必须是完整 JSON 对象
{
  "storeCode": "1450555",
  "beCode": "145055502",
  "addressId": "1036946320159843531343293876",
  "items": [
    { "productCode": "9900013722", "quantity": 1 }
  ]
}

踩坑的错误写法（均会报错）：

javascript

// ❌ items 被当成字符串
{ "addressId": "xxx", "items": "..." }

// ❌ 用了 productList 而非 items
{ "addressId": "xxx", "productList": [...] }

// ❌ 用了 products 而非 items
{ "addressId": "xxx", "products": [...] }

// ❌ 缺少 storeCode/beCode
{ "addressId": "xxx", "items": [...] }

// ❌ items 是字符串数组而非对象数组
{ "addressId": "xxx", "items": ["9900013722"] }

5.2 query-meal-detail 对某些商品码返回错误（2026-04-01）#

问题：查询 521533（泷情蜜意麦旋风单个）时返回 "未匹配到商品"。

原因：部分促销/限时商品（尤其是买一送一类套餐码如 9900013722）可能不在标准餐品详情库中。

规避：优先使用 query-meals 获取商品名和价格，不依赖 query-meal-detail。买一送一商品直接用套餐码下单即可。

5.3 支付链接变为扫码支付（2026-04-01）#

问题： create-order 返回的 payH5Url 从网页收银台变成了 https://m.mcd.cn/mcp/scanToPay?orderId=xxx 扫码支付页。

原因：麦当劳 MCP 端更新了支付流程，不再提供 H5 网页收银台。

应对方案：

• 手机上直接打开链接 → 可能自动调起微信/支付宝支付
• 在麦当劳 App「我的订单」中找到待支付订单，直接支付
• 暂无办法恢复网页收银台，接受现状

5.4 items vs productCode 直传（2026-04-01）#

发现： create-order 的 schema 声明 items?: string[]，但实际需要传 JSON 对象数组 [{"productCode":"xxx","quantity":1}]。直接传 productCode=xxx&quantity=1 会报参数缺失。 必须传完整 JSON 对象数组。

5.5 MCP 版本兼容性（2026-04-01）#

• MCP Server 当前仅支持 MCP Version 2025-06-18 及之前的版本
• 每个 Token 每分钟最多允许 600 次请求，超过限制会返回 429 错误码
• 确保 MCP Client 支持 Streamable HTTP 协议

---

6. 注意事项#

• MCP Token 代表麦当劳会员身份， 严禁分享
• 服务面向 中国大陆地区（不含港澳台）
• 下单时需先 calculate-price 计算价格并让用户确认
• 多个商品兑换需分别下单，等前一个订单完成后再下新的
• 门店信息（storeCode/beCode）必须从 delivery-query-addresses 或 query-nearby-stores 返回值获取，不可凭空生成
• 参考文档： https://open.mcd.cn/mcp/doc
• MCP 地址： https://mcp.mcd.cn

---

7. 错误码速查#

code原因处理401Token 无效/过期/未提供检查 Token 配置429超过 600 次/分钟限流降低请求频率