Megérkezett a ThunderPhone 2.0.Önkiszolgáló használat már 2 cent/perctől.Olvassa el a bejelentést
Kezdés

Connect tools & data

A ThunderPhone használata MCP-szerverként

Csatlakoztasson bármely Streamable HTTP MCP-klienst a ThunderPhone-hoz ügynökök listázásához, hívások és átiratok vizsgálatához, valamint kimenő hívások indításához szervezeti API-kulccsal.

ThunderPhone egy Model Context Protocol-szervert tesz elérhetővé itt:

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

Irányítson egy MCP-klienst erre a Streamable HTTP-végpontra, hogy szervezete ügynökei és hívásai eszközként elérhetővé váljanak. Ez ellentétes irányú, mint egy távoli MCP-szerver hangalapú AI-ügynökhöz való csatlakoztatása:

IrányEredmény
Távoli MCP-szerver → ThunderPhone-ügynökHangalapú AI-ügynöke meghívhatja a távoli szerver eszközeit.
ThunderPhone → az Ön MCP-klienseMCP-kliense meghívhatja a ThunderPhone ügynökökhöz és hívásokhoz tartozó eszközeit.

Hitelesítés

Hozzon létre egy sk_live_ kulcsot a Szervezet → Kulcsok alatt, és küldje el Bearer tokenként. Az MCP-végpont szervezeti API-kulcsokat fogad el, nem irányítópult-munkamenet- cookie-kat vagy publikálható widgetkulcsokat.

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

Elérhető eszközök

EszközArgumentumokFunkció
list_agentsnincsFelsorolja a szervezet ügynökeit azonosítóval, névvel, termékkel és hanggal.
get_agentagent_idLekér egy ügynököt.
place_callagent_id, from_number, to_numberKimenő hívást kezdeményez ugyanazokkal az ellenőrzési és számlázási korlátozásokkal, mint a REST-hívásvégpont.
get_callcall_idLekéri a hívás állapotát, összegzését és értékelését.
list_callsopcionális limit (1–100), opcionális statusFelsorolja a legutóbbi hívásokat.
get_call_transcriptcall_idLekéri egy hívás teljes átiratát.

Minden eszköz az API-kulcshoz kötött szervezetre van korlátozva. Egy másik szervezetből származó azonosító nem elérhetőként viselkedik.

Protokollmetódusok

A végpont megvalósítja a Streamable HTTP-kliensekhez szükséges MCP JSON-RPC- metódusokat:

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

Az eszközkatalógust közvetlenül is megtekintheti:

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

Hívjon meg egy eszközt a nevével és argumentumaival:

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

Az eszközeredmények MCP-szövegtartalom-elemek. Az eszközhibák a isError: true értékkel jelennek meg az eredményben; az ismeretlen JSON-RPC- metódusok protokollhibát adnak vissza.

Hívások biztonságos kezdeményezése

A place_call ugyanazokat a szabályokat követi, mint a POST /v1/call: az ügynöknek és a telefonszámnak a kulcshoz tartozó szervezethez kell tartoznia, a telefonszámnak alkalmasnak kell lennie kimenő hívásokra, a szervezetnek elegendő egyenleggel kell rendelkeznie, és minden alkalmazandó kimenőhívás-megerősítésnek teljesnek kell lennie.

A place_call hozzáféréssel rendelkező klienst éles híváskezdeményezőként kezelje. Korlátozza, ki használhatja a klienst, egyértelműsítse a saját promptjában a szándékolt ügynököt és telefonszámot, és ellenőrizze a hívásokat a Híváselőzményekben.

Teljes vezetékes referencia

Válaszpéldákért, JSON-RPC-hibákért és a távoli szerverek kezelési API-jáért lásd: MCP Servers API.