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

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

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