Používajte ThunderPhone ako server MCP

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

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

Nastavte klienta MCP na tento koncový bod Streamable HTTP, aby boli agenti a hovory vašej organizácie dostupné ako nástroje. Ide o opačný smer než pri pripojení vzdialeného servera MCP k hlasovému agentovi:

Smer	Výsledok
Vzdialený server MCP → agent ThunderPhone	Váš hlasový agent môže volať nástroje vzdialeného servera.
ThunderPhone → váš klient MCP	Váš klient MCP môže volať nástroje ThunderPhone pre agentov a hovory.

Overenie identity

Vytvorte kľúč sk_live_ v časti Organizácia → Kľúče a odošlite ho ako token Bearer. Koncový bod MCP prijíma kľúče API organizácie, nie súbory cookie relácie panela ani publikovateľné kľúče widgetov.

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

Dostupné nástroje

Nástroj	Argumenty	Funkcia
`list_agents`	žiadne	Vypíše agentov organizácie s identifikátorom, názvom, produktom a hlasom.
`get_agent`	`agent_id`	Načíta jedného agenta.
`place_call`	`agent_id`, `from_number`, `to_number`	Uskutoční odchádzajúci hovor s rovnakými kontrolami overenia a fakturácie ako koncový bod REST pre hovory.
`get_call`	`call_id`	Načíta stav hovoru, súhrn a hodnotenie.
`list_calls`	voliteľné `limit` (1–100), voliteľné `status`	Vypíše nedávne hovory.
`get_call_transcript`	`call_id`	Načíta úplný prepis hovoru.

Všetky nástroje sú obmedzené na organizáciu priradenú ku kľúču API. Identifikátor z inej organizácie sa správa ako nedostupný.

Metódy protokolu

Koncový bod implementuje metódy MCP JSON-RPC potrebné pre klientov Streamable HTTP:

initialize
notifications/initialized
tools/list
tools/call

Katalóg nástrojov môžete skontrolovať priamo:

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

Zavolajte nástroj pomocou jeho názvu a argumentov:

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

Výsledky nástrojov sú položky textového obsahu MCP. Zlyhania nástrojov sa vracajú vo výsledku s isError: true; neznáme metódy JSON-RPC vracajú chybu protokolu.

Bezpečné uskutočňovanie hovorov

place_call sa riadi rovnakými pravidlami ako POST /v1/call: agent a číslo musia patriť organizácii kľúča, číslo musí byť oprávnené na odchádzajúce hovory, organizácia musí mať dostatočný zostatok a každé príslušné potvrdenie odchádzajúcich hovorov musí byť dokončené.

S klientom s prístupom k place_call zaobchádzajte ako s produkčným volajúcim. Obmedzte, kto môže klienta používať, jasne uveďte zamýšľaného agenta a číslo v jeho vlastnej výzve a hovory kontrolujte v História hovorov.

Úplná referenčná dokumentácia prenosu

Príklady odpovedí, chyby JSON-RPC a API na správu vzdialených serverov nájdete v dokumentácii API serverov MCP.