ThunderPhone 2.0 ir klāt.Sāciet uzreiz — no 2 centiem minūtē.Lasīt paziņojumu
Sākt darbu

Connect tools & data

Izmantojiet ThunderPhone kā MCP serveri

Savienojiet jebkuru Streamable HTTP MCP klientu ar ThunderPhone, lai uzskaitītu balss aģentus, pārskatītu zvanus un transkriptus, kā arī veiktu izejošos zvanus, izmantojot organizācijas API atslēgu.

ThunderPhone nodrošina Model Context Protocol serveri šādā adresē:

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

Norādiet MCP klientam šo straumējamā HTTP galapunktu, lai jūsu organizācijas aģenti un zvani būtu pieejami kā rīki. Tas ir pretējs virziens nekā attāla MCP servera savienošana ar balss aģentu:

VirziensRezultāts
Attāls MCP serveris → ThunderPhone aģentsJūsu balss aģents var izsaukt attālā servera rīkus.
ThunderPhone → jūsu MCP klientsJūsu MCP klients var izsaukt ThunderPhone rīkus aģentiem un zvaniem.

Autentificēšana

Izveidojiet sk_live_ atslēgu sadaļā Organizācija → Atslēgas un nosūtiet to kā Bearer marķieri. MCP galapunkts pieņem organizācijas API atslēgas, nevis informācijas paneļa sesijas sīkdatnes vai publicējamās logrīka atslēgas.

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

Pieejamie rīki

RīksArgumentiDarbība
list_agentsnavUzskaita organizācijas aģentus ar ID, nosaukumu, produktu un balsi.
get_agentagent_idIegūst vienu aģentu.
place_callagent_id, from_number, to_numberVeic izejošu zvanu ar tādām pašām validācijas un norēķinu pārbaudēm kā REST zvanu galapunkts.
get_callcall_idIegūst zvana statusu, kopsavilkumu un vērtējumu.
list_callsneobligāts limit (1–100), neobligāts statusUzskaita nesenos zvanus.
get_call_transcriptcall_idIegūst pilnu zvana transkriptu.

Visi rīki ir ierobežoti ar organizāciju, kas saistīta ar API atslēgu. ID no citas organizācijas tiek uzskatīts par nepieejamu.

Protokola metodes

Galapunkts īsteno MCP JSON-RPC metodes, kas nepieciešamas straumējamā HTTP klientiem:

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

Varat tieši pārbaudīt rīku katalogu:

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

Izsauciet rīku ar tā nosaukumu un argumentiem:

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

Rīku rezultāti ir MCP teksta satura vienumi. Rīku kļūdas tiek atgrieztas rezultātā ar isError: true; nezināmas JSON-RPC metodes atgriež protokola kļūdu.

Droša zvanu veikšana

place_call ievēro tos pašus noteikumus kā POST /v1/call: aģentam un numuram ir jāpieder atslēgas organizācijai, numuram jābūt piemērotam izejošajiem zvaniem, organizācijai jābūt pietiekamam atlikumam, un jebkuram piemērojamam izejošo zvanu apstiprinājumam jābūt pabeigtam.

Uzskatiet klientu ar piekļuvi place_call par produkcijas zvanu veicēju. Ierobežojiet, kas var izmantot klientu, skaidri norādiet tā uzvednē paredzēto aģentu un numuru, un pārskatiet zvanus sadaļā Zvanu vēsture.

Pilnīga savienojuma atsauce

Skatiet MCP serveru API, lai iegūtu atbilžu piemērus, JSON-RPC kļūdas un attālo serveru pārvaldības API.