Kasuta ThunderPhone'i MCP-serverina

ThunderPhone pakub Model Context Protocoli serverit aadressil:

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

Suunake MCP-klient sellele Streamable HTTP lõpp-punktile, et muuta oma organisatsiooni agendid ja kõned tööriistadena kättesaadavaks. See on vastupidine suund võrreldes kaughostitud MCP-serveri ühendamisega häälagendiga:

Suund	Tulemus
Kaughostitud MCP-server → ThunderPhone'i agent	Sinu häälagent saab kutsuda kaughostitud serveri tööriistu.
ThunderPhone → sinu MCP-klient	Sinu MCP-klient saab kutsuda ThunderPhone'i tööriistu agentide ja kõnede jaoks.

Autentimine

Loo sk_live_ võti jaotises Organisatsioon → Võtmed ning saada see Beareri tokenina. MCP lõpp-punkt aktsepteerib organisatsiooni API-võtmeid, mitte juhtpaneeli seansiküpsiseid ega avaldatavaid vidina võtmeid.

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

Saadaolevad tööriistad

Tööriist	Argumendid	Funktsioon
`list_agents`	puuduvad	Loetleb organisatsiooni agendid koos ID, nime, toote ja häälega.
`get_agent`	`agent_id`	Hangib ühe agendi.
`place_call`	`agent_id`, `from_number`, `to_number`	Teeb väljamineva kõne sama valideerimise ja arvelduse kontrollidega nagu REST-kõne lõpp-punkt.
`get_call`	`call_id`	Hangib kõne oleku, kokkuvõtte ja hinde.
`list_calls`	valikuline `limit` (1–100), valikuline `status`	Loetleb hiljutised kõned.
`get_call_transcript`	`call_id`	Hangib kõne täieliku transkriptsiooni.

Kõik tööriistad on piiratud API-võtmega seotud organisatsiooniga. Teise organisatsiooni ID käitub nagu see poleks saadaval.

Protokollimeetodid

Lõpp-punkt rakendab Streamable HTTP klientide jaoks vajalikke MCP JSON-RPC meetodeid:

initialize
notifications/initialized
tools/list
tools/call

Tööriistade kataloogi saad vaadata otse:

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

Kutsu tööriist selle nime ja argumentidega:

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

Tööriistade tulemused on MCP tekstisisuüksused. Tööriista tõrked tagastatakse tulemuses väärtusega isError: true; tundmatud JSON-RPC meetodid tagastavad protokollivea.

Kõnede turvaline tegemine

place_call järgib samu reegleid nagu POST /v1/call: agent ja number peavad kuuluma võtme organisatsioonile, number peab sobima väljaminevateks kõnedeks, organisatsioonil peab olema piisav saldo ning kõik kohaldatavad väljaminevate kõnede kinnitused peavad olema lõpule viidud.

Käsitle klienti, millel on juurdepääs tööriistale place_call, tootmiskõnede tegijana. Piira, kes saab klienti kasutada, täpsusta selle viibas selgelt soovitud agent ja number ning vaata kõned üle kõneajaloos.

Täielik juhtmeprotokolli viide

Vastuste näidete, JSON-RPC vigade ja kaughostitud serverite halduse API jaoks vaata MCP-serverite API-d.