> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

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

```text theme={null}
https://api.thunderphone.com/v1/mcp
```

Укажіть цей кінцевий пункт потокового HTTP для MCP-клієнта, щоб зробити агентів і виклики вашої організації доступними як інструменти. Це напрямок, протилежний [підключенню віддаленого MCP-сервера до голосового агента](/uk/guides/mcp-servers):

| Напрямок                                   | Результат                                                                      |
| ------------------------------------------ | ------------------------------------------------------------------------------ |
| Віддалений MCP-сервер → агент ThunderPhone | Ваш голосовий агент може викликати інструменти віддаленого сервера.            |
| ThunderPhone → ваш MCP-клієнт              | Ваш MCP-клієнт може викликати інструменти ThunderPhone для агентів і викликів. |

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

Створіть ключ `sk_live_` у розділі **Організація → Ключі** та надішліть його як токен Bearer. Кінцевий пункт MCP приймає API-ключі організації, а не файли cookie сеансу панелі керування чи публічні ключі віджета.

```json Generic client configuration theme={null}
{
  "mcpServers": {
    "thunderphone": {
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_YOUR_API_KEY"
      }
    }
  }
}
```

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

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

| Інструмент            | Аргументи                                               | Призначення                                                                                                      |
| --------------------- | ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| `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`

Ви можете переглянути каталог інструментів безпосередньо:

```bash theme={null}
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": {}
  }'
```

Викличте інструмент, указавши його назву й аргументи:

```json theme={null}
{
  "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`](/api-reference/outbound-calls): агент і номер мають
належати організації, пов’язаній із ключем, номер має бути придатним для
вихідних викликів, організація повинна мати достатній баланс, а всі застосовні
підтвердження вихідних викликів мають бути завершені.

Вважайте клієнт із доступом до `place_call` продакшн-клієнтом для здійснення викликів. Обмежте коло користувачів клієнта, чітко зазначайте потрібного агента та номер у його власному промпті й перевіряйте виклики в Історії викликів.

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

Перегляньте [API MCP-серверів](/api-reference/mcp-servers#thunderphone-as-an-mcp-server), щоб знайти приклади відповідей, помилки JSON-RPC та API керування віддаленими серверами.