Connect tools & data

ThunderPhoneをMCPサーバーとして使用する

任意のStreamable HTTP MCPクライアントをThunderPhoneに接続し、組織のAPIキーを使用してエージェントの一覧表示、通話と文字起こしの確認、発信を行います。

ThunderPhone は、次の場所で Model Context Protocol サーバーを公開しています。

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

MCP クライアントをこの Streamable HTTP エンドポイントに接続すると、組織の エージェントと通話をツールとして利用できます。これは、 リモート MCP サーバーを音声エージェントに接続する場合とは逆方向です。

認証#

組織 → キー で sk_live_ キーを作成し、Bearer トークンとして送信します。 MCP エンドポイントは組織 API キーを受け付けます。ダッシュボードのセッション Cookie や公開可能なウィジェットキーは使用できません。

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

利用可能なツール#

すべてのツールは、API キーに紐付く組織のスコープ内で動作します。別の組織の ID は 利用できないものとして扱われます。

プロトコルメソッド#

このエンドポイントは、Streamable 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 にアクセスできるクライアントは、本番環境の発信者として扱ってください。 クライアントを使用できるユーザーを制限し、想定するエージェントと番号をクライアント自身の プロンプトで明確にし、通話履歴で通話を確認してください。

完全なワイヤーリファレンス#

レスポンス例、JSON-RPC エラー、リモートサーバー管理 API については、 MCP Servers APIを参照してください。