ThunderPhone 2.0 уже доступний.Підключайте самостійно — від 2 ¢/хв.Прочитати анонс
Почати роботу

Getting Started

View as Markdown
Open in
ClaudeChatGPTCursor

Розробляйте з Claude Code, Codex або Cursor

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

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. Перегляньте точну чернетку та результати тестування, після чого явно схваліть розгортання й підключення номера. Здійсніть контрольний аудіодзвінок кожною мовою, перш ніж переводити реальний трафік.

Використовуйте Python або TypeScript SDK для типізованих REST-запитів.

Використовуйте REST замість MCP, коли для створення потрібні детерміновані корисні навантаження, версіоновані фікстури, масова оркестрація або операція, якої немає в поточному списку інструментів MCP. API починається за адресою https://api.thunderphone.com/v1; дивіться вступ до API і посібник із MCP.