ThunderPhone 2.0 je tady.Začnete bez obchodníka, od 2 ¢/min.Přečíst oznámení
Začít

Connect tools & data

Použijte ThunderPhone jako server MCP

Připojte libovolného klienta Streamable HTTP MCP k ThunderPhone a pomocí organizačního klíče API vypisujte agenty, kontrolujte hovory a přepisy a uskutečňujte odchozí hovory.

ThunderPhone zpřístupňuje server Model Context Protocol na adrese:

https://api.thunderphone.com/v1/mcp

Nasměrujte klienta MCP na tento koncový bod Streamable HTTP, aby byli agenti a hovory vaší organizace dostupné jako nástroje. Jde o opačný směr než při připojení vzdáleného serveru MCP k hlasovému agentovi:

SměrVýsledek
Vzdálený server MCP → agent ThunderPhoneVáš hlasový agent může volat nástroje vzdáleného serveru.
ThunderPhone → váš klient MCPVáš klient MCP může volat nástroje ThunderPhone pro agenty a hovory.

Ověření

Vytvořte klíč sk_live_ v nabídce Organizace → Klíče a odešlete jej jako token Bearer. Koncový bod MCP přijímá klíče API organizace, nikoli soubory cookie relace dashboardu ani publikovatelné klíče widgetů.

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

Dostupné nástroje

NástrojArgumentyCo dělá
list_agentsžádnéVypíše agenty organizace včetně id, názvu, produktu a hlasu.
get_agentagent_idNačte jednoho agenta.
place_callagent_id, from_number, to_numberUskuteční odchozí hovor se stejnými kontrolami ověření a fakturace jako koncový bod REST pro hovory.
get_callcall_idNačte stav hovoru, shrnutí a hodnocení.
list_callsvolitelný limit (1–100), volitelný statusVypíše nedávné hovory.
get_call_transcriptcall_idNačte kompletní přepis hovoru.

Všechny nástroje jsou omezeny na organizaci přiřazenou ke klíči API. Id z jiné organizace se chová jako nedostupné.

Metody protokolu

Koncový bod implementuje metody MCP JSON-RPC potřebné pro klienty Streamable HTTP:

  • initialize
  • notifications/initialized
  • tools/list
  • tools/call

Katalog nástrojů můžete zkontrolovat přímo:

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": {}
  }'

Zavolejte nástroj pomocí jeho názvu a argumentů:

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

Výsledky nástrojů jsou položky textového obsahu MCP. Selhání nástrojů se vracejí ve výsledku s isError: true; neznámé metody JSON-RPC vracejí chybu protokolu.

Bezpečné uskutečňování hovorů

place_call se řídí stejnými pravidly jako POST /v1/call: agent a číslo musí patřit organizaci klíče, číslo musí být způsobilé pro odchozí volání, organizace musí mít dostatečný zůstatek a veškeré platné potvrzení odchozího volání musí být dokončeno.

S klientem s přístupem k place_call zacházejte jako s produkčním volajícím. Omezte, kdo může klienta používat, v jeho vlastním promptu jasně uveďte zamýšleného agenta a číslo, a hovory kontrolujte v Historii hovorů.

Kompletní referenční popis komunikace

Příklady odpovědí, chyby JSON-RPC a rozhraní API pro správu vzdálených serverů naleznete v dokumentaci MCP Servers API.