跳轉到內容

ChatBooster MCP 使用說明 ​

ChatBooster 提供 MCP(Model Context Protocol)伺服器。把它接到 Claude、Cursor 等支援 MCP 的 AI 工具後,你就能用日常語言查詢聯絡人、整理收件匣、回覆現有對話,以及查看廣播與數據成效。

如果你只想在 Claude 網頁版使用,可以直接看在 Claude 中使用 ChatBooster。本文說明所有連接方式,以及 AI 工具連上後能做什麼。

伺服器資訊 ​

項目內容
伺服器網址https://mcp.chatbooster.ai/mcp
傳輸方式Streamable HTTP(遠端伺服器,無需在本機安裝任何程式)
驗證方式OAuth 授權,或 MCP token

事前準備 ​

  • 一個 ChatBooster 帳戶。
  • 一個至少已接入一個頻道(WhatsApp、Messenger、Instagram、LINE 等)的工作區。沒有接入頻道時,還沒有可查詢的客戶資料。
  • 一個支援遠端 MCP 伺服器的 AI 工具。

選擇連接方式 ​

連接方式適合的情況權限
OAuth 授權AI 工具支援 OAuth 登入,例如 Claude 的連接器、Claude Code授權時可選擇只讀取,或同時允許執行操作
MCP tokenAI 工具需要你手動填入憑證,例如 Cursor 的設定檔與你在 ChatBooster 的角色權限相同

不論哪一種方式,AI 工具能看到和能做的事,都不會超出你在 ChatBooster 網頁上的權限。

方式一:OAuth 授權 ​

  1. 在 AI 工具中新增一個遠端 MCP 伺服器,網址填入 https://mcp.chatbooster.ai/mcp。
  2. AI 工具會打開 ChatBooster 的登入頁面。登入或建立帳戶,我們會把驗證碼寄到你的電子郵件。
  3. 選擇要授權的工作區,確認申請的權限後點選 授權。
  4. 頁面會自動回到 AI 工具,連接完成。

授權頁面會顯示該應用程式申請的權限:

權限範圍允許的操作
chatbooster:read讀取聯絡人、對話、訊息、標籤、列表、廣播與數據分析
chatbooster:write為聯絡人新增或移除標籤、新增備註、更改對話狀態、指派對話、設定對話標籤,以及在現有對話中發送訊息
offline_access保持連接,無需重新登入

確認授權對象

授權頁面會顯示資料將傳送到哪個網域。請確認這次連接確實是你自己剛才在 AI 工具中發起的,再點選授權。

Claude(網頁版):打開 Settings → Connectors,找到 ChatBooster 並點選 Connect。詳細步驟見在 Claude 中使用 ChatBooster。

Claude Code:在終端機執行以下指令,然後在 Claude Code 中輸入 /mcp 完成登入。

bash
claude mcp add --transport http chatbooster https://mcp.chatbooster.ai/mcp

方式二:MCP token ​

MCP token 是屬於你個人的存取憑證,適合無法走 OAuth 登入流程的 AI 工具。

建立 token ​

  1. 登入 ChatBooster,進入 個人設定 → MCP 連接。
  2. 點選 建立 token,為它命名。建議用要接入的工具或裝置命名(例如「Cursor — 公司電腦」),日後才知道該撤銷哪一個。
  3. 立即複製 token。token 只會顯示這一次,遺失後只能撤銷再重新建立。

請妥善保管 token

  • token 帶的是你本人的權限,請勿轉給同事使用。每位成員應各自建立自己的 token。
  • 持有 token 的 AI 工具可以執行寫入操作,包括向客戶發送訊息。
  • 不要把 token 提交到程式碼倉庫或貼到公開的地方。懷疑外洩時,請立即到 個人設定 → MCP 連接 撤銷。

在 AI 工具中填入 token ​

在請求標頭中帶上 token:

Authorization: Bearer 你的_MCP_token

Cursor:在 ~/.cursor/mcp.json(或專案內的 .cursor/mcp.json)加入:

json
{
  "mcpServers": {
    "chatbooster": {
      "url": "https://mcp.chatbooster.ai/mcp",
      "headers": {
        "Authorization": "Bearer 你的_MCP_token"
      }
    }
  }
}

Claude Code:

bash
claude mcp add --transport http chatbooster https://mcp.chatbooster.ai/mcp --header "Authorization: Bearer 你的_MCP_token"

其他 AI 工具:只要支援遠端 MCP 伺服器(Streamable HTTP)並可自訂請求標頭,填入上面的伺服器網址與 Authorization 標頭即可。

第一個任務 ​

連接後,對 AI 工具說:

Check my ChatBooster workspace setup.

