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

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

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

Використовуйте REST замість MCP, коли для створення потрібні детерміновані корисні навантаження, версіоновані
фікстури, масова оркестрація або операція, якої немає в поточному списку інструментів MCP. API починається за адресою `https://api.thunderphone.com/v1`; дивіться
[вступ до API](/api-reference/introduction) і
[посібник із MCP](/uk/guides/thunderphone-mcp-server).