X1
🇭🇰Hong Kong
文件預約示範→
AI 代理

首個 AI 操作得到嘅 POS。

你嘅代理唔止係睇 — 佢會改價、用 PDF 匯入餐牌、診斷網上落單問題、拎報表。每次寫入都經 Read → Preview → Commit,有審批、冪等同審計脈絡。廠商中立:Claude、ChatGPT、Gemini、Cursor。

喺 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 的客戶端。每次預覽同提交都要審批憑證 — 冇靜靜哋寫入。
✦
Claude
X1 connected
⋯
✦
✓Used X1 · get_net_sales_summary
Here's how the group looked this week (Apr 13–19):
ShopThis weekvs last
Harbour CentralHK$ 312,450+11.1%
Kowloon BayHK$ 284,720+14.0%
Tsim Sha TsuiHK$ 356,110+10.9%
Causeway BayHK$ 288,700−2.0%
Net sales were up +8.7% vs last week. Kowloon Bay led the pack. Causeway Bay dipped slightly — want me to check the void log for that shop?
Check Causeway Bay voids →
Top selling items this week →
+Ask about your shops…Sonnet 4.5↑
餐牌編輯

喺對話入面直接改餐牌。

用日常對話講低你想點做,代理返預覽 — 配對項目、改前改後、風險分 — 你批准後,X1 用冪等鍵提交。唔使再入 Excel,唔使再揹 USB 去每間店。

試下問
"將九龍灣所有熱飲加一蚊"
"星期一至五中午加個 $88 套餐"
"關咗中環店嘅燕麥奶選項"
呢組包含嘅工具
preview
preview_adjust_menu_prices
配對項目、排除、改前改後、警告、風險分。
commit
commit_adjust_menu_prices
審批 + 冪等,附審計脈絡同讀回驗證。
preview
preview_manage_modifier_group
選項組資料、選項成員同次序、選項價錢、項目對應。
preview
preview_manage_combo_rule
將支援嘅套餐規則映射去 HQ 推廣格式;攔截不支援嘅表達式。
✦
Claude
X1 connected
⋯
✦
✓Used X1 · preview_adjust_menu_prices
Matched 5 items in Hot Drinks at Kowloon Bay. Risk low, no exclusions.
ItemBeforeAfter
Latte$28$29
Cappuccino$28$29
Americano$24$25
Flat White$30$31
Mocha$34$35
Ready to commitidempotency_key · txn_7e1f · audit lineage
Approve to commit — X1 will write through commit_adjust_menu_prices and read back to confirm every row.
Approve & commit
Edit preview
Also update Central
+Ask about your shops…Sonnet 4.5↑
餐牌匯入

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 文字)。
✦
Claude
X1 connected
⋯
✦
✓Used X1 · preview_import_menu_catalog
Extracted 6 items from supplier-menu.pdf (page 1–2). Source evidence preserved per row.
PDF
supplier-menu.pdf
2 pages · OCR done · 6 rows
Latte — $28
99% confidence
create
Cappuccino — $28
matches existing
update
Americano — $24
no change
no-op
Mocha Special
modifier mismatch
conflict
Flat White — $30
price only
update
Iced Latte
84% confidence
review
4 safe to commit · 1 conflict needs your eyes · 1 low-confidence row flagged for review. Approve the safe set, resolve the rest?
Approve safe set (4)
Review conflicts (1)
Re-scan page 2
+Ask about your shops…Sonnet 4.5↑
診斷

問一句「點解?」拎到真正答案。

件嘢喺 Foodpanda 唔見?間店上唔到網?問代理一句。佢會睇晒所有可能原因 — 分類、餐牌、選項、店價、店供應、網上落單開關 — 回覆你個原因,再畀個安全嘅修正。