它會告訴你工作區是否已經準備好。如果還沒接入頻道,請打開它提供的設定頁面,接入一個頻道,然後用你自己的號碼或專頁發一則測試訊息。工作區有資料後,可以試試:

  • 顯示最近五個待處理的對話並總結。
  • 列出最近五個聯絡人及其標籤。
  • 上週有沒有客戶問過退款?
  • 我最近一次廣播的成效如何?

可用的工具 ​

AI 工具會按你的指示自動選用以下工具,你不需要記住名稱。

讀取資料 ​

工具用途
search_contacts按關鍵字、標籤、列表或頻道搜尋聯絡人
get_contact查看單一聯絡人的完整資料
list_contact_notes查看聯絡人的備註
get_contact_activity查看聯絡人的活動記錄,例如加入列表、被加上標籤、資料被修改
list_conversations列出對話,可按狀態、負責人或頻道篩選
get_conversation_messages讀取某個對話的完整訊息
search_messages跨對話按關鍵字搜尋訊息
list_conversation_labels列出對話標籤及各標籤下的對話數
list_tags列出聯絡人標籤
list_contact_lists列出聯絡人列表
list_custom_fields列出自訂欄位
list_channels列出已接入的頻道
list_broadcasts列出廣播及其成效(觸及、送達、已讀、回覆、失敗)
get_broadcast_stats查看單一廣播的最新進度與成效
get_analytics查詢指定時間範圍內的彙總數字,例如新增聯絡人數、發出的訊息數

執行操作 ​

以下工具會更改你工作區的資料。使用 OAuth 授權時,需要授予 chatbooster:write 權限。

工具用途可否復原
add_contact_tag為聯絡人加上標籤可以,移除標籤即可
remove_contact_tag移除聯絡人的標籤可以,重新加上即可
create_contact_note為聯絡人新增備註需在 ChatBooster 網頁刪除
update_conversation_status把對話狀態改為進行中或已關閉可以,再改回去即可
assign_conversation把對話指派給某位成員,或取消指派可以,重新指派即可
set_conversation_label設定對話標籤。一個對話只有一個標籤,設定即取代原有標籤可以,重新設定即可
clear_conversation_label清除對話標籤可以,重新設定即可
send_message在現有對話中以文字回覆客戶不可以

工作區 ​

工具用途
list_workspaces列出你可以存取的工作區
switch_workspace切換目前操作的工作區
get_workspace_setup_status檢查工作區是否已接入頻道、是否已有資料,以及下一步該做什麼

發送訊息 ​

send_message 會真的把訊息發給你的客戶,而且發出後無法撤回。請在同意 AI 工具發送前,檢查收件人和內容。

  • 只能回覆已存在的對話,不能向任意號碼發起新對話。
  • 目前只支援純文字。
  • 廣播可以查看和分析,但不能透過 MCP 建立或發送。

多個工作區 ​

AI 工具每次只操作一個「目前工作區」。你可以請它列出你的工作區,再切換到其中一個。

切換會持續生效

切換工作區後,設定會一直保留,並且會影響所有使用同一個連接或 token 的 AI 工具,而不只是目前這一次對話。在多個工具之間共用同一個 token 時請特別留意。

語言 ​

AI 工具看到的工具說明與提示訊息可以設為繁體中文或英文。到 個人設定 → MCP 連接 更改,修改後需要重新連接 AI 工具才會生效。

方案與帳單 ​

你工作區的 ChatBooster 方案在 AI 工具中同樣適用。請在 ChatBooster 網站上管理方案與帳單;更換方案後不需要重新連接。

疑難排解 ​

你看到的情況處理方式
AI 工具顯示需要授權,或回傳 401連接已失效或 token 已被撤銷。請重新連接,或建立新的 token。使用 token 時,確認標頭格式為 Authorization: Bearer <token>
AI 工具要求你選擇工作區請它列出你的工作區,再切換到其中一個
「Permission denied」你在這個工作區的角色不允許此操作,請聯絡工作區擁有者
無法執行寫入操作使用 OAuth 授權時,可能只授予了讀取權限。請中斷連接後重新授權,並允許執行操作
查詢結果是空的請 AI 工具檢查工作區設定,你可能還沒有接入頻道,或頻道還沒有收到訊息
發送訊息時提示 WhatsApp 付款問題需要先在 Meta 補上付款方式,完成後直接重試即可,不需要重新連接 ChatBooster
登入時出現「嘗試次數過多」等待 15 分鐘後重新索取驗證碼

中斷連接 ​

  • OAuth 授權:在 AI 工具中移除 ChatBooster 連接,或到 ChatBooster 的 個人設定 → MCP 連接,在「已授權的應用程式」中撤銷。
  • MCP token:到 個人設定 → MCP 連接 點選 撤銷。正在使用這個 token 的 AI 工具會立即失效,且無法復原。

中斷連接不會刪除任何 ChatBooster 資料。

隱私 ​

我們處理哪些資料、如何申請刪除,請參閱我們的隱私政策。如有疑問:[email protected]。