Mis on MCP-server ja kuidas see telefonikõnesid teeb

MCP-server on liides, mis võimaldab tehisintellekti redaktoril või assistendil (Claude Code, Cursor, Windsurf ja teised) jooksvalt võtta väliselt teenuselt tööriist ja seda otse kasutada - mitte ainult sellest rääkida. Model Context Protocol (MCP) on avatud standard, mille abil redaktor küsib saadaolevate tööriistade loendit, valib päringu jaoks sobiva ja kutsub selle välja tegelike parameetritega; teises otsas olev server käivitab tööriista ja saadab tulemuse tagasi vestlusesse. volai juures on üks neist tööriistadest make_call - seetõttu saab tehisintellekti redaktor sõna otseses mõttes telefoni haarata ja kellelegi helistada, ilma et peaksite kirjutama ainsatki koodirida.

Mis on MCP-server?

Model Context Protocoli tutvustas Anthropic 2024. aasta novembris avatud standardina tehisintellekti mudelite ühendamiseks väliste tööriistade ja andmetega - selle asemel et iga redaktor ja iga teenus leiutaks oma ühekordse lõimingu, räägivad nad ühte ühist protokolli. MCP jagab kaks poolt: MCP-klient on rakendus, mida te kasutate (Claude Code, Cursor, Claude Desktop), ning MCP-server on liides, mille teenus (siin volai) väljapoole avab - tools loend, mida paluda käivitada.

volai MCP-server töötab aadressil https://volai.cz/mcp (kaugserver, millega ühendutakse nn voogedastatava HTTP-transpordi kaudu, mitte protsess teie enda kettal) ja pakub 110 tööriista (seisuga 3. november 2026, kehtiv loend on alati lehel /docs/mcp) - alates krediidijäägi kontrollimisest ja numbri ostmisest kuni SMS-i saatmise ja jah, kõne tegemiseni.

Kuidas MCP-klient tööriista kutsub?

Serveri paigaldamise ja tegeliku telefonikõne vahel toimub mitu sammu - kõik need teeb redaktor, teie kirjutate ainult päringu:

1. Redaktor ühendub serveriga ja autentib end API-võtmega (Authorization: Bearer vk_...) - sama võti nagu REST API-l, sama päringulimiit 60 päringut minutis.
2. Server saadab tagasi tööriistade loendi - iga kohta nime, inimloetava kirjelduse ja parameetrite täpse kuju (JSON-skeem).
3. Mudel loeb kirjeldust ja valib päringule sobiva - näiteks make_call, kui päringus on „helista“.
4. Redaktor kutsub tööriista välja tegelike parameetritega - tegeliku telefoninumbri ja tegelike juhistega agendile, mitte üldise tekstiga.
5. Meie poolel olev server käivitab tööriista - alustab kõnet, arvestab krediiti maha - ja tagastab tulemuse kaks korda: loetava lausena ja samal ajal struktureeritud andmetena (structuredContent) kliendile, kes oskab neid otse lugeda.
6. Mudel saab tulemuse tagasi vestlusesse ja ütleb teile, mis juhtus - või liigub edasi järgmise tööriistaga, näiteks get_call, et oodata kõne lõppu ja tuua tagasi ärakiri.

Näide: make_call praktikas

Te ütlete redaktorile, mida soovite, tavakeeles - näiteks: „Helista numbril +420777123456, tutvusta end kohviku Nordic Coffee vastuvõtjana ja uuri, kas helistaja soovib lauda broneerida.“ Redaktor muudab selle tööriista make_call väljakutseks - seda osa te otse ei näe, kuid kapoti all näeb see välja nii:

{
  "to": "+420777123456",
  "systemPrompt": "Te olete kohvik Nordic Coffee vastuvõtja. Võtke kõne vastu, tutvustage ennast ja uurige, kas helistaja soovib lauda broneerida - kui jah, siis küsige nime ja kellaaega."
}

