Brightalk.aiBrightalk.ai
預約 Demo

BRIGHTALK MCP

你的 AI，現在能操作 CRM。

在 Claude 或 Codex 裡說明任務，讓 Brightalk MCP 接手聯絡人、AI 通話、自動化與簡訊。熟悉的對話視窗，接上團隊每天使用的 CRM。

查看連線步驟前往後台設定

開發者預覽 · 本機連線 · 需 Brightalk 原始碼與組織 API 金鑰

brightalk / mcp互動示意
先預覽這則簡訊的字數，再依我確認的內容發給指定聯絡人。

Brightalk 工具

brightalk_preview_sms
brightalk_send_sms

完成預覽後提交發送，取得活動 ID 與排隊狀態；排隊不代表已送達。

此處為操作示意，切換情境不會讀取資料、撥號或發送簡訊。

MODEL CONTEXT PROTOCOL

從一句任務，到 CRM 裡的動作。

MCP 是讓 AI 工具連接外部服務的協定。Brightalk MCP 將 CRM 功能提供給你的 AI 工具，透過組織 API 金鑰執行授權範圍內的查詢與操作。

Claude / CodexBrightalk.aiMCPBrightalk CRM

GET CONNECTED

讓下一段對話，接上你的工作。

先用查詢確認連線，再按團隊需求開啟操作權限。同一份設定引導，也能在後台「設定 → API → MCP」找到。

目前提供本機開發者預覽

需要 Brightalk 原始碼副本、Node.js，以及已啟用 Public API 的組織。目前尚未提供公開安裝套件、遠端 MCP 網址或 OAuth 一鍵連線。

聯絡團隊協助開通

沿用組織的使用限制

通話、簡訊與流程依現有方案及點數計費，並受金鑰權限、流量與目的地限制約束。

查看方案與費用
先選擇使用方式

這裡的選擇會更新設定範例與建議權限。實際權限由 API 金鑰決定；切換模式後，請更新客戶端設定並重啟 MCP。

  1. 準備組織的 API 金鑰

    組織須已啟用 Public API。請使用 bt_live_ 開頭的金鑰，依任務勾選權限；既有金鑰不會自動取得新增權限。

    前往後台設定

  2. 準備本機執行環境

    取得 Brightalk 原始碼副本，安裝符合專案 package.json 要求的 Node.js，並在專案根目錄執行 npm ci。尚未取得原始碼時，請先聯絡 Brightalk 團隊協助。

    在該專案的 .env.local 加入下列設定，將佔位文字換成你的金鑰。保留檔案中既有的設定，金鑰只存放在本機，不要貼進 AI 對話或提交到版本控制。

    .env.local
    BRIGHTALK_API_KEY=bt_live_REPLACE_WITH_YOUR_KEY

  3. 把 Brightalk 加入 AI 工具

    例如 /Users/you/brightalk 或 C:\Projects\brightalk。此欄用於產生下方的客戶端設定。

    在 Claude Desktop 的 Settings → Developer → Edit Config 開啟設定檔，加入下方 brightalk 項目。

    claude_desktop_config.json
    {
  "mcpServers": {
    "brightalk": {
      "command": "node",
      "args": [
        "/absolute/path/ai-native-crm/node_modules/tsx/dist/cli.mjs",
        "--tsconfig",
        "/absolute/path/ai-native-crm/tsconfig.json",
        "/absolute/path/ai-native-crm/scripts/brightalk-mcp.mts"
      ],
      "env": {
        "BRIGHTALK_MCP_READ_ONLY": "true"
      }
    }
  }
}

    若已有其他 MCP，請合併 brightalk 項目並保留原設定。設定檔不包含金鑰，MCP 啟動時會讀取 Brightalk 專案的 .env.local。

    查看客戶端官方設定文件

  4. 用查詢確認連線

    儲存後重啟客戶端或 MCP 連線，確認工具清單出現 brightalk_ 開頭的工具，再試著說：

    請用 Brightalk 列出前 5 位聯絡人，只查詢，不修改資料。

    工具出現在清單代表 MCP 已啟動；成功取得資料或空清單，才能確認 API 連線與權限。只有簡訊預覽不會發送，但仍需要 sms:send 權限。

    連不上時，先檢查這三件事
    • 找不到 node：把設定中的 command 換成 node 執行檔的完整路徑。macOS／Linux 可用 command -v node 查詢；Windows 可用 where.exe node。
    • 驗證失敗：檢查金鑰是否為 bt_live_、是否過期或撤銷，以及組織是否已啟用 Public API。
    • 權限不足：檢查該工具所需的 scope；若要取得逐字稿、錄音或批次工具的資料，需另外勾選對應權限。

連線之前，你可能想知道

可以在哪些 AI 工具中使用？

本機版提供 Claude Desktop、Claude Code 和 Codex 的設定範例，也適用於支援 stdio MCP 的客戶端。只接受遠端 MCP 網址的服務，目前無法直接連線。

可以先只讓 AI 查資料嗎？

可以。查詢模式會隱藏寫入與發送工具；金鑰也可只勾選需要的讀取權限。簡訊預覽不會發送，但仍需要 sms:send。切換畫面上的模式不會更改既有金鑰或已執行的 MCP，請同步更新設定並重啟。

AI 可以幫我建立新的自動化流程嗎？

這版可以啟動或取消既有流程的執行，也可以查詢狀態。流程本身須先在 Brightalk 後台建立並啟用，MCP 目前不編輯流程定義。

通話或簡訊回傳成功，就代表完成了嗎？

不一定。排隊狀態代表已接受請求，通話可再查詢執行進度。簡訊目前沒有獨立的狀態查詢工具，排隊成功也不表示已送達。需要重試時，應沿用同一次操作的識別碼與內容，避免重複操作。

CRM 資料會交給我使用的 AI 工具嗎？

會。你呼叫的工具會將授權範圍內的結果交給該 AI 客戶端，因此請確認團隊允許使用的 AI 服務與資料政策。API 金鑰保留在本機設定；MCP 不會將金鑰當成工具結果回傳。