Sviluppa con Claude Code, Codex o Cursor

Installa le Agent Skills di ThunderPhone, collega il server MCP di ThunderPhone e fornisci a un agente di coding la documentazione aggiornata del prodotto.

ThunderPhone offre tre livelli per gli agenti di programmazione:

Le Skills spiegano come svolgere il lavoro. MCP consente all'agente di programmazione di ispezionare e operare sulla tua organizzazione. La documentazione grezza fornisce il materiale di origine per le domande che non rientrano in una Skill caricata.

Installa in un progetto#

Questo blocco installa le Skills, rende la chiave disponibile nella shell corrente e aggiunge il server MCP con ambito progetto a Claude Code. Sostituisci il segnaposto leggendo il valore reale dal tuo gestore di segreti; non incollare una chiave in un repository o in una chat.

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

Per Codex, sostituisci il comando finale con:

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

Cursor legge una configurazione di progetto da .cursor/mcp.json:

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

VS Code usa lo stesso server sotto una chiave servers in .vscode/mcp.json:

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

Esempio di sessione: receptionist dentale bilingue#

1. Chiedi all'agente di coding di caricare create-agent, thunderphone-prompt-builder, build-tool-integration, add-knowledge e test-agent. Digli di pianificare prima e di non creare ancora risorse.
2. Forniscigli dati verificati sullo studio, attività supportate, regole di escalation e le due lingue richieste. Fagli controllare il catalogo vocale attivo e le lingue supportate invece di inventare una voce o una lingua.
3. Chiedi un unico prompt di produzione basato su principi generali e dati concreti. L' agente deve passare alla lingua supportata del chiamante, mantenere il parlato conciso, porre una domanda alla volta ed evitare copioni di risposta del chiamante.
4. Fagli definire uno strumento di prenotazione circoscritto e collegare solo la knowledge di cui la receptionist ha bisogno. Testa l'esito positivo dello strumento, l'assenza di disponibilità, l'input non valido, il timeout e il passaggio a un operatore prima della distribuzione.
5. Genera scenari per entrambe le lingue, interruzioni, correzioni, informazioni mancanti, domande sulla knowledge, errori di prenotazione ed escalation. Eseguili, esamina le trascrizioni e le prove degli strumenti, correggi la regola generale più piccola e riesegui lo stesso set.
6. Esamina la bozza esatta e le prove dei test, quindi autorizza esplicitamente la distribuzione e l'associazione del numero. Effettua una chiamata audio controllata in ogni lingua prima di instradare traffico reale.

Usa l'SDK Python o TypeScript per richieste REST tipizzate.

Usa REST invece di MCP quando una build richiede payload deterministici, fixture con versione, orchestrazione in blocco o un'operazione non presente nell'attuale elenco di strumenti MCP. L'API inizia da https://api.thunderphone.com/v1; consulta l' introduzione all'API e la guida MCP.