- 麦当劳 MCP 服务是一个遵循 Model Context Protocol(MCP)标准的数据交互接口服务,由麦当劳中国提供,面向中国大陆地区(不含港澳台)使用。 - 麦当劳MCP服务现已覆盖麦乐送点餐、到店取餐、团餐、积分兑换券、活动日历查询等业务场景。更多实用工具正在持续开发上线。 - 麦当劳 MCP Server 开放平台官网:https://open.mcd.cn/mcp
Overview
- 麦当劳 MCP 服务是一个遵循 Model Context Protocol(MCP)标准的数据交互接口服务,由麦当劳中国提供,面向中国大陆地区(不含港澳台)使用。 - 麦当劳MCP服务现已覆盖麦乐送点餐、到店取餐、团餐、积分兑换券、活动日历查询等业务场景。更多实用工具正在持续开发上线。 - 麦当劳 MCP Server 开放平台官网:https://open.mcd.cn/mcp
README
简体中文 | English
介绍
什么是麦当劳 MCP 服务?
- 麦当劳 MCP 服务是一个遵循 Model Context Protocol(MCP)标准的数据交互接口服务,由麦当劳中国提供,面向中国大陆地区(不含港澳台)使用。
- 麦当劳MCP服务现已覆盖麦乐送点餐、到店取餐、团餐、积分兑换券、活动日历查询等业务场景。更多实用工具正在持续开发上线。
- 麦当劳 MCP Server 开放平台官网:https://open.mcd.cn/mcp
1. 申请 MCP Token
-
第一步:点击右上角【登录】按钮
-
第二步:跳转到登录页使用手机号验证登录
登录成功后跳转回首页,“登录”按钮变成控制台
-
第三步:申请 MCP Token
点击右上角“控制台”后,会弹出控制台弹窗
点击激活按钮,申请 MCP Token -
第四步:同意服务协议
-
第五步:MCP Token 申请成功,可以一键复制
2. 快速开始
下面介绍如何将 MCP Server 接入到 MCP Client 中,开始使用 MCP 功能。
麦当劳中国提供了远程托管的 MCP Server,用户只需在 MCP Client 中配置接入地址和 MCP Token 即可使用。
2.1 接入地址
服务器接入地址:
https://mcp.mcd.cn
2.2 传输协议与安全
使用 Streamable HTTP 协议接入
为了识别用户身份和权限,需要在请求头中携带 Authorization 字段,格式如下:
Authorization: Bearer YOUR_MCP_TOKEN
2.3 MCP 配置 JSON 示例:
为了方便使用,我们提供了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"
}
}
}
}
2.4 注意事项:
- 每个 Token 每分钟最多允许 600 次请求,超过限制会返回 429 错误码,请合理控制请求频率。
- 请确保 MCP Client 支持 Streamable HTTP 协议。
- 请妥善保管 MCP Token,避免泄露给他人。
2.5 MCP Client 推荐
2.6 各平台接入教程:
2.6.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.6.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 Token,点击【关闭】并选择【保存】
回到设置页面中,此时应显示可用的麦当劳mcp工具,服务状态应显示为【已连接】
按下 CTRL/CMD + L 打开右侧 Agent 对话框,接下来就可以直接在对话框中输入需求,让 AI 为我们调用工具了
2.6.3 TRAE
前置条件:需申请到麦当劳中国的 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 为我们调用工具了
2.7 错误码说明
| code | 原因 | 处理建议 |
|---|---|---|
| 401 | MCP Token 无效、已过期或未提供 | 检查 Authorization 请求头和 MCP Token 配置 |
| 429 | 触发限流(超过 600 次/分钟) | 降低请求频率,合理控制调用间隔 |
3. 工具列表
MCP Server 目前所支持的 Tools
4. 版本日志
| 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 | 新增取消订单、餐具选择、麦乐送订单备注功能;堂食外带场景下支持返回取餐柜二维码 |
5. 注意事项:
-
允许个人以非商业用途复制并使用本仓库中的示例配置、参数、JSON 或示例代码,并仅限用于实现与麦当劳MCP服务的连接与使用。
-
使用 麦当劳MCP 服务须遵守麦当劳中国的《使用条款》及《麦当劳MCP 服务规则》,并在申请MCP Token时同意前述条款。
-
未经书面授权,不得将本仓库内容用于商业售卖、付费分发、引流变现或任何暗示官方背书、误导公众的用途;亦不得用于任何违法、违规或黑灰产相关行为。
-
本仓库内容按“现状”提供,不构成任何形式的保证或承诺。
-
本仓库不构成对麦当劳及其关联方商标的任何授权。
-
请妥善保管您的MCP Token,避免泄露或被他人使用。
© 2026 McDonald’s. All Rights Reserved.
Install
This server does not publish a one-line install command.
Open the repository installation guide New to MCP? Start with the mcpskill.org guide →Configuration
{
"mcpServers": {
"mcd-mcp": {
"type": "streamablehttp",
"url": "https://mcp.mcd.cn",
"headers": {
"Authorization": "Bearer YOUR_MCP_TOKEN"
}
}
}
}