在 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 對表,不用再帶隨身碟跑門市。
試著問
"信義店所有熱飲加一塊"
"平日中午加一個 $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,以及綁定您帳戶的沙盒。