---
title: "Vyvíjejte s Claude Code, Codex nebo Cursor"
description: "Nainstalujte dovednosti agenta ThunderPhone, připojte server ThunderPhone MCP a poskytněte programovacímu agentovi aktuální produktovou dokumentaci."
---

ThunderPhone poskytuje pro programovací agenty tři vrstvy:

| Vrstva | Co agentovi poskytuje |
| --- | --- |
| [Dovednosti agenta](https://github.com/thunderphone/skills) | Zaměřené postupy pro agenty, prompty, čísla, hovory, nástroje, webhooky, znalosti, testování, kampaně, widgety, realtime frameworky a migrace. |
| MCP | Autentizované nástroje pokrývají agenty, čísla, hovory, testování, znalosti, nástroje/webhooky, kampaně, hlasy, importy a dokumentaci podle toho, jak jsou zaváděny; aktuální katalog získáte voláním `tools/list`. |
| [Surová dokumentace](https://thunderphone.com/docs/llms.txt) | Aktuální zdroje v Markdownu pro chování produktu a podrobnosti API. |

Dovednosti vysvětlují, jak práci provést. MCP umožňuje programovacímu agentovi kontrolovat vaši organizaci a provádět v ní akce. Surová dokumentace poskytuje zdrojový materiál pro otázky mimo načtenou dovednost.

## Instalace do projektu

Tento blok nainstaluje dovednosti, zpřístupní klíč aktuálnímu shellu a přidá MCP server s rozsahem projektu do Claude Code. Zástupný text nahraďte načtením skutečné hodnoty ze správce tajemství; nevkládejte klíč do repozitáře ani chatu.

```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
```

Pro Codex nahraďte poslední příkaz tímto:

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

Cursor načítá konfiguraci projektu z `.cursor/mcp.json`:

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

VS Code používá stejný server pod klíčem `servers` v souboru `.vscode/mcp.json`:

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

<Warning>
  Klíč API organizace může číst data organizace a provádět povolené akce. Uchovávejte jej ve správci tajemství, omezte přístup na zamýšlený projekt a před schválením zkontrolujte volání nástrojů, která provádějí změny.
</Warning>

## Ukázková relace: dvojjazyčný zubní recepční

1. Požádejte programovacího agenta, aby načetl `create-agent`,
   `thunderphone-prompt-builder`, `build-tool-integration`, `add-knowledge` a
   `test-agent`. Řekněte mu, aby nejprve vytvořil plán a zatím nevytvářel žádné prostředky.
2. Poskytněte mu ověřené údaje o ordinaci, podporované úkoly, pravidla eskalace a
   dvě požadované národní verze. Nechte ho ověřit aktuální katalog hlasů a podporované
   jazyky namísto vymýšlení hlasu nebo národní verze.
3. Požádejte o jeden produkční prompt vytvořený na základě obecných principů a faktů.
   Agent by měl přepnout do podporovaného jazyka volajícího, mluvit stručně,
   pokládat vždy jednu otázku a vyhnout se scénářům odpovědí volajícího.
4. Nechte ho definovat úzce zaměřený nástroj pro plánování a připojit pouze znalosti,
   které recepční potřebuje. Před nasazením otestujte úspěšné použití nástroje, nedostupnost termínů,
   neplatný vstup, časový limit a předání člověku.
5. Vygenerujte scénáře pro oba jazyky, přerušení, opravy, chybějící
   informace, znalostní dotazy, selhání plánování a eskalaci. Spusťte je,
   zkontrolujte přepisy a důkazy z nástrojů, opravte nejmenší obecné pravidlo
   a znovu spusťte stejnou sadu.
6. Zkontrolujte přesný návrh a důkazy z testů, poté výslovně autorizujte nasazení
   a připojení čísla. Před převedením skutečného provozu uskutečněte kontrolovaný zvukový hovor
   v každém jazyce.

Pro typované požadavky REST použijte [Python nebo TypeScript SDK](/api-reference/sdks).

Pokud sestavení vyžaduje deterministické datové části, verzované
testovací sady, hromadnou orchestraci nebo operaci, která není v aktuálním seznamu nástrojů MCP,
použijte místo MCP REST. Rozhraní API začíná na `https://api.thunderphone.com/v1`; viz
[úvod k API](/api-reference/introduction) a
[průvodce MCP](/cs/guides/thunderphone-mcp-server).