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 token | AI 工具需要你手動填入憑證,例如 Cursor 的設定檔 | 與你在 ChatBooster 的角色權限相同 |
不論哪一種方式,AI 工具能看到和能做的事,都不會超出你在 ChatBooster 網頁上的權限。
方式一:OAuth 授權
- 在 AI 工具中新增一個遠端 MCP 伺服器,網址填入
https://mcp.chatbooster.ai/mcp。 - AI 工具會打開 ChatBooster 的登入頁面。登入或建立帳戶,我們會把驗證碼寄到你的電子郵件。
- 選擇要授權的工作區,確認申請的權限後點選 授權。
- 頁面會自動回到 AI 工具,連接完成。
授權頁面會顯示該應用程式申請的權限:
| 權限範圍 | 允許的操作 |
|---|---|
chatbooster:read | 讀取聯絡人、對話、訊息、標籤、列表、廣播與數據分析 |
chatbooster:write | 為聯絡人新增或移除標籤、新增備註、更改對話狀態、指派對話、設定對話標籤,以及在現有對話中發送訊息 |
offline_access | 保持連接,無需重新登入 |
確認授權對象
授權頁面會顯示資料將傳送到哪個網域。請確認這次連接確實是你自己剛才在 AI 工具中發起的,再點選授權。
Claude(網頁版):打開 Settings → Connectors,找到 ChatBooster 並點選 Connect。詳細步驟見在 Claude 中使用 ChatBooster。
Claude Code:在終端機執行以下指令,然後在 Claude Code 中輸入 /mcp 完成登入。
claude mcp add --transport http chatbooster https://mcp.chatbooster.ai/mcp方式二:MCP token
MCP token 是屬於你個人的存取憑證,適合無法走 OAuth 登入流程的 AI 工具。
建立 token
- 登入 ChatBooster,進入 個人設定 → MCP 連接。
- 點選 建立 token,為它命名。建議用要接入的工具或裝置命名(例如「Cursor — 公司電腦」),日後才知道該撤銷哪一個。
- 立即複製 token。token 只會顯示這一次,遺失後只能撤銷再重新建立。
請妥善保管 token
- token 帶的是你本人的權限,請勿轉給同事使用。每位成員應各自建立自己的 token。
- 持有 token 的 AI 工具可以執行寫入操作,包括向客戶發送訊息。
- 不要把 token 提交到程式碼倉庫或貼到公開的地方。懷疑外洩時,請立即到 個人設定 → MCP 連接 撤銷。
在 AI 工具中填入 token
在請求標頭中帶上 token:
Authorization: Bearer 你的_MCP_tokenCursor:在 ~/.cursor/mcp.json(或專案內的 .cursor/mcp.json)加入:
{
"mcpServers": {
"chatbooster": {
"url": "https://mcp.chatbooster.ai/mcp",
"headers": {
"Authorization": "Bearer 你的_MCP_token"
}
}
}
}Claude Code:
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]。