简体中文 | English
什么是麦当劳 MCP 服务?
- 麦当劳 MCP 服务是一个遵循 Model Context Protocol（MCP）标准的数据交互接口服务，由麦当劳中国提供，面向中国大陆地区（不含港澳台）使用。
- 麦当劳MCP服务现已覆盖麦乐送点餐、到店取餐、团餐、积分兑换券、活动日历查询等业务场景。更多实用工具正在持续开发上线。
- 麦当劳 MCP Server 开放平台官网：https://open.mcd.cn/mcp
- 第一步：点击右上角【登录】按钮
- 第二步：跳转到登录页使用手机号验证登录
登录成功后跳转回首页，“登录”按钮变成控制台
- 第三步：申请 MCP Token
点击右上角“控制台”后，会弹出控制台弹窗
点击激活按钮，申请 MCP Token - 第四步：同意服务协议
- 第五步：MCP Token 申请成功，可以一键复制
下面介绍如何将 MCP Server 接入到 MCP Client 中，开始使用 MCP 功能。
麦当劳中国提供了远程托管的 MCP Server，用户只需在 MCP Client 中配置接入地址和 MCP Token 即可使用。
服务器接入地址：
https://mcp.mcd.cn
使用 Streamable HTTP 协议接入
为了识别用户身份和权限，需要在请求头中携带 Authorization 字段，格式如下：
Authorization: Bearer YOUR_MCP_TOKEN
为了方便使用，我们提供了JSON 配置示例。
复制下面的配置，替换 YOUR_MCP_TOKEN 为实际 MCP Token，粘贴到 MCP Client 的 MCP Server 配置中即可。
{
"mcpServers": {
"mcd-mcp": {
"type": "streamablehttp",
"url": "https://mcp.mcd.cn",
"headers": {
"Authorization": "Bearer YOUR_MCP_TOKEN"
}
}
}
}
- 每个 Token 每分钟最多允许 600 次请求，超过限制会返回 429 错误码，请合理控制请求频率。
- 请确保 MCP Client 支持 Streamable HTTP 协议。
- 请妥善保管 MCP Token，避免泄露给他人。
前置条件：需申请到麦当劳中国的 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 功能。
前置条件：需申请到麦当劳中国的 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 Token，点击【关闭】并选择【保存】
回到设置页面中，此时应显示可用的麦当劳mcp工具，服务状态应显示为【已连接】
按下 CTRL/CMD + L 打开右侧 Agent 对话框，接下来就可以直接在对话框中输入需求，让 AI 为我们调用工具了
前置条件：需申请到麦当劳中国的 MCP Token，教程：申请 MCP Token
参考 TRAE 官方文档：https://docs.trae.cn/ide/model-context-protocol
打开 Trae，点击【设置】→【MCP】→ 【手动添加】进行添加
在打开的手动配置页面中填入从上面复制的JSON内容，一定记得替换YOUR_MCP_TOKEN 为实际 MCP Token，点击【确认】
回到MCP页面中，此时应显示可用的麦当劳mcp工具，服务状态应显示为【已连接】
回到对话框中 ，选择【Builder with MCP】
接下来就可以直接在对话框中输入需求，让 AI 为我们调用工具了
| code | 原因 | 处理建议 |
|---|---|---|
| 401 | MCP Token 无效、已过期或未提供 | 检查 Authorization 请求头和 MCP Token 配置 |
| 429 | 触发限流（超过 600 次/分钟） | 降低请求频率，合理控制调用间隔 |
MCP Server 目前所支持的 Tools
| Tool | Name | Description |
|---|---|---|
| list-nutrition-foods | 餐品营养信息列表 | 获取麦当劳常见餐品的营养成分数据，包括能量、蛋白质、脂肪、碳水化合物、钠、钙等信息。当用户咨询麦当劳餐品的热量、营养，或需要帮助用户搭配指定热量套餐时使用此工具 |
| delivery-query-addresses | 获取用户可配送地址列表 | 查询用户已创建的配送地址列表，用于外送点餐时选择配送地址 |
| delivery-create-address | 新增配送地址 | 当用户无可配送地址或需新增收货地址时使用，用于创建新的可配送地址 |
| delivery-query-stores | 查询可配送的门店列表 | 外送场景下查询用户收货地址附近可配送门店 |
| query-meal-assistance | 查询助餐服务 | 仅企业团餐场景下，查询该门店支持的助餐服务 |
| query-nearby-stores | 查询附近可用门店 | 查询用户提供地址附近的麦当劳餐厅 |
| query-store-coupons | 查询用户当前门店下可用的优惠券列表 | 查询用户在当前门店下可使用的优惠券列表，用于点餐时选择可用优惠 |
| query-meals | 查询当前可售卖的餐品列表 | 查询当前门店可售卖的餐品菜单（分类、餐品编码、标签等），用于点餐选品 |
| query-meal-detail | 查询餐品详情 | 根据餐品编码查询餐品详情套餐组成，用于查看套餐包含内容以及可以替换选项 |
| calculate-price | 商品价格计算 | 根据用户选购商品列表（可含优惠券）计算商品金额、配送费、优惠金额及应付总价 |
| create-order | 创建订单 | 根据门店信息、就餐方式、商品列表等信息创建订单，返回订单详情与支付链接 |
| cancel-order | 取消订单 | 取消点餐订单。当用户说"取消订单"、"我要取消"、"帮我取消一下订单"时，可使用该工具进行取消 |
| query-order | 查询订单详情 | 查询订单状态、订单内容、配送信息等，用于用户查看订单进度或确认订单信息 |
| order-list | 查询历史订单 | 查询近期的到店/外送历史订单（非商城订单，商城订单请使用 mall-order-list） |
| campaign-calendar | 活动日历查询工具 | 查询麦当劳中国当月的营销活动日历，返回进行中、往期和未来日期的活动 |
| available-coupons | 麦麦省券列表查询 | 查询用户当前可领取的麦麦省的优惠券列表 |
| auto-bind-coupons | 麦麦省一键领券 | 自动领取麦麦省所有当前可用的麦当劳优惠券。无需指定具体的优惠券和couponId，系统会自动领取用户可领的所有券 |
| query-my-coupons | 我的优惠券查询 | 查询用户有哪些可用的优惠券。支持用户查看账户下所有优惠券列表 |
| query-my-account | 我的积分查询 | 查询用户积分账户信息，包括可用积分、累计积分、冻结积分、即将过期积分等 |
| mall-points-products | 查询麦麦商城商品列表 | 查询麦麦商城内可使用积分兑换或现金购买的商品（不包括使用积分兑换的第三方兑换码） |
| mall-product-detail | 查询麦麦商城商品详情 | 查询商城商品详细信息（图片、积分、有效期、说明、详情等） |
| mall-create-order | 积分兑换商品下单 | 使用积分兑换虚拟或实物商品，完成积分校验、积分扣减及发券或实物库存扣减，返回兑换订单号和券码信息 |
| now-time-info | 获取当前时间信息 | 返回当前的完整时间信息，以便于 LLM 知道当前的时间和日期 |
| query-lottery-info | 查看积分抽奖活动信息 | 查询当前积分抽奖活动的基本信息，包括活动状态、奖品列表、抽奖消耗规则和用户可用资源 |
| draw-lottery | 积分抽奖 | 执行一次积分抽奖，消耗积分或次数，返回是否中奖及奖品信息 |
| query-my-prizes | 查看我的奖品 | 查询用户在积分抽奖活动中获得的全部奖品记录，支持分页，按中奖时间倒序排列 |
| mall-order-list | 麦麦商城订单查询 | 查询麦麦商城内近一年购买或兑换的商品订单列表 |
| mall-order-detail | 麦麦商城订单详情查询 | 查询麦麦商城订单的详细信息，包括支付积分、支付金额和订单状态等 |
| query-party-city | 主题活动城市列表查询 | 查询主题活动商品对应的可参与城市列表 |
| query-party-store | 主题活动门店列表查询 | 查询指定城市下主题活动可参与的门店列表 |
| query-partystore-date | 主题活动可预约日期查询 | 查询指定门店下主题活动的可预约日期列表 |
| query-partystore-session | 主题活动可预约日期场次查询 | 查询指定门店、指定日期下主题活动的可预约场次列表 |
| party-order-create | 主题活动订单创建 | 创建主题活动订单，当用户选择好城市、门店、日期、场次后使用此工具下单 |
| Date | Version | Description |
|---|---|---|
| 2025-12-09 | 1.0.0 | 麦麦日历和麦麦省领券 MCP Server |
| 2026-01-23 | 1.0.1 | 增加了“餐品营养信息列表”Tool，我们缩短了 URL 以便于大家连接 |
| 2026-02-13 | 1.0.2 | 增加了麦乐送点餐与积分兑换券场景的Tools |
| 2026-04-02 | 1.0.3 | 增加了到店取餐与团餐场景的Tools |
| 2026-05-21 | 1.0.4 | 增加了积分兑换实物、商城订单查询等 Tools，并支持得来速车道取餐场景下单及全部点餐场景预约功能 |
| 2026-06-16 | 1.0.5 | 支持更换套餐内商品组合、部分餐品特制 |
| 2026-07-16 | 1.0.6 | 新增历史订单查询工具；支持展示餐品优惠价格；支持随单购买麦金卡和早餐卡 |
| 2026-07-29 | 1.0.7 | 新增麦当劳派对、品鉴会等主题活动查询、预约与下单功能 |
| 2026-08-27 | 1.0.8 | 新增积分抽奖工具：查看活动信息、抽奖、查我的奖品 |
| 2026-09-10 | 1.0.9 | 新增取消订单、餐具选择、麦乐送订单备注功能；堂食外带场景下支持返回取餐柜二维码 |
-
允许个人以非商业用途复制并使用本仓库中的示例配置、参数、JSON 或示例代码，并仅限用于实现与麦当劳MCP服务的连接与使用。
-
使用 麦当劳MCP 服务须遵守麦当劳中国的《使用条款》及《麦当劳MCP 服务规则》，并在申请MCP Token时同意前述条款。
-
未经书面授权，不得将本仓库内容用于商业售卖、付费分发、引流变现或任何暗示官方背书、误导公众的用途；亦不得用于任何违法、违规或黑灰产相关行为。
-
本仓库内容按“现状”提供，不构成任何形式的保证或承诺。
-
本仓库不构成对麦当劳及其关联方商标的任何授权。
-
请妥善保管您的MCP Token，避免泄露或被他人使用。
© 2026 McDonald’s. All Rights Reserved.