SimplyBoost MCP

官方

向 SimplyBoost AI 支援代理詢問問題、回覆他們轉交給團隊的對話、跟進潛在客戶並更新其知識庫

你可以用 SimplyBoost MCP 做什麼？

尋找聊天機器人 — 列出權杖可使用的聊天機器人，並依 ID 取得單一聊天機器人的詳細資料。
傳送訪客訊息 — 以訪客的身分向聊天機器人提問，並傳入 threadId 以繼續現有對話。
檢視對話 — 列出所有管道中的對話、讀取對話訊息，並取得單一對話。
以人工身分處理對話 — 接手對話、回覆、將對話交還給聊天機器人、解決對話或重新開啟對話。
管理潛在客戶 — 列出並讀取已收集的潛在客戶、更新其詳細資料或標記為已轉換，並刪除潛在客戶。
管理知識來源 — 列出聊天機器人已知的內容、新增文字或網站、編輯或重新整理來源，並刪除來源。

託管 MCP 伺服器

npx add-mcp 'https://get-api.simplyboost.io/api/v1/mcp'

可安裝到 Claude Code、Codex、Cursor 等客戶端

文件

這是什麼

MCP 伺服器位於 https://get-api.simplyboost.io/api/v1/mcp。它使用 Streamable HTTP 傳輸，並使用與 REST API (Authorization: Bearer sb_live_…) 相同的 API token、相同的方案（Growth、Pro 和 Enterprise）、相同的權限和相同的限制。每個工具的功能都與對應的 REST 端點相同，且需要相同的 scope；如果助理看到自己無權使用的工具，會明確拒絕，而不是回報錯誤。

它是無狀態的：每次呼叫都是一個請求和一個回覆，不需要維持工作階段，因此你可以從任何機器連線。伺服器不會自行啟動串流。

連線用戶端

有兩種方式。登入（OAuth）：新增伺服器位址，當用戶端提示時，以團隊擁有者身分在 SimplyBoost 分頁中核准，並選擇團隊、權限和聊天機器人。claude.ai 和 ChatGPT 連接器、Cursor、Codex 和 Claude Code 都是透過這種方式連線，不需要貼上任何內容。使用 token：如果是手動設定的用戶端或你自己的指令碼，請在 Settings → API 中建立一個只包含助理所需權限的 token，並將它作為標頭傳送。

Claude Code（提示時登入）

claude mcp add --transport http simplyboost https://get-api.simplyboost.io/api/v1/mcp

Codex

codex mcp add simplyboost --url https://get-api.simplyboost.io/api/v1/mcp
codex mcp login simplyboost

Cursor、Windsurf、VS Code 和其他使用 mcp.json 的用戶端（提示時登入）

{
  "mcpServers": {
    "simplyboost": { "url": "https://get-api.simplyboost.io/api/v1/mcp" }
  }
}

相同設定，但使用 token 而非登入

{
  "mcpServers": {
    "simplyboost": {
      "url": "https://get-api.simplyboost.io/api/v1/mcp",
      "headers": { "Authorization": "Bearer sb_live_…" }
    }
  }
}

透過登入建立的連線有效期為 90 天，只會取得擁有者勾選的權限（除非勾選，否則無法刪除），並會列在 Settings → API → Connected apps 中，擁有者可隨時中斷連線。只有團隊擁有者可以核准連線，這與建立 token 的規則相同。核准畫面上顯示的應用程式名稱是應用程式自行宣告的名稱；SimplyBoost 不會驗證。

用戶端設定中的 token 等同於你帳戶的密碼。請將它保存在自己的電腦上，設定到期時間，並在設定檔遭到分享時輪替 token。登入可避免這個問題：不會有任何機密資訊寫入檔案。

提供給用戶端開發者：伺服器遵循 MCP 授權規範。沒有憑證的請求會回覆 401，並附上 WWW-Authenticate 標頭，指出受保護資源中繼資料 (https://get-api.simplyboost.io/.well-known/oauth-protected-resource/api/v1/mcp)，其中會指出授權伺服器 (https://get-api.simplyboost.io/.well-known/oauth-authorization-server)。用戶端會自行註冊（Dynamic Client Registration），使用含 PKCE 的授權碼流程（僅支援 S256），可以指定資源，並取得會輪替的 refresh token。Access token 的有效期為一小時，且只能用於 MCP 端點；REST 端點則使用 API token。

工具

引數和結果使用與 REST API (chatbotId、threadId、camelCase 欄位) 相同的名稱，因此端點頁面同時適用於兩者。請先使用 list_chatbots 查詢聊天機器人的 ID。

工具	需要	功能
`get_account`	無	帳戶、方案和 token 本身的權限。
`get_usage`	`account:read`	本計費週期已使用的訊息數。
`list_chatbots`、`get_chatbot`	`chatbots:read`	token 可使用的聊天機器人。
`send_message`	`conversations:write`	像訪客一樣向聊天機器人提問；會計入方案的訊息數。傳入 `threadId` 以繼續對話。
`list_conversations`、`get_conversation`、`list_messages`	`conversations:read`	所有管道上的對話及其訊息。
`take_over_conversation`、`reply_to_conversation`、`hand_back_to_chatbot`、`resolve_conversation`	`conversations:write`	像真人一樣處理對話：接手、回覆、交還、解決或重新開啟。
`list_leads`、`get_lead`	`leads:read`	聊天機器人收集到的潛在客戶。
`update_lead`	`leads:write`	修改潛在客戶的詳細資料或將其標記為已轉換。
`delete_lead`	`leads:delete`	刪除潛在客戶。
`list_knowledge_sources`、`get_knowledge_source`	`knowledge:read`	聊天機器人已知的內容，以及每個來源的狀態和文字。
`add_text_knowledge`、`add_website_knowledge`、`update_knowledge_source`、`refresh_knowledge_source`	`knowledge:write`	教導聊天機器人文字或網站內容、編輯來源、重新讀取網站。
`delete_knowledge_source`	`knowledge:delete`	移除來源。

檔案上傳和 webhook 不提供為工具；請改用 REST 端點。刪除工具會標記為具破壞性，且伺服器指示助理先徵求你的同意。

錯誤與限制

遭拒的工具呼叫（缺少權限、token 無法查看的聊天機器人、無效引數或方案限制）會以標記為錯誤的工具結果傳回，並附上與 REST API 相同的 code 和訊息，讓助理能告訴你需要變更什麼。缺少或無效的 token 會回覆 401，不含 API 的方案或已失效的訂閱會回覆 403，而每個 token 的速率限制會回覆 429，與 REST API 完全相同。

不是 JSON-RPC 2.0 的訊息會收到 JSON-RPC 錯誤。端點上的 GET 和 DELETE 會回覆 405，因為沒有工作階段，也沒有伺服器串流。