> ## 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
```

Укажите этот конечный Streamable HTTP в MCP-клиенте, чтобы агенты и звонки вашей организации стали доступны как инструменты. Это направление противоположно [подключению удалённого MCP-сервера к голосовому агенту](/ru/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`         | нет                                                     | Выводит список агентов организации с 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`

Вы можете просмотреть каталог инструментов напрямую:

```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 управления удалёнными серверами.