AI 助理連線（MCP）

讓 Claude 這類 AI 助理直接連進 StoreOps——用聊天的方式看月報、查帳目、記帳、建物料。AI 能做的事永遠是你能做的事的一部分，而且成功執行的操作都會寫入稽核日誌。

運作方式

連線碼（sop_ 開頭的一長串字元）就是 AI 助理的鑰匙，綁定「這間店＋產生它的人」。
產生時可以選它能不能寫入、角色上限、多久到期（預設 90 天）。AI 實際能做的事，是你目前的角色、連線碼的讀寫權限、角色上限三者取交集，以最小的那個為準。
你之後被降權，連線碼跟著縮小；你之後被升權，連線碼不會跟著變大。
刪帳、日結、月關帳、撥款核銷只能在網頁做，AI 一律被擋——即使連線碼有寫入權限。
連線碼不是密碼，可以隨時撤銷重產，不影響你的登入帳號。

產生連線碼

進入 設定 → 整合，找到「AI 助理連線」區塊（需 manager 以上權限）。
填一個備註方便辨識（例如「店長電腦的 Claude」）。
選它可以做什麼：只勾「讀取資料」就是一條唯讀連線碼，AI 只能看不能改。
選角色上限：只能選到你自己的角色為止。想給人試用，選「店員」最保險。
選有效期限：預設 90 天，也可以自訂天數或選「永久」。清單上快到期的會標「建議輪替」。
按 產生連線碼。連線碼只顯示這一次，離開頁面就看不到了——請立刻用「複製連線碼」或「複製連線指令」存起來。
遺失了不用緊張：撤銷舊的、再產一條新的即可。每間店最多 50 條。

連線方式一覽

你用的工具	連線方式
Claude Code（終端機）	一行指令，頁面上的「複製連線指令」直接就是它
Claude 網頁版／桌面版／手機	自訂連接器，見在 Claude 網頁版連接 StoreOps
Codex CLI	指令＋環境變數
Hermes	設定檔 `config.yaml`
Cursor、opencode 等支援 MCP 的工具	設定檔（URL＋Authorization header）
ChatGPT	目前接不上：它的自訂連接器只支援 OAuth／無認證，吃不了固定連線碼

各工具設定方式

以下範例把 https://你的網址 換成你實際使用的 StoreOps 網址、sop_你的連線碼 換成剛產生的連線碼。

bash

claude mcp add --transport http storeops https://你的網址/api/mcp \
  --header "Authorization: Bearer sop_你的連線碼"

# 之後在 Claude Code 裡輸入 /mcp 可確認連線狀態

bash

# Codex 不直接存連線碼，改讀環境變數（建議把 export 放進 ~/.bashrc 或 ~/.zshrc）
export STOREOPS_MCP_TOKEN="sop_你的連線碼"

codex mcp add storeops \
  --url https://你的網址/api/mcp \
  --bearer-token-env-var STOREOPS_MCP_TOKEN

yaml

# ~/.hermes/config.yaml
mcp_servers:
  storeops:
    url: https://你的網址/api/mcp
    headers:
      Authorization: Bearer sop_你的連線碼

json

// ~/.cursor/mcp.json（全域）或專案裡的 .cursor/mcp.json
{
  "mcpServers": {
    "storeops": {
      "url": "https://你的網址/api/mcp",
      "headers": { "Authorization": "Bearer sop_你的連線碼" }
    }
  }
}

json

// opencode.json
{
  "mcp": {
    "storeops": {
      "type": "remote",
      "url": "https://你的網址/api/mcp",
      "headers": { "Authorization": "Bearer sop_你的連線碼" }
    }
  }
}

通用原則

只要工具支援「remote／HTTP MCP server＋自訂 header」，就能連 StoreOps：URL 填 https://你的網址/api/mcp，header 加 Authorization: Bearer sop_你的連線碼。

可以請 AI 做什麼

連上之後直接用中文聊：

「幫我審查 8 月的月報，跟 7 月比一比」（也可以用內建的 analyze_month 提示範本）
「記一筆今天的房租支出 25,000」
「列出低於安全庫存的備品」
「上週外送的營收是多少？」

AI 可用的功能：讀（月報、帳目明細、物料、備品、廠商、銷售來源、收款方式、記帳分類、關帳狀態、固定費用、日結內容）與寫（記帳、修改帳目、建物料、建備品、建廠商）。刻意沒有提供任何刪除功能——刪東西請自己來。

撤銷與安全

在「AI 助理連線」清單按撤銷，該連線碼立即失效。
連線碼是一把可撤銷的鑰匙：在它的能力上限內，拿到的人就能以你的身分操作。不要貼給別人、不要存在共用文件裡。
AI 成功執行的操作、連線碼的產生與撤銷，都會出現在稽核日誌。
被「網頁專屬」或連線碼權限擋下的呼叫，資料完全沒被碰到，也不會留下紀錄（那只是 AI 問了一句它不能做的事）。但如果是權限不足或已關帳被擋，那會留一筆記錄，看得出是哪一條連線碼想動什麼。

疑難排解

症狀	原因與解法
AI 回「請先登入」	連線碼打錯或已被撤銷——重新產生一條，換掉工具設定裡的舊碼
「MCP endpoint not found」或 404	網址不對（結尾必須是 `/api/mcp`），或伺服器尚未開啟 MCP 功能
「請稍後再試」（429）	請求太頻繁，等一分鐘再試
改了帳但被拒絕	該月份已關帳，或該筆是同步／POS 自動產生的資料——這些保護對 AI 一樣生效

AI 助理連線（MCP） ​

運作方式 ​

產生連線碼 ​

連線方式一覽 ​

各工具設定方式 ​

可以請 AI 做什麼 ​

撤銷與安全 ​

疑難排解 ​