# Mcdonald

> 麦当劳中国 MCP（mcd-mcp，https://mcp.mcd.cn）全能力操作手册：查活动日历、麦麦省领券、我的券/积分、餐品营养热量、附近门店、麦乐送/到店自取/得来速/企业团餐点餐全链路（选址→选店→菜单→算价→下单→查订单）、麦麦商城积分兑换餐品券与实物商品及其订单查询。当用户提到麦当劳、麦当劳点餐、麦乐送、麦当劳外送、金拱门、买麦当劳、点个麦当劳、麦当劳优惠券、麦麦省、领券、麦当劳积分、积分兑换、麦麦商城、麦当劳活动日历、麦当劳菜单、麦当劳热量/营养、得来速、Drive Through、麦当劳团餐、我的麦当劳订单、mcd、mcdonald、McDonald's、mcd-mcp 时使用。也负责该 MCP 的接入配置与 401/429 排障。不负责其他外卖平台（美团/饿了么）或非中国大陆麦当劳。

- Skill: `nxxxsooo/mcdonald` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add nxxxsooo/mcdonald`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nxxxsooo/mcdonald/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: nxxxsooo (https://skillmd.com/u/nxxxsooo)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nxxxsooo/mcdonald

---


# 麦当劳中国 MCP

这是连接中国大陆麦当劳官方 MCP 服务的非官方个人集成，仅限非商业用途。它可读取门店、菜单、券、积分、营养与订单，也能真实创建订单、兑换积分、领券和写入地址。优先使用已加载的 `mcd-mcp` 工具；若 MCP 被禁用、未加载或共享后端未继承环境变量，直接使用本技能的 CLI 回退。先判断操作是否会产生外部状态变化。

## 使用本地命令

可选的全局 `mcd` 命令可从任意目录执行。命令只从环境变量 `MCD_MCP_TOKEN` 读取 Bearer token，不显示或保存它。若未创建全局软链接或 PATH 不可用，请在含有本 `SKILL.md` 的 Skill 目录使用规范相对回退路径 `./scripts/mcd`，或使用该文件的完整路径。

```bash
mcd doctor
mcd tools
mcd schema query-meals
mcd call now-time-info --json
```

`tools` 默认读随 Skill 保存的实时快照；`--live` 查线上；`--check` 比较快照与线上；`--sync` 只会在线上仍是同一批准的 24 个工具名时原子更新快照。工具新增、删除或改名会拒绝同步，需先审查并更新本地批准集。`schema TOOL [--live]` 输出完整工具契约。`call TOOL [JSON_ARGS]` 默认展示服务原始 Markdown 信封，`--json` 提取其中的结构化业务 JSON。

## 安全边界

1. `create-order`、`mall-create-order`、`auto-bind-coupons`、`delivery-create-address` 都是写操作。仅在用户明确确认后才可追加 `--confirm-write`，否则命令必须在联网前拒绝。
2. 创建点餐订单前，先执行 `calculate-price`；向用户逐项复述门店、餐品、数量、所用券和应付金额，获得一次明确确认后才可运行 `create-order --confirm-write`。
3. 不臆造 `storeCode`、`beCode`、`productCode`、`couponId`、`takeWayCode` 或 `gmServiceCode`；它们必须来自上一步返回。
4. 地址、手机号、券码和支付链接只在当前会话使用，不写入文件、Vault 或日志。
5. HTTP 200 不代表业务成功。响应内 `success:false` 仍是失败，命令会返回非零状态。

## 关键约定

| 场景 | beType | orderType | beCode | 还需传入 |
|---|---:|---:|---|---|
| 到店自取 | 1 | 1 | 不传 | `takeWayCode` |
| 麦乐送 | 2 | 2 | 必传 | `addressId` |
| 得来速 | 5 | 1 | 必传 | `takeWayCode` |
| 企业团餐 | 6 | 2 | 必传 | `addressId`、`gmServiceCode` |

预约才传 `reservationDate`（`yyyy-MM-dd HH:mm`），且后续菜单、餐品详情、可用券、算价、下单必须使用同一个值。`calculate-price` 的金额为分，向用户展示时除以 100；订单查询和创建订单的金额为元字符串。套餐或单品特制的 `selectedKey` / `unselectedKey` 规则见 [tools.md](references/tools.md)。

## 最短业务流程

- 到店自取：`query-nearby-stores` → `query-meals` → `calculate-price` → 确认 → `create-order` → 交付 `payH5Url`。
- 麦乐送：`delivery-query-addresses` → `delivery-query-stores` → `query-meals` → `calculate-price` → 确认 → `create-order` → 交付 `payH5Url`。
- 得来速：按到店自取流程，但从门店返回开始持续携带 `beCode`。
- 企业团餐：按麦乐送流程，算价前加 `query-meal-assistance`，将选择的 `gmServiceCode` 传给算价和下单。
- 积分兑换：`query-my-account` → `mall-points-products` → `mall-product-detail` → 确认 → `mall-create-order`；每个商品单独创建并等待前一笔响应。

## 参考

- [onboarding.md](references/onboarding.md)：申请 token、临时注入、密码管理器与 MCP 不可用时的处理。
- [workflows.md](references/workflows.md)：所有 24 个工具的用途和完整业务流程。
- [tools.md](references/tools.md)：参数传递、金额、特制和展示规则。
- [troubleshooting.md](references/troubleshooting.md)：鉴权、协议、限流和业务失败诊断。
- [tools.json](references/tools.json)：来自实时 `tools/list` 的完整输入/输出 schema 与描述。