在 Claude、ChatGPT、Gemini 或 Cursor 中安装
# claude_desktop_config.json
{ "mcpServers": { "x1Agent": { "command": "npx", "args": ["-y", "@caterlord/x1-mcp-server"], "env": { "X1_API_ENDPOINT": "https://mcp.x1.tech/mcp" } } } }
💡 支持 Claude Desktop、ChatGPT、Gemini、Cursor 以及任何兼容 MCP 的客户端。每次预览与提交都需批准凭证 — 没有静默写入。
菜单编辑
直接在对话里改菜单。
用日常中文说出您要做的事,智能体回传预览 — 匹配项、改前改后、风险分 — 您批准后,X1 以幂等键写入。不用再对 Excel,不用再带 U 盘跑门店。
试着问
"把乌节路店所有热饮加一元"
"工作日中午加一个 $88 的套餐"
"关掉滨海湾店的燕麦奶选项"
这组包含的工具
preview
preview_adjust_menu_prices
匹配项、排除、改前改后、告警、风险分。
commit
commit_adjust_menu_prices
批准 + 幂等,附审计脉络与读回校验。
preview
preview_manage_modifier_group
选项组元数据、选项成员与顺序、选项价、项目映射。
preview
preview_manage_combo_rule
支持的套餐规则映射到 HQ 促销格式;拦截不支持的表达式。
菜单导入
PDF 菜单 → 即时上线的菜单。
丢供应商 PDF、拍墙上菜单、贴一段 Excel。智能体抽出结构化草稿、对到您 HQ 校验、逐条分类,您在批准前就已经清楚会改到哪。
试着问
"帮我把这份供应商 PDF 导入到 5 间门店"
"用新 Excel 表更新价格"
"按这张墙上菜单建一份菜单"
这组包含的工具
read
get_menu_authoring_context
一次取齐 HQ 菜单、分类、选项、税、命名提示。
read
validate_menu_catalog_draft
结构 + 重复 + HQ 冲突的确定性检查,预览之前就抓到。
preview
preview_import_menu_catalog
逐行分类:新建 / 更新 / 无变更 / 冲突 / 不支持 / 待复核。
commit
commit_import_menu_catalog
异步幂等提交,保留来源证据(页、行、区域、OCR 文本)。
诊断
问一句「为什么?」就有真答案。
东西在 Foodpanda 不见?门店无法上线?问智能体一句。它会查所有可能让品项消失的面 — 分类、菜单、选项、门店价、门店可售、在线订购 — 回复原因,再给一个安全修正。
试着问
"为什么叉烧饭在 Foodpanda 下不了单?"
"哪些品项还没准备好上线?"
"刚开的武吉士店卡在哪?"
这组包含的工具
read
diagnose_menu_item_visibility
一次查品项、分类、菜单、选项、门店价、门店可售、在线订购。
read
check_menu_publish_readiness
分店分组结果,附建议下一步安全工具。
read
diagnose_online_ordering_menu_setup
跨店诊断在线订购设定:启用、价格、可售、选项。
报表
在同一个对话里看到报表。
查趋势、比两段时期、找表现差的品项、捕捉营运异常 — 全部在您已经打开的对话里。答案标准化过、附变动值与注解,不必您自己算行。
试着问
"上周和前一周比如何?"
"机场店哪些品项表现差?"
"有没有我该关注的营运异常?"
这组包含的工具
read
get_sales_trend_summary
标准化日趋势、分店总和、注解。
read
compare_sales_periods
两期比较:总和、变动值、百分比、主要分店贡献。
read
get_item_performance_summary
品项排名、变动、贡献占比、低销量标记。
read
get_operational_exception_summary
异常附严重度、证据、建议跟进动作。
安全
从设计上就是安全的。
每次写入都走三个模式:Read 只看、Preview 做差异比对与风险评分、Commit 必须附批准凭证才会以幂等与审计脉络执行。没有静默写入。智能体永不猜 ID — 遇同名返回消歧候选。
试着问
"我怎么知道智能体要改什么?"
"智能体会不会没批准就写?"
"审计记录在哪?"
这组包含的工具
read
resolve_hq_scope_reference
将公司 / 品牌 / 门店名解析为 ID,遇同名返回消歧候选 — 智能体不猜。
read
get_task_status
查异步任务 状态与重试资格,配合长时间提交。
用 X1 开发
阅读 API 文档,一个下午就能上线。
REST、webhooks、托管 MCP 服务器 — 一份参考文档,附 TypeScript 与 Python 类型化 SDK、OpenAPI 3.1,以及绑定您账户的沙盒。