在 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,以及绑定你账户的 sandbox。