ThunderPhone als MCP-Server verwenden

ThunderPhone stellt einen Model Context Protocol-Server bereit unter:

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:

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.

Generic client configuration

{
  "mcpServers": {
    "thunderphone": {
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_YOUR_API_KEY"
      }
    }
  }
}

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.

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:

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:

{
  "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: 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 finden Sie Antwortbeispiele, JSON-RPC-Fehler und die API zur Verwaltung von Remote-Servern.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Compliance

Developer cookbook

Operations

ThunderPhone als MCP-Server verwenden

Authentifizieren

Verfügbare Tools

Protokollmethoden

Anrufe sicher tätigen

Vollständige Wire-Referenz

​Authentifizieren

​Verfügbare Tools

​Protokollmethoden

​Anrufe sicher tätigen

​Vollständige Wire-Referenz

Authentifizieren

Verfügbare Tools

Protokollmethoden

Anrufe sicher tätigen

Vollständige Wire-Referenz