简体中文 | English

介绍

什么是 麦当劳 MCP 服务?

• 麦当劳 MCP 服务是一个遵循 Model Context Protocol（MCP）标准的数据交互接口服务，由麦当劳中国提供，面向中国大陆地区（不含港澳台）使用。
• 麦当劳MCP服务现已覆盖四大核心业务接口，为开发者提供麦当劳品牌资讯与会员账号权益的集成支持。目前支持的功能包括活动日历查询、麦麦省优惠券查询与领取等。更多实用工具正在持续开发中，即将陆续上线，敬请期待。

1. 申请 MCP Token

麦当劳开放平台网址：麦当劳开放平台

• 第一步：点击右上角【登录】按钮
  
• 第二步：跳转到登录页使用手机号验证登录
  
  登录成功后跳转回首页，“登录”按钮变成控制台
  
• 第三步：申请 MCP Token
  点击右上角“控制台”后，会弹出控制台弹窗
  点击激活按钮，申请MCP Token
  
• 第四步：同意服务协议
  
• 第五步：MCP Token 申请成功，可以一键复制
  

2. 快速开始

下面介绍如何将 MCP Server 接入到 MCP Client 中，开始使用 MCP 功能。
麦当劳提供了远程托管的 MCP Server，用户只需在 MCP Client 中配置接入地址和密钥即可使用。

2.1 接入地址

服务器接入地址：https://mcp.mcd.cn/mcp-servers/mcd-mcp

2.2 传输协议与安全

使用 Streamable HTTP 协议接入
为了识别用户身份和权限，需要在请求头中携带 Authorization 字段，格式如下：

Authorization: Bearer YOUR_MCP_TOKEN

2.3 MCP 配置 JSON 示例：

为了方便使用，我们提供了JSON 配置示例。
复制下面的配置，替换 YOUR_MCP_TOKEN 为实际密钥，粘贴到 MCP Client 的 MCP Server 配置中即可。

