ThunderPhone 2.0 уже доступен.Самостоятельное подключение — от 2 центов/мин.Читать анонс
Начать работу

Connect tools & data

Используйте ThunderPhone как MCP-сервер

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

ThunderPhone предоставляет сервер Model Context Protocol по адресу:

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

Укажите этот конечный Streamable 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нетВыводит список агентов организации с 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-ключом. Идентификатор из другой организации считается недоступным.

Методы протокола

Конечная точка реализует методы MCP JSON-RPC, необходимые для клиентов Streamable 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 управления удалёнными серверами.