X1 Model Context Protocol (MCP)
适合对象
希望用 AI 助理协助处理 X1 HQ 报表、设置、菜单维护、在线点餐和门店设置的店主、后台管理员、设置人员和经理。
开始之前
- 确认你的 X1 账号有权限查看或更改目标品牌和门店。
- 确认你的 AI 客户端支持通过 HTTPS 连接远程 MCP 服务器。
- 使用官方 X1 MCP 服务器地址：
https://mcp.posx1.ai/mcp。 - 将实时菜单价格、在线点餐、设备设置和门店设置视为高风险更改。
本章用途
X1 MCP 服务器让 AI 助理以受控方式使用 X1 HQ 工具。它可以协助查询数据、检查设置、准备更改、显示预览，并在你批准后应用更改。
你可以用自然语言提出要求，例如：
- “显示昨天各门店销售，并与上周二比较。”
- “找出没有显示到在线点餐的品项。”
- “将所有热饮加价
$1，先显示调整前后表格。” - “读取这份上传菜单，整理分类、品项、加配项和套餐规则供我检查。”
- “检查这家门店是否已准备好启用在线点餐。”
AI 助理可以在对话中读取你上传的文件、图片、PDF 或表格。MCP 服务器会协助把已检查的结果转成结构化 X1 HQ 更改。MCP 服务器不能取代经理批准。
如何使用本章
- 先阅读 连接 AI 助理，将 AI 客户端连接到 X1 MCP。
- 使用 X1 MCP 可以做什么 选择合适的请求类型。
- 在要求助理更改实时 HQ 数据前，先阅读 安全使用 MCP。
- 如连接、登录、权限、预览或应用步骤出现问题，使用 MCP 故障排查。
常见工作
| 工作 | 先要求助理做什么 | 检查后才批准什么 |
|---|---|---|
| 查看销售 | 要求按品牌、门店和日期范围显示汇总。 | 只读报表不需要批准。 |
| 导入菜单 | 要求显示解析出的分类、品项、加配项和套餐规则。 | 只有当预览与来源菜单和目标门店一致时才批准。 |
| 更改价格 | 要求按分类显示调整前后表格。 | 检查所有受影响品项和渠道后才批准。 |
| 修正在线点餐显示 | 要求检查准备状态和缺少的设置。 | 只批准你理解的指定设置或菜单更改。 |
| 更改钱箱名称 | 要求先显示当前设备设置。 | 确认目标门店和钱箱后才批准。 |
批准后会发生什么
MCP 更改遵循与 HQ 更改相同的运营规则：
- 读取请求只会查看数据。
- 预览请求会准备建议更改并显示预期结果。
- 应用请求会把已批准的预览写入 X1 HQ。
- 部分应用动作可能以后台任务执行。请要求助理检查任务状态，才假设更改已完成。
应用后，请在使用该数据的位置验证结果：HQ、POS、在线点餐、报表或目标门店。
如出现问题
- 在批准写入动作前停止。
- 要求助理显示已选品牌、门店、渠道和受影响记录。
- 如果来源文件、品项列表或目标范围有变化，要求重新预览。
- 使用 MCP 故障排查 检查连接和权限。
何时要求店主/管理员协助
- 你不确定助理选择了哪个品牌、门店或渠道。
- 预览会更改实时价格、税项、折扣、在线点餐、付款相关设置或设备设置。
- 助理无法用清楚文字解释更改前后结果。
- 登录后看不到需要使用的品牌或门店。