ThunderPhone 2.0 уже доступний.Самостійне підключення — від 2 центів за хвилину.Прочитати анонс
Почати роботу

Connect tools & data

Використовуйте ThunderPhone як MCP-сервер

Підключіть будь-який клієнт Streamable HTTP MCP до ThunderPhone, щоб переглядати список агентів, перевіряти дзвінки й транскрипти та здійснювати вихідні дзвінки за допомогою API-ключа організації.

ThunderPhone надає сервер Model Context Protocol за адресою:

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

Укажіть цей кінцевий пункт потокового HTTP для MCP-клієнта, щоб зробити агентів і виклики вашої організації доступними як інструменти. Це напрямок, протилежний підключенню віддаленого 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немаєПовертає список агентів організації з ідентифікатором, назвою, продуктом і голосом.
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-ключем. Ідентифікатор з іншої організації вважається недоступним.

Методи протоколу

Кінцевий пункт реалізує методи MCP JSON-RPC, потрібні для клієнтів потокового HTTP:

  • 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 продакшн-клієнтом для здійснення викликів. Обмежте коло користувачів клієнта, чітко зазначайте потрібного агента та номер у його власному промпті й перевіряйте виклики в Історії викликів.

Повний довідник обміну даними

Перегляньте API MCP-серверів, щоб знайти приклади відповідей, помилки JSON-RPC та API керування віддаленими серверами.