TOID MCP 安裝

BYOLLM：在本機用你的 LLM 客戶端連線 TOID API。需先登入取得 token，再於 Cursor 等工具註冊 MCP server。

前置

已登入 TOID 的 Firebase 使用者
Node.js 24+
可連線的 TOID 主機（本機或部署網址）

建置

pnpm -C packages/toid-mcp install
pnpm -C packages/toid-mcp run build

環境變數

變數	必填	說明
TOID_MCP_BEARER_TOKEN	是	Firebase ID token
TOID_API_BASE_URL	否	預設 http://localhost:3000

開發時取得 token：登入後於瀏覽器 console 執行 firebase.auth().currentUser.getIdToken()

Tools

validate_submission — Zod 預檢、重複偵測與完整度
submit_submission — 寫入 productSubmissions
get_gap_tasks — 讀取待補任務
lookup_insurance_product — 爬前查目錄是否已有商品
start_tii_crawl — 啟動保發中心爬取
get_tii_crawl_job — 輪詢爬取任務狀態

Cursor 設定

{
  "mcpServers": {
    "toid": {
      "command": "node",
      "args": ["<repo>/packages/toid-mcp/dist/index.js"],
      "env": {
        "TOID_MCP_BEARER_TOKEN": "<token>",
        "TOID_API_BASE_URL": "https://your-toid-host"
      }
    }
  }
}

完整說明見 repo 內 docs/features/toid/mcp-install.md。