ThunderPhone 2.0 on nyt julkaistu.Ota käyttöön itse – alkaen 2¢/min.Lue lisää julkistuksesta
Aloita

Connect tools & data

Käytä ThunderPhonea MCP-palvelimena

Yhdistä mikä tahansa Streamable HTTP MCP -asiakas ThunderPhoneen listataksesi agentit, tarkastellaksesi puheluita ja transkriptioita sekä soittaaksesi lähteviä puheluita organisaation API-avaimella.

ThunderPhone tarjoaa Model Context Protocol -palvelimen osoitteessa:

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

Määritä MCP-asiakas käyttämään tätä Streamable HTTP -päätepistettä, jotta organisaatiosi agentit ja puhelut ovat käytettävissä työkaluina. Tämä on vastakkainen suunta kuin etä-MCP-palvelimen yhdistäminen puheagenttiin:

SuuntaTulos
Etä-MCP-palvelin → ThunderPhone-agenttiPuheagenttisi voi kutsua etäpalvelimen työkaluja.
ThunderPhone → MCP-asiakkaasiMCP-asiakkaasi voi kutsua ThunderPhonen työkaluja agentteja ja puheluita varten.

Todennus

Luo sk_live_-avain kohdassa Organisaatio → Avaimet ja lähetä se Bearer- tunnuksena. MCP-päätepiste hyväksyy organisaation API-avaimet, ei hallintapaneelin istuntoevästeitä tai julkaistavia widget-avaimia.

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

Käytettävissä olevat työkalut

TyökaluArgumentitToiminto
list_agentsei mitäänListaa organisaation agentit tunnuksineen, nimineen, tuotteineen ja äänineen.
get_agentagent_idHakee yhden agentin.
place_callagent_id, from_number, to_numberSoittaa lähtevän puhelun käyttäen samoja validointi- ja laskutusrajoituksia kuin REST-puhelupäätepiste.
get_callcall_idHakee puhelun tilan, yhteenvedon ja arvosanan.
list_callsvalinnainen limit (1–100), valinnainen statusListaa viimeisimmät puhelut.
get_call_transcriptcall_idHakee puhelun täydellisen transkriptin.

Kaikki työkalut rajataan API-avaimeen sidottuun organisaatioon. Toisen organisaation tunnus käsitellään kuin se ei olisi käytettävissä.

Protokollamenetelmät

Päätepiste toteuttaa Streamable HTTP -asiakkaiden tarvitsemat MCP JSON-RPC -menetelmät:

  • initialize
  • notifications/initialized
  • tools/list
  • tools/call

Voit tarkastella työkaluvalikoimaa suoraan:

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 työkalua sen nimellä ja argumenteilla:

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

Työkalujen tulokset ovat MCP-tekstisisältökohteita. Työkalujen virheet palautetaan tuloksessa arvolla isError: true; tuntemattomat JSON-RPC-menetelmät palauttavat protokollavirheen.

Puheluiden soittaminen turvallisesti

place_call noudattaa samoja sääntöjä kuin POST /v1/call: agentin ja numeron on kuuluttava avaimen organisaatioon, numeron on oltava kelpoinen lähteviin puheluihin, organisaatiolla on oltava riittävästi saldoa ja kaikkien sovellettavien lähtevien puheluiden vahvistusten on oltava valmiita.

Käsittele asiakasta, jolla on pääsy place_call-työkaluun, tuotantokäyttöön tarkoitettuna soittajana. Rajoita, kuka voi käyttää asiakasta, kerro sen omassa kehotteessa selvästi tarkoitettu agentti ja numero sekä tarkista puhelut Puheluhistoriassa.

Täydellinen wire-viite

Katso MCP-palvelinten API vastausesimerkkien, JSON-RPC-virheiden ja etäpalvelinten hallinta-API:n osalta.