試下問
"點解叉燒飯喺 Foodpanda 落唔到單?"
"邊啲項目未可以上網?"
"新開嘅旺角店有咩阻住?"
呢組包含嘅工具
read
diagnose_menu_item_visibility
一次睇項目、分類、餐牌、選項、店價、店供應、網上落單。
read
check_menu_publish_readiness
逐店分組結果,連建議下一步安全工具。
read
diagnose_online_ordering_menu_setup
跨店診斷網上落單設定:啟用、價錢、供應、選項。
✦
Claude
X1 connected
⋯
✦
✓Used X1 · diagnose_menu_item_visibility
Found it. Char Siu Rice is marked unavailable at the Kwun Tong shop — it's been off since Saturday 21:00, likely 86'd during service and never re-enabled.
I checked all 8 surfaces that can hide an item. Seven were fine:
✓item detail · category visibility · POS menu · smart-category · modifier availability · shop price · online ordering
✕Shop availability — off at Kwun Tong since Sat 21:00 (last toggled by pos.user42)
Want me to flip it back on? I'd run preview_update_menu_availability first — you'd see the exact diff and approve before I commit.
Yes, preview the fix
Who marked it off?
Check other items at Kwun Tong
+Ask about your shops…Sonnet 4.5↑
報表

喺同一個對話入面拎報表。

查走勢、比兩段時期、睇邊啲項目失色、捉營運異常 — 全部喺你而家已經開住嘅對話入面。答案已經正規化,有變動值同注解,唔使你自己計算。

試下問
"上星期同前星期比點?"
"機場店邊啲項目表現差?"
"有冇我要睇嘅營運異常?"
呢組包含嘅工具
read
get_sales_trend_summary
正規化日走勢、分店總和、注解。
read
compare_sales_periods
兩期比較:總和、變動值、百分比、主要分店貢獻。
read
get_item_performance_summary
項目排名、變動、貢獻比、低銷量標記。
read
get_operational_exception_summary
異常連嚴重度、證據、建議跟進動作。
✦
Claude
X1 connected
⋯
✦
✓Used X1 · compare_sales_periods
Last 7 days at Kowloon Bay — HK$ 32,600, up +12.4% vs. the prior week.
Net sales · by hour
Peak Apr 12 · HK$ 0
Apr 1
Apr 2
Apr 3
Apr 4
Apr 5
Apr 6
Apr 7
Apr 8
Apr 9
Apr 10
Apr 11
Apr 12
Apr 13
Apr 14
Top moversvs priortrend
Char Siu Rice+19.8%↗
Milk Tea+10.2%↗
⚑Oxtail Stew−25.2%↘
⚑ Oxtail Stew flagged: low-sales trend · consider menu review
Drill into Oxtail Stew
Compare to last year
Hourly breakdown
+Ask about your shops…Sonnet 4.5↑
安全

由設計開始就係安全嘅。

每次寫入都經三個模式:Read 係睇、Preview 做差異同風險評分、Commit 要審批憑證先會用冪等同審計脈絡寫入。冇靜靜哋寫。代理永遠唔會估 ID — 遇到同名會返消歧候選。

試下問
"我點知代理正打算改咩?"
"代理會唔會無批准就寫?"
"審計紀錄喺邊?"
呢組包含嘅工具
read
resolve_hq_scope_reference
將公司 / 品牌 / 分店名解成 ID,有同名就給消歧 — 代理永遠唔估。
read
get_task_status
查非同步任務狀態同重試資格,配合長時間提交。
✦
Claude
X1 connected
⋯
✦
✓Used X1 · get_recent_audit_lineage
I can't. Every write tool I call goes through preview → your approval → commit — and nothing else. No hidden tools, no silent writes, no fallback paths.
Here's the full lineage of the last change I made for you, straight from X1's audit log:
14:02:08PREVIEWpreview_adjust_menu_prices · 5 items · risk low
14:02:14APPROVEDby you · approval_tok_9a3f · scope: Kowloon Bay
14:02:14COMMITcommit_adjust_menu_prices · idempotency: txn_7e1f
14:02:15READBACK5 / 5 rows verified · audit entry written
You can pull this lineage for any tool call, any time. Without a valid approval token, no commit tool will run at all.
Export the audit log
Who can approve?
Revoke my approval
+Ask about your shops…Sonnet 4.5↑
用 X1 開發

睇 API 文件,一個下午上線。

REST、webhooks、雲端 MCP 伺服器 — 一份參考,附 TypeScript 及 Python 類型化 SDK、OpenAPI 3.1,及綁定你帳戶的 sandbox。