Menubarcode MCP
适用于任何 AI 代理
五个服务器将代理与实时菜单、订单、分析数据和主题工具连接起来。 其中两个完全无需注册。
连接您的 客户端
每个代码片段都指向公开的 Catalog 服务器，因此无需任何设置即可原样运行。可替换为下方任意端点；需要令牌的服务器还需添加 --header "Authorization: Bearer YOUR_TOKEN".
复制端点
公开的 Catalog URL。您将在第 2 步中将其提供给客户端。
https://menubarcode.com/mcp/catalog将其添加到您的客户端
在终端中执行一条命令，然后运行 /mcp 以确认连接成功：
claude mcp add --transport http menubarcode-catalog-mcp https://menubarcode.com/mcp/catalog对于需要令牌的服务器（例如 Admin），请传递以下请求头：
claude mcp add --transport http menubarcode-mcp https://menubarcode.com/mcp --header "Authorization: Bearer YOUR_TOKEN"在网页版或桌面版 Claude 中： 设置 → 连接器 → 添加自定义连接器, 然后粘贴步骤 1 中的端点 URL。
一键安装（将打开 Cursor）：
或手动添加到 ~/.cursor/mcp.json:
{
"mcpServers": {
"menubarcode-catalog-mcp": { "url": "https://menubarcode.com/mcp/catalog" }
}
}一键安装（将打开 VS Code）：
或手动添加到 .vscode/mcp.json. 请注意 VS Code 使用不同的架构 (type + servers):
{
"servers": {
"menubarcode-catalog-mcp": { "type": "http", "url": "https://menubarcode.com/mcp/catalog" }
}
}在 ChatGPT 中启用开发者模式，添加自定义连接器，然后粘贴步骤 1 中的服务器 URL。
对于 Windsurf、Zed 等需要命令形式的客户端，请用以下方式包装 HTTP 端点 mcp-remote:
{
"command": "npx",
"args": ["-y", "mcp-remote", "https://menubarcode.com/mcp/catalog"]
}服务器通过单响应 Streamable HTTP POST 使用 JSON-RPC 2.0 通信。列出工具：
curl -s https://menubarcode.com/mcp/catalog \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'调用工具（添加 -H "Authorization: Bearer YOUR_TOKEN" 适用于需要令牌的服务器）：
curl -s https://menubarcode.com/mcp/catalog \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_stores","arguments":{"query":"pizza"}}}'或者让你的编程智能体来设置
把它粘贴到 Claude Code、Cursor 或任何编程智能体中，它会替你添加服务器，无需终端。
Set up the Menubarcode Catalog MCP server for me. Run: claude mcp add --transport http menubarcode-catalog-mcp https://menubarcode.com/mcp/catalog then confirm it connected and list its tools.正在构建或调试？完整的协议参考文档位于 /developers.
五个服务器， 一个协议
跨 5 个服务器共 55 个工具。其中两个是公开的。全部通过 Streamable HTTP POST 使用 JSON-RPC 2.0 通信。
| 服务器 | 端点 | 认证 | 工具 |
|---|---|---|---|
menubarcode-catalog-mcp |
https://menubarcode.com/mcp/catalog |
Public | 4 |
menubarcode-dev-mcp |
https://menubarcode.com/mcp/dev |
Public | 8 |
menubarcode-mcp |
https://menubarcode.com/mcp |
API token | 23 |
menubarcode-storefront-mcp |
https://menubarcode.com/mcp/storefront |
Storefront token | 13 |
menubarcode-customer-mcp |
https://menubarcode.com/mcp/customer |
Customer token | 7 |
您需要哪个 您 服务器？
选择您的角色。每张卡片都会指向对应的服务器、其身份验证方式及其工具。
OW 店主
通过您的 AI 助手管理菜单、订单、优惠券、营业时间，并查看您自己的数据分析。
https://menubarcode.com/mcpAG 购物代理构建工具
在整个平台上发现餐厅，然后浏览某家店铺并下一个未支付、由服务器定价的订单。
https://menubarcode.com/mcp/catalogDV 主题/应用开发者
了解平台、获取权威的 Liquid 参考文档，并使用应用市场自己的检查规则验证您的主题——这一切都在您的编辑器中完成。
https://menubarcode.com/mcp/devCU 顾客/客户
查询您自己的订单、追踪配送状态，并通过已登录的助手将过去的订单重新生成为草稿。
https://menubarcode.com/mcp/customer面向 Menubarcode
发布一个店铺主题或合作伙伴应用。公开的 Dev 服务器会在您构建时把您的编辑器变成平台专家。
TH 创建主题
基于 Liquid 的店铺主题，包含 OS 2.0 分区、类型化的设置架构，以及完整的商业运行时。
- 下载 starter theme 并打开主题指南：包结构、theme.json、分区，以及 Drop 参考文档。
- 连接 Dev 服务器，借助 Liquid 参考文档和分区架构在编辑器内直接获得解答并进行构建。
- 提交前运行 validate_theme：它会应用应用市场自身的检查规则，并列出每一个错误。
claude mcp add --transport http menubarcode-dev-mcp https://menubarcode.com/mcp/devAP 开发应用
合作伙伴应用可扩展控制台功能：OAuth 访问、会话令牌、嵌入式界面、webhooks 和用量计费。
- 阅读应用指南：OAuth 与令牌、权限范围、嵌入式应用和 webhook 事件。
- 注册您的合作伙伴应用，仅请求您需要的权限范围，并在沙盒店铺环境中进行开发。
- 满足上架与审核要求后,提交至应用市场。
开发过程中,Dev 服务器上的 search_docs 和 fetch_full_doc 无需离开编辑器即可解答 API 和 Webhook 相关问题。
工具 目录
分布在 5 个服务器上的 55 个工具。展开服务器即可查看其智能体能做什么。 完整的 JSON 架构位于 开发者参考文档.
menubarcode-catalog-mcp (4 个工具) 公开
在整个平台范围内发现餐厅。仅限已上线、公开列出的店铺;绝不包含店主的个人隐私信息。
search_stores | 按名称或菜系查找餐厅。 |
search_items | 在所有店铺中搜索某道菜(“附近谁在卖沙威玛”)。 |
get_store | 单个店铺的详细信息,附带指向其 Storefront 服务器的深度链接提示。 |
menubarcode-storefront-mcp (13 个工具) Storefront：令牌
购物智能体在一家餐厅所需的一切。 create_order 创建一个未付款订单,价格由服务器计算。切勿自行发送价格。
search_menu | 搜索该店铺的菜单。 |
get_item | 单个商品的完整详情(规格、附加项、标记)。 |
validate_cart | 下单前检查购物车,获取由服务器计算的总价。 |
create_order | 创建一个未付款、由服务器定价的订单。 |
order_status | 订单的当前状态。 |
order_eta | 订单准备完成的预计时间。 |
order_history | 该店铺的历史订单。 |
reorder_last | 将上一笔订单重建为新的购物车。 |
store_credit_balance | 购物者可用的店铺信用额度。 |
restaurant_info | 营业时间、地址与下单方式。 |
suggest_upsell | 与当前购物车相关的附加项。 |
dietary_answer | 解答关于菜单的饮食相关问题。 |
menubarcode-mcp (23 个工具) API 令牌
店主的工具箱。工具按令牌能力分级授权:令牌无法执行的操作会从列表中隐藏。两个 CRM 工具还需要 crm_suite 功能。每次写入操作均通过以下方式审计:mcp。
list_restaurants | 您的餐厅 |
get_menu | 餐厅的分类与商品。 |
list_categories | 菜单分类及各分类商品数量。 |
list_orders | 订单,可按状态/日期/搜索筛选。 |
get_order | 单个订单的完整详情。 |
get_analytics | N 天内的订单数量与收入。 |
sales_report | 指定日期范围内的权威销售摘要。 |
get_restaurant_settings | 资料与下单设置快照。 |
list_coupons | 您的折扣优惠券。 |
list_customers crm_suite | 您的 CRM 客户列表。 |
get_customer crm_suite | 单个客户的完整 CRM 记录。 |
add_menu_item | 创建一个菜单项。 |
update_menu_item | 编辑商品的名称/价格/描述。 |
delete_menu_item | 永久删除某个商品。 |
set_item_availability | 将商品标记为有货/缺货(“86”切换开关)。 |
add_category | 创建一个菜单分类。 |
update_category | 重命名或重新排序某个分类。 |
delete_category | 删除一个空分类。 |
update_order_status | 推进订单状态。 |
update_business_hours | 设置公开显示的营业时间文本。 |
create_coupon | 创建一个折扣优惠券。 |
update_coupon | 编辑优惠券。 |
delete_coupon | 删除优惠券。 |
menubarcode-customer-mcp (7 个工具) Customer 令牌
已登录食客的个人账户。身份仅通过令牌确认;绝不会访问其他客户的数据。
my_orders | 您最近的订单。 |
order_detail | 您某一订单的完整详情。 |
track_order | 您订单的实时状态。 |
reorder | 将过去的订单重建为购物车草稿。 |
my_profile | 您在该餐厅的个人资料。 |
menubarcode-dev-mcp (8 个工具) 公开
将任何支持 MCP 的编辑器变成平台专家:无需离开编辑器即可学习、构建、验证。
learn_platform | 平台入门介绍。请先调用此工具。 |
get_liquid_reference | 权威的 Liquid 白名单(实时生成)。 |
get_section_schema | 主题区块架构格式(设置、区块、连接逻辑)。 |
search_docs | 在开发者文档中进行关键词搜索。 |
fetch_full_doc | 通过路径获取一篇完整文档。 |
validate_theme | 对您的主题文件运行市场自带的检查。 |
submit_feedback | 报告文档缺口,或指出有误或缺失的内容。 |
立即体验 现在
打开 Claude 并预填提示词。优先体验无需鉴权的提示词。
"帮我找到附近评分最高的沙威玛，并显示菜单。"
"根据 Menubarcode 市场规则验证我的主题,并列出所有错误。"
"本周我最畅销的商品是什么,它们带来了多少收入?"
"在我的菜单中添加一款 25 SAR 的斋月特惠餐,并将其标记为可售。"
"将我常点的商品从我最喜欢的店铺重建为购物车草稿。"
"追踪我的最新订单,并告诉我预计到达时间。"
认证 令牌
两台服务器是公开的。另外三台需要使用您自己的令牌进行身份验证。
| 服务器 | 客户端如何进行身份验证 | 在哪里获取令牌 | 权限范围 |
|---|---|---|---|
| Catalog / Dev | 无(公开) | 无需 | 公开,仅限只读 |
| Admin | Authorization: Bearer <token> | 仪表盘 → API 密钥 / Connect AI | 按能力划分(跨 6 种资源的读/写);CRM 工具需要 crm_suite |
| Storefront | X-Storefront-Token: <token> | 仪表盘 → 店面令牌 | 按店铺;权限范围 menu:read, order:write, agent |
| Customer | Authorization: Bearer <token> | 食客登录(注册/登录/验证码) | 仅限该食客本人的账户 |
每个令牌限制为每分钟 60 次请求、每小时 1000 次。Storefront 服务器则允许每分钟 120 次。超出限制将返回 HTTP 429:请降低请求频率后重试。
密钥仅显示一次,仅以 SHA-256 哈希形式存储,可随时在控制台中撤销。
安全
- 遵循最小权限原则。 Admin 令牌按能力范围授权:仅赋予智能体其所需的能力。它无法使用的工具将完全从其工具列表中隐藏。
- 保持人工确认功能开启。 不要自动批准写入操作;每次写入都是真实的,并通过以下方式审计:mcp。
- 密钥卫生。 令牌仅显示一次,并以哈希形式存储。切勿将其提交到代码或代码仓库中;一旦泄露应立即轮换。
- 尽可能优先使用只读权限。 对于分析或购物类智能体而言,只读权限或公开服务器比具备写入能力的服务器更安全。
还有疑问 已离开
什么是 MCP？
Model Context Protocol 是一个开放标准，让 AI 代理（Claude、Cursor、ChatGPT 等）能够在服务器上调用真实工具，而不是凭空猜测。将客户端指向我们五个端点中的任意一个，代理即可浏览菜单、下单、读取您的销售数据，或根据 Menubarcode 的实时数据验证主题。
哪些客户端可以连接？
任何支持 MCP、通过 Streamable HTTP 连接的客户端：Claude Code、Claude（网页版和桌面版）、Cursor、VS Code、ChatGPT 开发者模式、Windsurf、Zed，或直接使用 curl。各客户端的一条命令配置方法请参见 Connect your client 部分。
我需要哪个服务器？
购物代理使用公开的 Catalog 和 Storefront 服务器。店主使用带 API 令牌的 Admin 服务器。主题和应用开发者使用公开的 Dev 服务器。顾客使用自己登录的 Customer 服务器。"Which server do you need?" 卡片会将每类用户对应到各自的服务器。
是免费的吗？
连接是免费的。Catalog 和 Dev 服务器完全公开：无需注册，无需密钥。Admin、Storefront 和 Customer 服务器需要令牌，而您作为店主、店铺或已登录顾客早已拥有该令牌。
我需要 API 密钥吗？
五个服务器中有两个不需要。Catalog（发现餐厅）和 Dev（构建主题）是公开的，完全不需要密钥。其余三个服务器通过您在控制台生成或登录时获取的令牌进行身份验证。
写操作如何受到保护？
每次写操作都限定在令牌所有者的范围内，并以 via: mcp 的形式记录审计日志。Admin 令牌按权限范围授予：只授予代理所需的权限，代理无权使用的工具会从工具列表中完全隐藏。请保持客户端的人工确认提示开启，确保任何工具运行都不会在您不知情的情况下发生。
速率限制是多少？
每个令牌限制为每分钟 60 次请求、每小时 1000 次（Storefront 服务器则允许每分钟 120 次）。超出限制的突发请求将返回 HTTP 429。请放慢速度后重试。
我可以自己构建主题或应用吗？
可以。主题：下载 starter theme，参照 Liquid 参考文档进行开发，并在提交到应用市场前使用 Dev 服务器的 validate_theme 工具进行验证。应用：注册合作伙伴应用以获得 OAuth 访问权限、webhooks、嵌入式控制台界面和用量计费。两份指南均位于 /developers 下。
我的白标域名可以使用它吗？
可以。此页面上的每个服务器、名称和 URL 都具备品牌感知能力：在分销商域名下，端点展示的是分销商自己的品牌和相应的服务器名称，而非平台品牌。/.well-known/mcp.json 处的发现清单同样具备品牌感知能力。
如何移除我被收录的数据？
公开的 Catalog 服务器仅收录处于活跃状态且公开上架的店铺，绝不会暴露店主的个人身份信息。在店铺的控制台设置中关闭公开上架，该店铺即会从目录结果中消失。
