ThunderPhone 2.0 уже доступен.Самостоятельный запуск — от 2 ¢/мин.Читать анонс
Начать работу

Getting Started

View as Markdown
Open in
ClaudeChatGPTCursor

Разрабатывайте с Claude Code, Codex или Cursor

Установите навыки агента ThunderPhone, подключите MCP-сервер ThunderPhone и предоставьте агенту для разработки актуальную документацию по продукту.

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

УровеньЧто он даёт агенту
Навыки агентовСпециализированные процедуры для агентов, промптов, номеров, звонков, инструментов, вебхуков, базы знаний, тестирования, кампаний, виджетов, фреймворков реального времени и миграций.
MCPАутентифицированные инструменты охватывают агентов, номера, звонки, тестирование, базу знаний, инструменты/вебхуки, кампании, голоса, импорты и документацию по мере их появления; вызовите tools/list, чтобы получить актуальный каталог.
Исходная документацияАктуальные исходники Markdown с описанием поведения продукта и деталями API.

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

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

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

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 замените последнюю команду на:

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

Cursor читает конфигурацию проекта из .cursor/mcp.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:

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

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

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

Используйте SDK для Python или TypeScript для типизированных REST-запросов.

Используйте REST вместо MCP, если для сборки нужны детерминированные полезные нагрузки, версионируемые фикстуры, массовая оркестрация или операция, которой нет в текущем списке инструментов MCP. API доступен по адресу https://api.thunderphone.com/v1; см. введение в API и руководство по MCP.