Použijte ThunderPhone jako server MCP

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ěr	Výsledek
Vzdálený server MCP → agent ThunderPhone	Váš hlasový agent může volat nástroje vzdáleného serveru.
ThunderPhone → váš klient MCP	Váš 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"
      }
    }
  }
}

Klíč sk_live_ může přistupovat k datům organizace a uskutečňovat hovory. Neuchovávejte jej v kódu prohlížeče, repozitářích, snímcích obrazovky ani protokolech chatu. Použijte úložiště tajných údajů podporované vaším klientem MCP a při zveřejnění klíč okamžitě zrušte.

Dostupné nástroje

Nástroj	Argumenty	Co dělá
`list_agents`	žádné	Vypíše agenty organizace včetně id, názvu, produktu a hlasu.
`get_agent`	`agent_id`	Načte jednoho agenta.
`place_call`	`agent_id`, `from_number`, `to_number`	Uskuteční odchozí hovor se stejnými kontrolami ověření a fakturace jako koncový bod REST pro hovory.
`get_call`	`call_id`	Načte stav hovoru, shrnutí a hodnocení.
`list_calls`	volitelný `limit` (1–100), volitelný `status`	Vypíše nedávné hovory.
`get_call_transcript`	`call_id`	Nač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.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Compliance

Developer cookbook

Operations

Použijte ThunderPhone jako server MCP

Ověření

Dostupné nástroje

Metody protokolu

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

Kompletní referenční popis komunikace

​Ověření

​Dostupné nástroje

​Metody protokolu

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

​Kompletní referenční popis komunikace

Ověření

Dostupné nástroje

Metody protokolu

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

Kompletní referenční popis komunikace