Koristite ThunderPhone kao MCP poslužitelj

ThunderPhone pruža Model Context Protocol poslužitelj na:

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

Usmjerite MCP klijent na tu krajnju točku Streamable HTTP kako bi agenti i pozivi vaše organizacije bili dostupni kao alati. Ovo je suprotan smjer od povezivanja udaljenog MCP poslužitelja s glasovnim agentom:

Smjer	Rezultat
Udaljeni MCP poslužitelj → ThunderPhone agent	Vaš glasovni agent može pozivati alate udaljenog poslužitelja.
ThunderPhone → vaš MCP klijent	Vaš MCP klijent može pozivati ThunderPhone alate za agente i pozive.

Autentifikacija

Izradite ključ sk_live_ u odjeljku Organizacija → Ključevi i pošaljite ga kao Bearer token. MCP krajnja točka prihvaća API ključeve organizacije, a ne kolačiće sesije nadzorne ploče ni javne ključeve widgeta.

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

Dostupni alati

Alat	Argumenti	Funkcija
`list_agents`	nema	Navodi agente organizacije s ID-jem, nazivom, proizvodom i glasom.
`get_agent`	`agent_id`	Dohvaća jednog agenta.
`place_call`	`agent_id`, `from_number`, `to_number`	Upućuje odlazni poziv uz istu provjeru valjanosti i uvjete naplate kao REST krajnja točka za pozive.
`get_call`	`call_id`	Dohvaća status, sažetak i ocjenu poziva.
`list_calls`	neobavezni `limit` (1–100), neobavezni `status`	Navodi nedavne pozive.
`get_call_transcript`	`call_id`	Dohvaća potpuni prijepis poziva.

Svi su alati ograničeni na organizaciju povezanu s API ključem. ID iz druge organizacije ponaša se kao da nije dostupan.

Metode protokola

Krajnja točka implementira MCP JSON-RPC metode potrebne za klijente Streamable HTTP:

initialize
notifications/initialized
tools/list
tools/call

Katalog alata možete pregledati izravno:

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

Pozovite alat njegovim nazivom i argumentima:

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

Rezultati alata MCP su stavke tekstualnog sadržaja. Neuspjesi alata vraćaju se u rezultatu s isError: true; nepoznate JSON-RPC metode vraćaju pogrešku protokola.

Sigurno upućivanje poziva

place_call slijedi ista pravila kao POST /v1/call: agent i broj moraju pripadati organizaciji ključa, broj mora ispunjavati uvjete za odlazne pozive, organizacija mora imati dovoljno sredstava i svaka primjenjiva potvrda odlaznih poziva mora biti dovršena.

Klijenta s pristupom alatu place_call tretirajte kao produkcijskog pozivatelja. Ograničite tko može koristiti klijenta, u njegovom upitu jasno navedite željenog agenta i broj te pregledajte pozive u Povijesti poziva.

Potpuna referenca prijenosa

Pogledajte API MCP poslužitelja za primjere odgovora, JSON-RPC pogreške i API za upravljanje udaljenim poslužiteljima.