ThunderPhone 2.0 正式上線。全程自助，每分鐘 2 美分起。查看公告
立即開始

Connect tools & data

將 ThunderPhone 作為 MCP 伺服器使用

將任何 Streamable HTTP MCP 用戶端連線至 ThunderPhone，以列出智慧體、檢視通話與逐字稿，並使用組織 API 金鑰撥打外撥電話。

ThunderPhone 在以下位置提供 Model Context Protocol 伺服器：

https://api.thunderphone.com/v1/mcp

將 MCP 用戶端指向該可串流 HTTP 端點，即可將你組織的智慧體和通話作為工具使用。這與將遠端 MCP 伺服器連線至語音智慧體的方向相反：

方向結果
遠端 MCP 伺服器 → ThunderPhone 智慧體你的語音智慧體可以呼叫遠端伺服器的工具。
ThunderPhone → 你的 MCP 用戶端你的 MCP 用戶端可以呼叫 ThunderPhone 的智慧體與通話工具。

驗證身分

在 組織 → 金鑰 下建立 sk_live_ 金鑰，並將其作為 Bearer 權杖傳送。MCP 端點接受組織 API 金鑰，不接受控制台工作階段 Cookie 或可公開使用的小工具金鑰。

Generic client configuration
{
  "mcpServers": {
    "thunderphone": {
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_YOUR_API_KEY"
      }
    }
  }
}

可用工具

工具引數功能
list_agents無列出組織智慧體，包含 id、名稱、產品和語音。
get_agentagent_id擷取單一智慧體。
place_callagent_id、from_number、to_number以與 REST 通話端點相同的驗證及計費檢核機制撥出電話。
get_callcall_id擷取通話狀態、摘要和評分。
list_calls選填 limit（1–100）、選填 status列出最近的通話。
get_call_transcriptcall_id擷取通話的完整逐字稿。

所有工具的範圍皆限定於與 API 金鑰綁定的組織。來自其他組織的 id 會被視為不可用。

通訊協定方法

此端點實作可串流 HTTP 用戶端所需的 MCP JSON-RPC 方法：

  • initialize
  • notifications/initialized
  • tools/list
  • tools/call

你可以直接查看工具目錄：

curl -X POST https://api.thunderphone.com/v1/mcp \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

使用工具名稱和引數呼叫工具：

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list_calls",
    "arguments": { "limit": 20, "status": "completed" }
  }
}

工具結果為 MCP 文字內容項目。工具失敗會在結果中以 isError: true 傳回；未知的 JSON-RPC 方法會傳回通訊協定錯誤。

安全地撥打電話

place_call 遵循與 POST /v1/call相同的規則：智慧體和號碼必須屬於該金鑰的組織、號碼必須符合撥出電話資格、組織必須有足夠餘額，且任何適用的撥出電話確認程序都必須完成。

將可存取 place_call 的用戶端視為正式環境的撥號端。限制可使用該用戶端的人員，在其提示中清楚說明預定使用的智慧體和號碼，並在通話紀錄中檢視通話。

完整通訊參考

請參閱 MCP 伺服器 API，瞭解回應範例、JSON-RPC 錯誤及遠端伺服器管理 API。