Naudokite ThunderPhone kaip MCP serverį

ThunderPhone pateikia Model Context Protocol serverį adresu:

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

Nukreipkite MCP klientą į tą srautiniam HTTP skirtą galinį tašką, kad jūsų organizacijos agentai ir skambučiai būtų pasiekiami kaip įrankiai. Tai yra priešinga kryptis nei nuotolinio MCP serverio prijungimas prie balso agento:

Kryptis	Rezultatas
Nuotolinis MCP serveris → ThunderPhone agentas	Jūsų balso agentas gali iškviesti nuotolinio serverio įrankius.
ThunderPhone → jūsų MCP klientas	Jūsų MCP klientas gali iškviesti ThunderPhone įrankius, skirtus agentams ir skambučiams.

Autentifikavimas

Sukurkite sk_live_ raktą skiltyje Organizacija → Raktai ir siųskite jį kaip Bearer prieigos raktą. MCP galinis taškas priima organizacijos API raktus, o ne valdymo skydelio sesijos slapukus ar publikuojamus valdiklio raktus.

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

Galimi įrankiai

Įrankis	Argumentai	Paskirtis
`list_agents`	nėra	Pateikia organizacijos agentų sąrašą su ID, pavadinimu, produktu ir balsu.
`get_agent`	`agent_id`	Gauna vieną agentą.
`place_call`	`agent_id`, `from_number`, `to_number`	Inicijuoja išeinantį skambutį taikant tą patį tikrinimą ir atsiskaitymo apribojimus kaip REST skambučio galiniame taške.
`get_call`	`call_id`	Gauna skambučio būseną, suvestinę ir įvertinimą.
`list_calls`	pasirinktinis `limit` (1–100), pasirinktinis `status`	Pateikia naujausių skambučių sąrašą.
`get_call_transcript`	`call_id`	Gauna visą skambučio transkriptą.

Visi įrankiai apriboti organizacija, susieta su API raktu. Kitos organizacijos ID laikomas nepasiekiamu.

Protokolo metodai

Galinis taškas įgyvendina MCP JSON-RPC metodus, reikalingus srautiniams HTTP klientams:

initialize
notifications/initialized
tools/list
tools/call

Galite tiesiogiai peržiūrėti įrankių katalogą:

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

Iškvieskite įrankį nurodydami jo pavadinimą ir argumentus:

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

Įrankių rezultatai yra MCP teksto turinio elementai. Įrankių klaidos grąžinamos rezultate su isError: true; nežinomi JSON-RPC metodai grąžina protokolo klaidą.

Saugus skambučių inicijavimas

place_call taikomos tos pačios taisyklės kaip ir POST /v1/call: agentas ir numeris turi priklausyti rakto organizacijai, numeris turi būti tinkamas išeinantiems skambučiams, organizacija turi turėti pakankamą balansą, o visi taikomi išeinančių skambučių patvirtinimai turi būti užbaigti.

Laikykite klientą, turintį prieigą prie place_call, produkciniu skambučių inicijavimo įrankiu. Apribokite, kas gali naudoti klientą, jo paties raginime aiškiai nurodykite numatytą agentą ir numerį bei peržiūrėkite skambučius Skambučių istorijoje.

Išsami sąsajos nuoroda

Atsakymų pavyzdžius, JSON-RPC klaidas ir nuotolinių serverių valdymo API rasite MCP serverių API.