Uporabite ThunderPhone kot strežnik MCP

ThunderPhone izpostavlja strežnik Model Context Protocol na:

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

Usmerite odjemalca MCP na to končno točko Streamable HTTP, da omogočite agente in klice svoje organizacije kot orodja. To je nasprotna smer od povezovanja oddaljenega strežnika MCP z glasovnim agentom:

Smer	Rezultat
Oddaljeni strežnik MCP → agent ThunderPhone	Vaš glasovni agent lahko kliče orodja oddaljenega strežnika.
ThunderPhone → vaš odjemalec MCP	Vaš odjemalec MCP lahko kliče orodja ThunderPhone za agente in klice.

Preverjanje pristnosti

Ustvarite ključ sk_live_ v razdelku Organizacija → Ključi in ga pošljite kot žeton Bearer. Končna točka MCP sprejema ključe API organizacije, ne piškotkov seje nadzorne plošče ali ključev javno dostopnih pripomočkov.

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

Razpoložljiva orodja

Orodje	Argumenti	Kaj naredi
`list_agents`	brez	Navede agente organizacije z ID-jem, imenom, izdelkom in glasom.
`get_agent`	`agent_id`	Pridobi enega agenta.
`place_call`	`agent_id`, `from_number`, `to_number`	Vzpostavi odhodni klic z enakimi preverjanji veljavnosti in obračunskimi omejitvami kot končna točka REST za klice.
`get_call`	`call_id`	Pridobi stanje klica, povzetek in oceno.
`list_calls`	izbirni `limit` (1–100), izbirni `status`	Navede nedavne klice.
`get_call_transcript`	`call_id`	Pridobi celoten prepis klica.

Vsa orodja so omejena na organizacijo, povezano s ključem API. ID iz druge organizacije se obravnava kot nedostopen.

Metode protokola

Končna točka izvaja metode MCP JSON-RPC, potrebne za odjemalce Streamable HTTP:

initialize
notifications/initialized
tools/list
tools/call

Katalog orodij lahko pregledate neposredno:

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

Pokličite orodje z njegovim imenom in argumenti:

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

Rezultati orodij so elementi besedilne vsebine MCP. Napake orodij so vrnjene v rezultatu z isError: true; neznane metode JSON-RPC vrnejo napako protokola.

Varno vzpostavljanje klicev

place_call upošteva enaka pravila kot POST /v1/call: agent in številka morata pripadati organizaciji ključa, številka mora biti upravičena do odhodnih klicev, organizacija mora imeti zadostno dobroimetje in vsaka zahtevana potrditev odhodnih klicev mora biti dokončana.

Odjemalca z dostopom do place_call obravnavajte kot produkcijskega klicatelja. Omejite, kdo lahko uporablja odjemalca, v njegovem lastnem pozivu jasno navedite predvidenega agenta in številko ter preglejte klice v zgodovini klicev.

Celoten referenčni opis protokola

Za primere odgovorov, napake JSON-RPC in API za upravljanje oddaljenih strežnikov glejte API strežnikov MCP.