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

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"
      }
    }
  }
}

Ключ sk_live_ может получать доступ к данным организации и совершать звонки. Не размещайте его в коде браузера, репозиториях, снимках экрана и журналах чата. Используйте хранилище секретов, поддерживаемое вашим MCP-клиентом, и немедленно отзовите ключ в случае раскрытия.

Доступные инструменты

Инструмент	Аргументы	Назначение
`list_agents`	нет	Выводит список агентов организации с id, именем, продуктом и голосом.
`get_agent`	`agent_id`	Получает одного агента.
`place_call`	`agent_id`, `from_number`, `to_number`	Совершает исходящий звонок с такой же проверкой и условиями тарификации, как у конечной точки REST-звонков.
`get_call`	`call_id`	Получает статус, сводку и оценку звонка.
`list_calls`	необязательный `limit` (1–100), необязательный `status`	Выводит список недавних звонков.
`get_call_transcript`	`call_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 управления удалёнными серверами.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Compliance

Developer cookbook

Operations

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

Аутентификация

Доступные инструменты

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

Безопасное совершение звонков

Полная справка по протоколу

​Аутентификация

​Доступные инструменты

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

​Безопасное совершение звонков

​Полная справка по протоколу

Аутентификация

Доступные инструменты

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

Безопасное совершение звонков

Полная справка по протоколу