{
  "mcpServers": {
    "mcd-mcp": {
      "type": "streamablehttp",
      "url": "https://mcp.mcd.cn/mcp-servers/mcd-mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

2.4 注意事项：

• ⚠️当前 MCP Server 目前仅支持 MCP Version 2025-06-18及之前的版本。
• 每个 Token 每分钟最多允许 600 次请求，超过限制会返回 429 错误码，请合理控制请求频率。
• 请确保 MCP Client 支持 Streamable HTTP 协议。
• 请妥善保管 MCP Token，避免泄露给他人。

2.5 各平台接入教程：

2.5.1 Cherry Studio

前置条件：一定需要申请到麦当劳中国的 MCP Token，教程：申请 MCP Token
参考 Cherry Studio 官方文档：https://docs.cherry-ai.com/advanced-basic/mcp

1、 打开 Cherry Studio，进入设置页面
2、 选择“MCP”选项卡
3、 点击“添加”按钮
4、 在弹出的下拉框中，选择“从 JSON 导入”

从上面粘贴 JSON复制进去， 一定记得替换 “YOUR_MCP_TOKEN”，然后点击“确定”按钮

添加完成后，请打开启用开关

恭喜！你已经设置 MCP 成功啦！快去聊天窗口上开启使用吧！

2.5.2 Cursor

前置条件：一定需要申请到麦当劳中国的 MCP Token，教程：申请 MCP Token
参考 Cursor 官方文档：https://cursor.com/cn/docs/context/mcp

打开 Cursor，点击顶部菜单栏【设置】→【Tools & MCP】，在 Installed MCP Servers 中点击【Add Custom MCP】

在打开的 mcp.json 文件中填入从上面复制的JSON内容，一定记得替换 YOUR_MCP_TOKEN 为实际密钥，点击【关闭】并选择【保存】

回到设置页面中，此时应显示可用的麦当劳mcp工具，服务状态应显示为【已连接】

按下 CTRL/CMD + L 打开右侧 Agent 对话框，接下来就可以直接在对话框中输入需求，让 AI 为我们调用工具了

2.5.3 TRAE

前置条件：一定需要申请到麦当劳中国的 MCP Token，教程：申请 MCP Token
参考 TRAE 官方文档：https://docs.trae.cn/ide/model-context-protocol

打开 Trae，点击【设置】→【MCP】→ 【手动添加】进行添加

在打开的手动配置页面中填入从上面复制的JSON内容，一定记得替换YOUR_MCP_TOKEN 为实际密钥，点击【确认】

回到MCP页面中，此时应显示可用的麦当劳mcp工具，服务状态应显示为【已连接】

回到对话框中 ，选择【Builder with MCP】

接下来就可以直接在对话框中输入需求，让 AI 为我们调用工具了

3. 调试指南

3.1 MCP Client 推荐

3.2 LLM 推荐

截止 2025 年 12 月 9 日

4. 工具

MCP Server 目前所支持的 Tools

4.1 工具列表

4.1.1 活动日历查询工具

描述：

查询麦当劳中国当月的营销活动日历，返回进行中、往期和未来日期的活动。适用于查看用户进行中和即将到来的可参与活动，还可查询用户对活动的订阅状态。

入参：

响应内容：

示例：

### 当前时间：2025-12-09 14:48:42
### 活动列表：
#### 12月8日 往期回顾
-   **活动标题**：小女警沙发！12月12日麦麦商城见！⏰\
    **活动内容介绍**：❗️超萌酷小女警爱心沙发来袭
		😍小女警+汉堡刺绣+粉嫩配色
		✨满满英雄力和快乐能量！
		💥12月12日14:00准时发售
		👇提前预约，心动别错过！\
    **活动图片介绍**：\
    <img src="https://cms-cdn.mcd.cn/img/short-content/86a849ae4b9528e53ac595ffa1b39cf9.png" alt="" height="300" width="auto">
#### 12月9日 今日
-   **活动标题**：⏳倒计时！超人气「芝芝火腿扒堡」即将回归！\
    **活动内容介绍**：🍔松软芝芝火腿扒堡搭配鲜萃咖啡
		💥一堡+一咖啡！还是天天￥9.9！
		☀一口下去给元气满满的早晨充能！
		⏰12月15日起，超值低价闭眼冲！\
    **活动图片介绍**：\
    <img src="https://cms-cdn.mcd.cn/img/short-content/39bb241887869bca544b67a355cb616f.jpg" alt="" height="300" width="auto">

4.1.2 麦麦省券列表查询

描述：

查询用户当前可领取的麦麦省的优惠券列表。返回券名称、图片、状态和促销标签。当用户询问有什么优惠、可以领什么券时使用此工具。

入参：

无需入参

响应内容：

示例：

### 麦麦省优惠券列表：
- 优惠券标题：11.9元麦乐鸡 \
  状态：已领取 \
  优惠券图片：\
    <img src="https://img.mcd.cn/cms/images/077b86c9268d33a0.png" height="auto" width="300">
- 优惠券标题：9.9元薯你最甜 \
  状态：未领取 \
  优惠券图片：\
    <img src="https://img.mcd.cn/cms/images/0853e0f8882dc66e.png" height="auto" width="300">
- 优惠券标题：北非蛋风味麦满分 \
  状态：不可领取 \
  优惠券图片：\
    <img src="https://img.mcd.cn/cms/images/6714e5753b475d96.png" height="auto" width="300">

4.1.3 麦麦省一键领券

描述：

自动领取麦麦省所有当前可用的麦当劳优惠券。无需指定具体的优惠券和couponId，系统会自动领取用户可领的所有券。当用户说"帮我领券"、"自动领取优惠券"、"一键领券"时使用此工具。

入参：

无需入参

响应内容：

示例：

### 🎉 领券结果

**总计**: 1 张优惠券
**成功**: 1 张
**失败**: 0 张

---

#### ✅ 成功领取的优惠券：

- **9.9元薯你最甜**
  - couponId：8ED8D8BEBEBDEF26B615682E92EFAC86
  - couponCode：MCDD60T892ST5EV00N1090
  - 图片：<img src="https://img.mcd.cn/cms/images/0853e0f8882dc66e.png" alt="9.9元薯你最甜" height="200" width="auto">

4.1.4 我的优惠券查询

描述：

查询我有哪些可用的优惠券。就像打开麦当劳APP的"我的优惠券"页面，能看到所有可以用来点餐的优惠券列表。 包括但不限于使用场景： - 用户想知道自己有哪些优惠券可以用 - 检查优惠券的有效期和使用条件 - 查看优惠券数量和状态

入参：

无需入参

响应内容：

示例：

# 您的优惠券列表

共 1 张可用优惠券

## 9.9元薯你最甜
- **优惠**: ¥9.9 (用券价格)
- **有效期**: 2025-12-09 00:00-2026-02-12 23:59
- **领取时间**: 今日收到
- **标签**: 到店专用、外送专用

<img src="https://mcd-portal-prod-cos1-1300270282.cos.ap-shanghai.myqcloud.com/campaign/prod/campaign-offer/coupon/66f226e438714697b9f15d1a753d91ba/%E5%A4%A7%E8%96%AF%E6%9D%A1.jpg?sign=q-sign-algorithm%3Dsha1%26q-ak%3DAKIDCD6mEcX25tVrjNxiPvEICas0uXyBKIBs%26q-sign-time%3D1763363214%3B1921043214%26q-key-time%3D1763363214%3B1921043214%26q-header-list%3D%26q-url-param-list%3D%26q-signature%3D59b757fb6a863e8debfcdce8e595bf268d9c0cb9" alt="悟空加价特调免费券0411" height="300" width="auto">

4.1.5 当前时间信息查询工具

描述：

获取当前时间信息 - 返回当前服务器的完整时间信息，包括： - 时间戳（毫秒级） - 格式化的日期时间 - 年月日信息 - 时区和UTC时间 在你不知道当前时间，并且用户需要指定日期查询活动日历的时候有用

入参：

无需入参

响应内容：

示例：

{
  "success": true,
  "code": 200,
  "message": "请求成功",
  "datetime": "2025-12-11 17:57:05",
  "traceId": "7b7255e6b4682f35dc0b4df39ffcf02d",
  "data": {
    "timestamp": 1765447025424,
    "datetime": "2025-12-11T17:57:05.424",
    "formatted": "2025-12-11 17:57:05",
    "date": "2025-12-11",
    "year": 2025,
    "month": 12,
    "day": 11,
    "dayOfWeek": "THURSDAY",
    "timezone": "GMT+08:00",
    "offset": "+08:00",
    "utc": "2025-12-11T09:57:05.425Z"
  }
}

5. 版本日志

6. 注意事项：

• 允许个人以非商业用途复制并使用本仓库中的示例配置、参数、JSON 或示例代码，并仅限用于实现与麦当劳MCP服务的连接与使用。

• 使用 麦当劳MCP 服务须遵守麦当劳中国的《使用条款》及《麦当劳MCP 服务规则》，并在申请MCP Token时同意前述条款。

• 未经书面授权，不得将本仓库内容用于商业售卖、付费分发、引流变现或任何暗示官方背书、误导公众的用途；亦不得用于任何违法、违规或黑灰产相关行为。

• 本仓库内容按“现状”提供，不构成任何形式的保证或承诺。

• 本仓库不构成对麦当劳及其关联方商标的任何授权。

• 请妥善保管您的MCP Token，避免泄露或被他人使用。

© 2025 McDonald’s. All Rights Reserved.