Bouw met Claude Code, Codex of Cursor

Installeer ThunderPhone Agent Skills, verbind de ThunderPhone MCP-server en geef een programmeeragent actuele productdocumentatie.

ThunderPhone biedt drie lagen voor codeeragents:

Vaardigheden leggen uit hoe je het werk uitvoert. Met MCP kan de codeeragent je organisatie inspecteren en acties uitvoeren. Ruwe documentatie biedt het bronmateriaal voor vragen buiten een geladen vaardigheid.

Installeren in een project#

Dit blok installeert de vaardigheden, maakt de sleutel beschikbaar voor de huidige shell en voegt de projectgebonden MCP-server toe aan Claude Code. Vervang de tijdelijke aanduiding door de werkelijke waarde uit je geheimenbeheerder te lezen; plak geen sleutel in een repository of 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

Vervang voor Codex de laatste opdracht door:

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

Cursor leest een projectconfiguratie uit .cursor/mcp.json:

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

VS Code gebruikt dezelfde server onder een servers-sleutel in .vscode/mcp.json:

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

Voorbeeldsessie: tweetalige tandartsreceptionist#

1. Vraag de programmeeragent om create-agent, thunderphone-prompt-builder, build-tool-integration, add-knowledge en test-agent te laden. Zeg dat deze eerst moet plannen en nog geen resources moet maken.
2. Geef geverifieerde praktijkgegevens, ondersteunde taken, escalatieregels en de twee vereiste talen. Laat deze de actuele stemcatalogus en ondersteunde talen controleren in plaats van een stem of taal te verzinnen.
3. Vraag om één productieprompt op basis van algemene principes en feiten. De agent moet overschakelen naar de ondersteunde taal van de beller, spraak beknopt houden, steeds één vraag tegelijk stellen en scripts voor bellerreacties vermijden.
4. Laat deze een afgebakende planningstool definiëren en alleen de kennis koppelen die de receptionist nodig heeft. Test een geslaagde toolaanroep, geen beschikbaarheid, ongeldige invoer, time-out en overdracht naar een medewerker vóór implementatie.
5. Genereer scenario's voor beide talen, onderbrekingen, correcties, ontbrekende informatie, kennisvragen, planningsfouten en escalatie. Voer ze uit, controleer transcripties en toolbewijs, herstel de kleinste algemene regel en voer dezelfde set opnieuw uit.
6. Controleer het exacte concept en het testbewijs, en geef vervolgens expliciet toestemming voor implementatie en nummerkoppeling. Plaats vóór het doorschakelen van echt verkeer een gecontroleerde audiogesprek in elke taal.

Gebruik de Python- of TypeScript-SDK voor getypeerde REST-aanvragen.

Gebruik REST in plaats van MCP wanneer een build deterministische payloads, geversioneerde fixtures, bulkorkestratie of een bewerking nodig heeft die niet in de huidige MCP-toolijst staat. De API begint bij https://api.thunderphone.com/v1; zie de API-introductie en MCP-handleiding.