Tööriist nõuab sihtkohta (to - Tšehhi või Slovakkia number, ainsad, millele volai praegu helistada saab) ja täpselt ÜHTE kolmest kõne läbiviimise viisist - agentId (kõnet haldab teie oma agent), from (lihtne sild kahe numbri vahel, ilma agendita) või systemPrompt (proovikõne ilma oma numbrita - üks päring, midagi pole vaja eelnevalt osta ega seadistada). Server vastab mõlemal viisil korraga (väljavõte - kõne objekti täielik kuju on REST API viitedokumentatsioonis):

{
  "call": {
    "id": "c_7a2f91de",
    "direction": "out",
    "to": "+420777123456",
    "status": "initiated",
    "startedAt": 1756111400000
  },
  "trial": true,
  "from": "+420..."
}

Kõne läheb välja jagatud volai demonumbrilt, järgib systemPrompt juhiseid ja arveldatakse tavapäraselt koos agendi lisatasuga - ainult kehtib rangem päevalimiit kui päris agendil: kontoga kohta päevas kuni kolm proovikõnet ilma oma numbrita (dokumenteeritud REST API viitedokumentatsioonis, seisuga 6. september 2026). Seetõttu sisaldab vastus ka trial: true ja välja from jagatud volai demonumbriga, et oleks selge, et kõne ei läinud välja teie enda numbrilt.

Kuidas MCP-server telefonikõnedega seostub?

MCP-server ise telefoni ei võta - see on esiuks, mille kaudu teie päring jõuab tegeliku teenuseloogikani. Selle taga kutsub make_call välja sama kihi nagu REST API ja portaal, mis suunab kõne telefonivõrku täpselt nagu iga teine väljaminev volai kõne - üle SIP-trunki, mis sillutab interneti signaliseerimise ja tegeliku telefonivõrgu vahel (kuidas see käib, on kirjeldatud artiklis Mis on SIP-trunk). MCP on keel, mida räägib tehisintellekti redaktor; SIP-trunk on keel, mida räägib telefonivõrk - ja nende vahel olev teenuseloogika ühendab need kaks.

Turvalisus

MCP autentib sama API-võtmega nagu REST API - kes seda omab, saab teie nimel teie krediiti kulutada: numbreid osta, kõnesid teha, SMS-e saata, agente luua. Võti kuulub ainult teie redaktori seadistusse, mitte kunagi esiotsa koodi ega GitHubi hoidlasse. Kahtlus lekkest on portaalis (API ja MCP) ühe nupuvajutuse kaugusel - võtme kustutamine jõustub kohe ja seda ei saa tagasi võtta.

Teine kaitsekiht töötab serveris, mitte päringus. Numbrit, mis on lisatud helistamiskeelu loendisse (tööriist add_to_dnc), blokeeritakse nii make_call kaudu kui ka releel sõltumata sellest, mida päring ütleb - mudel ei pea ise meeles pidama, kellele ei tohi helistada, piiri jõustab server. Samas vaimus kannavad rahalisi kulusid põhjustavad või pöördumatult midagi muutvad tööriistad (make_call, send_sms, delete_agent...) protokollis oma lippe - server teatab ette, kas toiming on hävitav või ohutult korratav. Arveldatavad toimingud EI ole meelega idempotentsed: make_call teistkordne väljakutsumine pärast katkenud ühendust teeb teise kõne ja võtab teise tasu, seega ei korda korrektselt käituv klient seda aegumise järel iseseisvalt.

Üks asi puudub meelega: ostetud telefoninumbri või mobiilinumbri vabastamine ei kuulu nende 110 tööriista hulka. Numbri ostmine MCP kaudu töötab, vabastamine mitte - pöördumatu toiming, mis võib klienti ilma jätta tema flaierile trükitud numbrist, nõuab portaali või REST API-t, mitte ühte valesti loetud lauset päringus.

Proovige ise

Claude Code'i paigaldamine on üks käsk terminalis (Cursor, Windsurf ja Claude Desktop vajavad igaüks oma paari rida JSON-i, vt /docs/mcp):

claude mcp add --transport http volai https://volai.cz/mcp \
  --header "Authorization: Bearer vk_YOUR_KEY"

Mis edasi