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

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

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

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

Інструмент	Аргументи	Призначення
`list_agents`	немає	Повертає список агентів організації з ідентифікатором, назвою, продуктом і голосом.
`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, потрібні для клієнтів потокового 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-сервер

Автентифікація

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

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

Безпечне здійснення викликів

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

​Автентифікація

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

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

​Безпечне здійснення викликів

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

Автентифікація

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

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

Безпечне здійснення викликів

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