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 疑難排解 檢查連接及權限。
何時要求店主/管理員協助
- 你不確定助理選擇了哪個品牌、店舖或渠道。
- 預覽會更改即時價格、稅項、折扣、網上落單、付款相關設定或裝置設定。
- 助理無法用清楚文字解釋更改前後結果。
- 登入後看不到需要使用的品牌或店舖。