Siirry sisältöön

Mikä on MCP-palvelin ja miten se liittyy puhelimeen

2. syyskuuta 2026 · lukuaika 7 min

MCP-palvelin on rajapinta, jonka avulla tekoälyeditori tai avustaja (Claude Code, Cursor, Windsurf ja muut) pääsee ajon aikana käyttämään ulkoisen palvelun työkalua ja käyttämään sitä suoraan - ei vain puhumaan siitä. Model Context Protocol (MCP) on avoin standardi, jonka avulla editori pyytää luettelon käytettävissä olevista työkaluista, valitsee kehotteeseen sopivan työkalun ja kutsuu sitä oikeilla parametreilla; toisessa päässä oleva palvelin suorittaa työkalun ja palauttaa tuloksen keskusteluun. Yksi volain työkaluista on make_call - siksi tekoälyeditori voi kirjaimellisesti nostaa luurin ja soittaa jollekulle ilman, että kirjoitat riviäkään koodia.

Mikä on MCP-palvelin?

Model Context Protocolin esitteli marraskuussa 2024 Anthropic avoimena standardina tekoälymallien yhdistämiseksi ulkoisiin työkaluihin ja dataan - sen sijaan että jokainen editori ja jokainen palvelu keksisi oman kertakäyttöisen integraationsa, ne puhuvat yhteistä protokollaa. MCP erottaa kaksi puolta: MCP-asiakas on sovellus, joka pyörii sinulla (Claude Code, Cursor, Claude Desktop), ja MCP-palvelin on rajapinta, jonka palvelu (tässä volai) tarjoaa ulospäin - sisältäen luettelon kutsuttavista työkaluista.

volain MCP-palvelin toimii osoitteessa https://volai.cz/mcp (etäpalvelin, johon otetaan yhteys niin sanotulla streamable HTTP -siirrolla, ei oman levysi prosessi) ja tarjoaa 116 työkalua (tilanne 3. marraskuuta 2026, ajantasainen luettelo on aina osoitteessa /docs/mcp) - saldon tarkistamisesta ja numeron ostamisesta tekstiviestien lähettämiseen ja, kyllä, puhelun soittamiseen.

Miten MCP-asiakas kutsuu työkalua?

Asennuksen ja itse puhelun välillä tapahtuu sarja vaiheita, jotka editori hoitaa kokonaan itse - sinä kirjoitat vain kehotteen:

  1. Editori ottaa yhteyden palvelimeen ja tunnistautuu API-avaimella (Authorization: Bearer vk_...) - samalla avaimella kuin REST-rajapinta, samalla pyyntörajalla 60 pyyntöä minuutissa.
  2. Palvelin palauttaa työkaluluettelon - jokaisesta työkalusta nimen, luettavan kuvauksen ja parametrien tarkan muodon (JSON-skeeman).
  3. Malli lukee kuvaukset ja valitsee kehotteeseen sopivan työkalun - esimerkiksi make_call, kun kehotteessa lukee "soita".
  4. Editori kutsuu työkalua oikeilla parametreilla - todellinen puhelinnumero ja konkreettiset ohjeet agentille, ei yleistä tekstiä.
  5. Palvelin meidän puolellamme suorittaa työkalun - käynnistää puhelun, vähentää saldoa - ja palauttaa tuloksen kahdessa muodossa: luettavana lauseena ja samalla jäsenneltynä datana (structuredContent) asiakkaille, jotka osaavat lukea sen suoraan.
  6. Malli saa tuloksen takaisin keskusteluun ja kertoo, mitä tapahtui - tai siirtyy toiseen työkaluun, esimerkiksi get_call, odottaakseen puhelun päättymistä ja hakeakseen litteroinnin.

Esimerkki: make_call käytännössä

Kerrot editorille, mitä haluat, tavallisella kielellä - esimerkiksi: "Soita numeroon +420777123456, esittele itsesi Kavka-kahvilan vastaanottona ja selvitä, haluaako vastaaja varata pöydän." Editori muuttaa sen työkalun make_call kutsuksi - tätä osaa et näe koskaan suoraan, mutta konepellin alla se näyttää tältä:

json
{
  "to": "+420777123456",
  "systemPrompt": "Olet Kavka-kahvilan vastaanotto. Vastaa puheluun, esittele itsesi ja selvitä, haluaako soittaja varata pöydän - jos haluaa, kysy nimi ja aika."
}

Työkalu vaatii kohteen (to) ja täsmälleen YHDEN kolmesta tavasta toteuttaa puhelu - agentId (oma agenttisi hoitaa sen), from (yksinkertainen yhteys kahden numeron välillä, ilman agenttia) tai systemPrompt (testipuhelu ilman omaa numeroa - yksi pyyntö, mitään ei tarvitse ostaa tai luoda etukäteen). Palvelin vastaa molemmissa muodoissa samanaikaisesti (ote - puheluobjektin koko muoto löytyy REST-rajapinnan viitteestä):

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

