端點
端點是https://api.brightalk.ai/mcp,以 Streamable HTTP 提供。每個請求都必須在 Authorization 標頭以 bearer 權杖帶上在 Brightalk API 設定建立的 bt_live_ 金鑰,方式與身分驗證與權限範圍相同。沒有帶格式正確金鑰的請求會傳回 401。
請把金鑰放在執行 AI 工具那台機器的環境變數 BRIGHTALK_API_KEY。下方範例都從這個變數讀取,所以設定檔裡不會出現金鑰。
唯讀模式
使用https://api.brightalk.ai/mcp?read_only=true 可以隱藏所有會寫入資料、撥打電話或發送訊息的工具。其餘工具能讀取什麼,仍由金鑰的權限範圍決定。
Claude Code
將這個項目加入專案根目錄的.mcp.json。Claude Code 啟動時會把佔位符號換成環境變數的值。
Codex
將這個項目加入~/.codex/config.toml。bearer_token_env_var 填的是環境變數的名稱,不是金鑰本身。
其他客戶端
任何支援遠端 MCP 與自訂請求標頭的客戶端都能連線。填入端點網址,並在Authorization 標頭以 bearer 權杖傳送金鑰。只提供 OAuth 登入的連接器無法連線。
權限範圍與限制
每一次工具呼叫,都是以您的金鑰發出的一個 API 請求。它需要與對應 REST 操作相同的權限範圍,計入相同的速率限制,並遵守相同的冪等性規則。發起通話、啟動批次、執行含通話或訊息步驟的自動化,以及發送 LINE 訊息或簡訊,都可能聯絡到真人並產生費用。建立批次本身不會開始撥號;查詢與簡訊預覽不會發送訊息。簡訊字數與點數
每段簡訊扣 1 點,電信抬頭、[署名]、變數代入後的文字及最終短網址都計入。
71–132 個中文編碼字元扣 2 點,133–198 個扣 3 點。GSM 的
^、{、}、[、]、~、|、\ 各佔 2 單位;換行、底線 _ 或反引號(U+0060)會改用中文編碼。不支援 emoji/非 BMP 字元。完整規則見簡訊字數與扣點。
名單超過 1,000 筆
一般撥號與簡訊批次最多接受 1,000 筆名單。更多名單請使用大型簡訊或撥號任務,每個任務最多 10 萬筆:- 用
brightalk_create_bulk_task建立任務。 - 用
brightalk_upload_bulk_task_chunk上傳完整名單,每次最多 1,000 筆。 - 用
brightalk_start_bulk_task明確啟動背景處理。 - 用
brightalk_get_bulk_task查詢整體進度,再用brightalk_list_bulk_task_parts找到各批次結果。
目前的限制
- 只能以 API 金鑰登入,尚未提供 OAuth 登入。
- 同一模式下,每把金鑰看到的工具清單都相同;唯讀模式包含查詢與簡訊預覽。列出工具只檢查金鑰格式;金鑰是否有效及具備所需權限範圍,要透過實際查詢確認。
- 每個請求各自獨立,伺服器不會在請求之間保留工作階段。