Käytä ThunderPhonea MCP-palvelimena

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:

Suunta	Tulos
Etä-MCP-palvelin → ThunderPhone-agentti	Puheagenttisi voi kutsua etäpalvelimen työkaluja.
ThunderPhone → MCP-asiakkaasi	MCP-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"
      }
    }
  }
}

sk_live_-avain voi käyttää organisaation tietoja ja soittaa puheluita. Älä sisällytä sitä selainkoodiin, tietovarastoihin, kuvakaappauksiin tai keskustelulokeihin. Käytä MCP-asiakkaasi tukemaa salaisuussäilöä ja peruuta avain välittömästi, jos se paljastuu.

Käytettävissä olevat työkalut

Työkalu	Argumentit	Toiminto
`list_agents`	ei mitään	Listaa organisaation agentit tunnuksineen, nimineen, tuotteineen ja äänineen.
`get_agent`	`agent_id`	Hakee yhden agentin.
`place_call`	`agent_id`, `from_number`, `to_number`	Soittaa lähtevän puhelun käyttäen samoja validointi- ja laskutusrajoituksia kuin REST-puhelupäätepiste.
`get_call`	`call_id`	Hakee puhelun tilan, yhteenvedon ja arvosanan.
`list_calls`	valinnainen `limit` (1–100), valinnainen `status`	Listaa viimeisimmät puhelut.
`get_call_transcript`	`call_id`	Hakee 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.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Compliance

Developer cookbook

Operations

Käytä ThunderPhonea MCP-palvelimena

Todennus

Käytettävissä olevat työkalut

Protokollamenetelmät

Puheluiden soittaminen turvallisesti

Täydellinen wire-viite

​Todennus

​Käytettävissä olevat työkalut

​Protokollamenetelmät

​Puheluiden soittaminen turvallisesti

​Täydellinen wire-viite

Todennus

Käytettävissä olevat työkalut

Protokollamenetelmät

Puheluiden soittaminen turvallisesti

Täydellinen wire-viite