---
title: "Construiți cu Claude Code, Codex sau Cursor"
description: "Instalați abilitățile agenților ThunderPhone, conectați serverul MCP ThunderPhone și oferiți unui agent de programare documentația actualizată a produsului."
---

ThunderPhone oferă trei niveluri pentru agenții de programare:

| Nivel | Ce oferă agentului |
| --- | --- |
| [Competențe pentru agenți](https://github.com/thunderphone/skills) | Proceduri specifice pentru agenți, prompturi, numere, apeluri, instrumente, webhookuri, cunoștințe, testare, campanii, widgeturi, cadre de lucru în timp real și migrări. |
| MCP | Instrumentele autentificate acoperă agenți, numere, apeluri, testare, cunoștințe, instrumente/webhookuri, campanii, voci, importuri și documentație pe măsură ce devin disponibile; apelați `tools/list` pentru catalogul actual. |
| [Documentație brută](https://thunderphone.com/docs/llms.txt) | Surse Markdown actuale pentru comportamentul produsului și detaliile API. |

Competențele explică modul de realizare a lucrului. MCP permite agentului de
programare să inspecteze și să acționeze asupra organizației dumneavoastră.
Documentația brută oferă materialul sursă pentru întrebări care nu sunt acoperite de
o competență încărcată.

## Instalați într-un proiect

Acest bloc instalează competențele, pune cheia la dispoziția shellului curent
și adaugă serverul MCP la nivel de proiect în Claude Code. Înlocuiți substituentul
citind valoarea reală din managerul dumneavoastră de secrete; nu lipiți o cheie într-un
depozit sau într-o conversație.

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

Pentru Codex, înlocuiți comanda finală cu:

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

Cursor citește o configurație de proiect din `.cursor/mcp.json`:

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

VS Code utilizează același server sub o cheie `servers` în `.vscode/mcp.json`:

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

<Warning>
  O cheie API de organizație poate citi datele organizației și poate efectua
  acțiunile activate. Păstrați-o într-un manager de secrete, limitați accesul la proiectul vizat
  și revizuiți apelurile de instrumente care modifică date înainte de aprobare.
</Warning>

## Sesiune exemplu: recepționer stomatologic bilingv

1. Cereți agentului de codare să încarce `create-agent`,
   `thunderphone-prompt-builder`, `build-tool-integration`, `add-knowledge` și
   `test-agent`. Spuneți-i să planifice mai întâi și să nu creeze încă resurse.
2. Oferiți-i informații verificate despre cabinet, sarcinile acceptate, regulile de escaladare și cele
   două setări regionale necesare. Cereți-i să verifice catalogul de voci disponibil și limbile acceptate, în loc să inventeze o voce sau o setare regională.
3. Cereți un singur prompt de producție construit pe baza principiilor generale și a informațiilor. Agentul
   trebuie să treacă la limba acceptată a apelantului, să păstreze răspunsurile concise,
   să adreseze câte o întrebare și să evite scripturile de tip întrebare-răspuns pentru apelant.
4. Cereți-i să definească un instrument restrâns pentru programări și să atașeze numai cunoștințele de care
   are nevoie recepționerul. Testați reușita instrumentului, lipsa disponibilității, datele de intrare nevalide,
   expirarea timpului și transferul către un om înainte de implementare.
5. Generați scenarii pentru ambele limbi, întreruperi, corecturi, informații lipsă,
   întrebări despre cunoștințe, eșecuri de programare și escaladare. Rulați-le, inspectați transcrierile și dovezile instrumentului, corectați cea mai restrânsă regulă generală,
   apoi rulați din nou același set.
6. Revizuiți versiunea exactă și dovezile de test, apoi autorizați explicit implementarea
   și atașarea numărului. Efectuați un apel audio controlat în fiecare limbă înainte de a direcționa traficul real.

Utilizați [SDK-ul Python sau TypeScript](/api-reference/sdks) pentru solicitări REST tipizate.

Utilizați REST în loc de MCP atunci când o implementare necesită încărcături utile deterministe, fixture-uri
versionate, orchestrare în masă sau o operațiune care nu este prezentă în lista actuală de instrumente MCP. API-ul începe la `https://api.thunderphone.com/v1`; consultați
[introducerea în API](/api-reference/introduction) și
[ghidul MCP](/ro/guides/thunderphone-mcp-server).