---
title: "Mit Claude Code, Codex oder Cursor entwickeln"
description: "Installieren Sie ThunderPhone Agent Skills, verbinden Sie den ThunderPhone MCP-Server und stellen Sie einem Coding-Agenten aktuelle Produktdokumentation bereit."
---

ThunderPhone bietet drei Ebenen für Coding-Agenten:

| Ebene | Was sie dem Agenten bietet |
| --- | --- |
| [Agent Skills](https://github.com/thunderphone/skills) | Zielgerichtete Verfahren für Agenten, Prompts, Nummern, Anrufe, Tools, Webhooks, Wissen, Tests, Kampagnen, Widgets, Echtzeit-Frameworks und Migrationen. |
| MCP | Authentifizierte Tools decken Agenten, Nummern, Anrufe, Tests, Wissen, Tools/Webhooks, Kampagnen, Stimmen, Importe und Docs ab, sobald sie verfügbar sind; rufen Sie `tools/list` für den aktuellen Katalog auf. |
| [Rohdokumentation](https://thunderphone.com/docs/llms.txt) | Aktuelle Markdown-Quellen für Produktverhalten und API-Details. |

Skills erklären, wie die Arbeit erledigt wird. MCP ermöglicht dem Coding-Agenten, Ihre Organisation zu prüfen und Aktionen auszuführen. Rohdokumentationen liefern das Quellmaterial für Fragen außerhalb eines geladenen Skills.

## In einem Projekt installieren

Dieser Block installiert die Skills, stellt den Schlüssel für die aktuelle Shell bereit
und fügt den projektbezogenen MCP-Server zu Claude Code hinzu. Ersetzen Sie den Platzhalter,
indem Sie den tatsächlichen Wert aus Ihrem Secret Manager lesen; fügen Sie keinen Schlüssel in
ein Repository oder einen Chat ein.

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

Ersetzen Sie für Codex den letzten Befehl durch:

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

Cursor liest eine Projektkonfiguration aus `.cursor/mcp.json`:

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

VS Code verwendet denselben Server unter einem `servers`-Schlüssel in `.vscode/mcp.json`:

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

<Warning>
  Ein Organisations-API-Schlüssel kann Organisationsdaten lesen und aktivierte
  Aktionen ausführen. Bewahren Sie ihn in einem Secret Manager auf, beschränken Sie den Zugriff auf das vorgesehene Projekt,
  und prüfen Sie Tools-Aufrufe mit Änderungen vor der Genehmigung.
</Warning>

## Beispielsitzung: zweisprachige Dentalrezeption

1. Bitten Sie den Coding-Agenten, `create-agent`,
   `thunderphone-prompt-builder`, `build-tool-integration`, `add-knowledge` und
   `test-agent` zu laden. Weisen Sie ihn an, zunächst zu planen und noch keine Ressourcen zu erstellen.
2. Geben Sie ihm verifizierte Praxisdaten, unterstützte Aufgaben, Eskalationsregeln und die
   zwei erforderlichen Gebietsschemata. Lassen Sie ihn den aktuellen Sprachkatalog und die unterstützten
   Sprachen prüfen, statt eine Stimme oder ein Gebietsschema zu erfinden.
3. Fordern Sie einen produktiven Prompt an, der auf allgemeinen Grundsätzen und Fakten basiert. Der
   Agent sollte zur unterstützten Sprache des Anrufers wechseln, die Sprache knapp halten,
   jeweils nur eine Frage stellen und Skripte für Anruferantworten vermeiden.
4. Lassen Sie ihn ein eng abgegrenztes Planungstool definieren und nur das Wissen anhängen, das die
   Rezeption benötigt. Testen Sie Tool-Erfolg, fehlende Verfügbarkeit, ungültige Eingaben,
   Zeitüberschreitung und Übergabe an einen Menschen vor der Bereitstellung.
5. Generieren Sie Szenarien für beide Sprachen, Unterbrechungen, Korrekturen, fehlende
   Informationen, Wissensfragen, Planungsfehler und Eskalationen. Führen Sie sie aus, prüfen Sie Transkripte
   und Tool-Nachweise, korrigieren Sie die kleinste allgemeine Regel und führen Sie dieselbe Gruppe erneut aus.
6. Prüfen Sie den genauen Entwurf und die Testnachweise und autorisieren Sie dann ausdrücklich die Bereitstellung
   und die Nummernzuweisung. Führen Sie in jeder Sprache einen kontrollierten Audioanruf durch, bevor Sie
   echten Datenverkehr umleiten.

Verwenden Sie das [Python- oder TypeScript-SDK](/api-reference/sdks) für typisierte REST-Anfragen.

Verwenden Sie REST statt MCP, wenn ein Build deterministische Payloads, versionierte
Fixtures, Massenorchestrierung oder einen Vorgang benötigt, der nicht in der aktuellen MCP-
Toolliste vorhanden ist. Die API beginnt unter `https://api.thunderphone.com/v1`; siehe die
[API-Einführung](/api-reference/introduction) und den
[MCP-Leitfaden](/de/guides/thunderphone-mcp-server).