> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ThunderPhone als MCP-Server verwenden

> Verbinden Sie einen beliebigen Streamable-HTTP-MCP-Client mit ThunderPhone, um Agenten aufzulisten, Anrufe und Transkripte zu prüfen und mit einem Organisations-API-Schlüssel ausgehende Anrufe zu tätigen.

ThunderPhone stellt einen Model Context Protocol-Server bereit unter:

```text theme={null}
https://api.thunderphone.com/v1/mcp
```

Konfigurieren Sie einen MCP-Client für diesen Streamable-HTTP-Endpunkt, um die
Agenten und Anrufe Ihrer Organisation als Tools verfügbar zu machen. Dies ist die entgegengesetzte Richtung zu
[einem Sprachagenten mit einem Remote-MCP-Server verbinden](/de/guides/mcp-servers):

| Richtung                               | Ergebnis                                                                |
| -------------------------------------- | ----------------------------------------------------------------------- |
| Remote-MCP-Server → ThunderPhone-Agent | Ihr Sprachagent kann die Tools des Remote-Servers aufrufen.             |
| ThunderPhone → Ihr MCP-Client          | Ihr MCP-Client kann ThunderPhone-Tools für Agenten und Anrufe aufrufen. |

## Authentifizieren

Erstellen Sie unter **Organisation → Schlüssel** einen `sk_live_`-Schlüssel und senden Sie ihn als Bearer-Token. Der MCP-Endpunkt akzeptiert API-Schlüssel für Organisationen, keine Dashboard-Sitzungscookies oder veröffentlichbaren Widget-Schlüssel.

```json Generic client configuration theme={null}
{
  "mcpServers": {
    "thunderphone": {
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_YOUR_API_KEY"
      }
    }
  }
}
```

<Warning>
  Ein `sk_live_`-Schlüssel kann auf Organisationsdaten zugreifen und Anrufe tätigen. Halten Sie ihn aus
  Browsercode, Repositories, Screenshots und Chatprotokollen heraus. Verwenden Sie einen von Ihrem
  MCP-Client unterstützten Secret Store und widerrufen Sie einen Schlüssel sofort, falls er offengelegt wird.
</Warning>

## Verfügbare Tools

| Tool                  | Argumente                                   | Funktion                                                                                                        |
| --------------------- | ------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| `list_agents`         | keine                                       | Listet Agenten der Organisation mit ID, Name, Produkt und Stimme auf.                                           |
| `get_agent`           | `agent_id`                                  | Ruft einen Agenten ab.                                                                                          |
| `place_call`          | `agent_id`, `from_number`, `to_number`      | Tätigt einen ausgehenden Anruf mit denselben Validierungs- und Abrechnungsprüfungen wie der REST-Anrufendpunkt. |
| `get_call`            | `call_id`                                   | Ruft Anrufstatus, Zusammenfassung und Bewertung ab.                                                             |
| `list_calls`          | optional `limit` (1–100), optional `status` | Listet aktuelle Anrufe auf.                                                                                     |
| `get_call_transcript` | `call_id`                                   | Ruft das vollständige Transkript eines Anrufs ab.                                                               |

Alle Tools sind auf die mit dem API-Schlüssel verknüpfte Organisation beschränkt. Eine ID aus
einer anderen Organisation verhält sich wie nicht verfügbar.

## Protokollmethoden

Der Endpunkt implementiert die MCP-JSON-RPC-Methoden, die für Streamable-HTTP-
Clients erforderlich sind:

* `initialize`
* `notifications/initialized`
* `tools/list`
* `tools/call`

Sie können den Toolkatalog direkt prüfen:

```bash theme={null}
curl -X POST https://api.thunderphone.com/v1/mcp \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'
```

Rufen Sie ein Tool mit seinem Namen und seinen Argumenten auf:

```json theme={null}
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list_calls",
    "arguments": { "limit": 20, "status": "completed" }
  }
}
```

Tool-Ergebnisse sind MCP-Textinhaltselemente. Tool-Fehler werden im
Ergebnis mit `isError: true` zurückgegeben; unbekannte JSON-RPC-Methoden geben einen Protokollfehler zurück.

## Anrufe sicher tätigen

`place_call` folgt denselben Regeln wie
[`POST /v1/call`](/api-reference/outbound-calls): Der Agent und die Nummer müssen
zur Organisation des Schlüssels gehören, die Nummer muss für ausgehende
Anrufe geeignet sein, die Organisation muss über ausreichendes Guthaben verfügen und jede zutreffende
Bestätigung für ausgehende Anrufe muss abgeschlossen sein.

Behandeln Sie einen Client mit Zugriff auf `place_call` wie einen produktiven Anrufer. Beschränken Sie, wer
den Client verwenden kann, machen Sie den vorgesehenen Agenten und die Nummer in seinem eigenen Prompt deutlich
und prüfen Sie Anrufe im Anrufverlauf.

## Vollständige Wire-Referenz

Unter [MCP Servers API](/api-reference/mcp-servers#thunderphone-as-an-mcp-server)
finden Sie Antwortbeispiele, JSON-RPC-Fehler und die API zur Verwaltung von Remote-Servern.