---
title: "Разрабатывайте с Claude Code, Codex или Cursor"
description: "Установите навыки агента ThunderPhone, подключите MCP-сервер ThunderPhone и предоставьте агенту для разработки актуальную документацию по продукту."
---

ThunderPhone предоставляет три уровня для агентов программирования:

| Уровень | Что он даёт агенту |
| --- | --- |
| [Навыки агентов](https://github.com/thunderphone/skills) | Специализированные процедуры для агентов, промптов, номеров, звонков, инструментов, вебхуков, базы знаний, тестирования, кампаний, виджетов, фреймворков реального времени и миграций. |
| MCP | Аутентифицированные инструменты охватывают агентов, номера, звонки, тестирование, базу знаний, инструменты/вебхуки, кампании, голоса, импорты и документацию по мере их появления; вызовите `tools/list`, чтобы получить актуальный каталог. |
| [Исходная документация](https://thunderphone.com/docs/llms.txt) | Актуальные исходники Markdown с описанием поведения продукта и деталями API. |

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

## Установка в проекте

Этот блок устанавливает навыки, делает ключ доступным в текущей оболочке
и добавляет MCP-сервер для проекта в Claude Code. Замените заполнитель,
получив реальное значение из менеджера секретов; не вставляйте ключ в
репозиторий или чат.

```bash
npx skills add thunderphone/skills
export THUNDERPHONE_API_KEY='replace-with-value-from-your-secret-manager'
claude mcp add --transport http --scope project \
  --header 'Authorization: Bearer ${THUNDERPHONE_API_KEY}' \
  thunderphone https://api.thunderphone.com/v1/mcp
```

Для Codex замените последнюю команду на:

```bash
codex mcp add thunderphone \
  --url https://api.thunderphone.com/v1/mcp \
  --bearer-token-env-var THUNDERPHONE_API_KEY
```

Cursor читает конфигурацию проекта из `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "thunderphone": {
      "type": "http",
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
      }
    }
  }
}
```

VS Code использует тот же сервер под ключом `servers` в `.vscode/mcp.json`:

```json
{
  "servers": {
    "thunderphone": {
      "type": "http",
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
      }
    }
  }
}
```

<Warning>
  API-ключ организации может читать данные организации и выполнять включённые
  действия. Храните его в менеджере секретов, ограничьте доступ нужным проектом
  и проверяйте вызовы инструментов, изменяющие данные, перед подтверждением.
</Warning>

## Пример сессии: двуязычный администратор стоматологической клиники

1. Попросите агента для написания кода загрузить `create-agent`,
   `thunderphone-prompt-builder`, `build-tool-integration`, `add-knowledge` и
   `test-agent`. Укажите ему сначала составить план и пока не создавать ресурсы.
2. Передайте ему проверенные сведения о клинике, поддерживаемые задачи, правила эскалации и
   две необходимые локали. Попросите проверить актуальный каталог голосов и поддерживаемые
   языки, а не придумывать голос или локаль.
3. Попросите создать один промпт для продакшена на основе общих принципов и фактов. Голосовой
   агент должен переключаться на поддерживаемый язык звонящего, говорить кратко,
   задавать по одному вопросу и не использовать сценарии ответов звонящего.
4. Попросите определить узкий инструмент для записи и прикрепить только те знания, которые
   нужны администратору. Перед деплоем протестируйте успешную работу инструмента, отсутствие
   доступного времени, недопустимый ввод, тайм-аут и передачу человеку.
5. Создайте сценарии для обоих языков, прерываний, исправлений, отсутствующих
   сведений, вопросов по знаниям, сбоев записи и эскалации. Запустите их, проверьте
   расшифровки и данные работы инструмента, исправьте минимальное общее правило
   и повторно запустите тот же набор.
6. Проверьте точный черновик и результаты тестов, затем явно разрешите деплой
   и привязку номера. Выполните контролируемый аудиозвонок на каждом языке, прежде чем
   переводить реальный трафик.

Используйте [SDK для Python или TypeScript](/api-reference/sdks) для типизированных REST-запросов.

Используйте REST вместо MCP, если для сборки нужны детерминированные полезные нагрузки, версионируемые
фикстуры, массовая оркестрация или операция, которой нет в текущем списке инструментов MCP.
API доступен по адресу `https://api.thunderphone.com/v1`; см.
[введение в API](/api-reference/introduction) и
[руководство по MCP](/ru/guides/thunderphone-mcp-server).