Puhelu lähtee volain jaetusta demonumerosta, noudattaa systemPrompt-kentän ohjeita ja veloitetaan tavalliseen tapaan, agenttilisä mukaan lukien - mutta tiukemmalla päivärajalla kuin oman agentin puhelut: enintään kolme testipuhelua ilman omaa numeroa tiliä ja päivää kohti (raja on kuvattu REST-rajapinnan viitteessä, tilanne 6. syyskuuta 2026). Siksi vastaus sisältää lisäksi trial: true ja from volain jaetun demonumeron kanssa, jotta näkyy, ettei puhelu lähtenyt omasta numerostasi.

Miten MCP liittyy puhelimeen?

MCP-palvelin ei itse nosta mitään luuria - se on vain portti, jonka kautta kehotteesi pääsee todelliseen palvelulogiikkaan. Sen takana make_call kutsuu samaa kerrosta kuin REST-rajapinta ja portaali, joka vie puhelun puhelinverkkoon aivan kuten minkä tahansa muun volain lähtevän puhelun - SIP-trunkin kautta, joka yhdistää internetin yli kulkevan merkinannon oikeaan puhelinverkkoon (miten se tapahtuu, kuvataan artikkelissa Mikä on SIP-trunk). MCP on kieli, jota tekoälyeditori puhuu, SIP-trunk on kieli, jota puhelinverkko puhuu - ja niiden välinen palvelulogiikka sitoo nämä kaksi yhteen.

Turvallisuus

MCP tunnistautuu samalla API-avaimella kuin REST-rajapinta - avaimen haltija voi käyttää saldoasi sinun nimissäsi: ostaa numeroita, soittaa, lähettää tekstiviestejä, luoda agentteja. Avain kuuluu siksi vain editorin asetuksiin, ei koskaan frontend-koodiin eikä GitHub-repoon. Vuotoepäilyn yhteydessä riittää yksi painike portaalissa (Käyttöoikeus ja API) - poistettu avain lakkaa toimimasta välittömästi, eikä poistoa voi perua.

Toinen suojakerros toimii palvelimella, ei kehotteessa. Soittokieltolistalle lisätty numero (työkalu add_to_dnc) estää puhelut työkalulla make_call ja relayn kautta riippumatta siitä, mitä kehotteessa lukee - mallin ei itse tarvitse muistaa, kenelle se ei saa soittaa, rajaa valvoo palvelin. Samoin rahaa maksavilla tai jotakin peruuttamattomasti muuttavilla työkaluilla (make_call, send_sms, delete_agent...) on omat lippunsa protokollassa - palvelin ilmoittaa etukäteen, onko toiminto peruuttamaton vai turvallinen toistaa. Maksulliset toiminnot eivät tarkoituksella ole idempotentteja: make_call-kutsun toinen kutsu katkenneen yhteyden jälkeen soittaa toisen puhelun ja veloittaa toisen maksun, joten hyvin toimiva asiakas ei toista sitä itsenäisesti aikakatkaisun jälkeen.

Yksi asia puuttuu kokonaan tarkoituksella: ostetun puhelinnumeron tai matkapuhelinnumeron vapauttaminen ei ole 116 työkalun joukossa. Numeron osto MCP:n kautta onnistuu, sen lopettaminen ei - peruuttamaton toiminto, joka voi johtaa siihen, että asiakas menettää esitteeseen painetun numeron, vaatii portaalin tai REST-rajapinnan eikä yhtä väärinymmärrettyä lausetta kehotteessa.

Kokeile itse

Asennus Claude Codessa on yksi komento terminaalissa (Cursor, Windsurf ja Claude Desktop tarvitsevat muutaman rivin omaa JSONia, katso /docs/mcp):

bash
claude mcp add --transport http volai https://volai.cz/mcp \
  --header "Authorization: Bearer vk_SINUN_AVAIMESI"
HaluatSiirry kohtaan
Koko työkaluluettelon ja asennuksen muihin editoreihinMCP-palvelin
Samat tiedot tavallisilla HTTP-pyynnöillä omasta taustajärjestelmästäsiREST-rajapinta

Ja minne puhelu oikeastaan päätyy?

make_call päästää äänen lopulta oikeaan puhelinverkkoon SIP-trunkin kautta - mikä se on ja miksi tekoälypuheagentti tarvitsee sellaisen, selitetään artikkelissa Mikä on SIP-trunk.

Kokeile volaita - ensimmäiset 2 € saat meiltä

Tili luodaan minuutissa, ja aloitussaldo puheluihin ja yhteen numeroon on heti käytettävissä - tekstiviestejä voi lähettää ensimmäisen latauksen jälkeen.

Kokeile ilmaiseksi