Siirry sisältöön

Näin annat Claude Codelle puhelinnumeron MCP:n kautta

2. syyskuuta 2026 · lukuaika 6 min

Haluatko, että Claude Code (tai Cursor, Windsurf, VS Code) osaa soittaa ja lähettää tekstiviestejä suoraan kehotteesta, ilman että kirjoitetaan koodia? Yksi komento terminaalissa yhdistää volain MCP-palvelimeksi, ja sen jälkeen kuvaat tavallisin sanoin, mitä pitää tehdä - ”soita minulle numeroon...”, ”lähetä tekstiviesti numeroon...”. Editori valitsee itse oikean työkalun volain MCP:n kautta tarjoamista 116 työkalusta ja kutsuu sitä. Ei API-dokumentaation lukemista, ei omaa puhelinkoodia.

Mikä MCP on, ja miksi se toimii ilman koodia?

MCP (Model Context Protocol) on tapa, jolla tekoälyeditori hakee ajon aikana työkalun ulkoisesta palvelusta ja todella käyttää sitä sen sijaan, että vain puhuisi siitä. Kun volai on yhdistetty, editori näkee kaikki 116 työkalua (soittaminen, tekstiviestien lähettäminen, numeron osto, agentin luominen ja paljon muuta) ja valitsee kuvauksen perusteella oikean työkalun juuri kirjoitetulle pyynnölle. Periaatteen syvällisempi selitys on artikkelissa Mikä on MCP-palvelin ja miten se liittyy puhelintoimintoihin; tässä keskitytään ennen kaikkea siihen, miten Claude Codelle annetaan puhelinnumero ja kokeillaan sitä heti.

Asennus Claude Codeen

Yksi komento terminaalissa, ja sitten kaikki on valmista:

bash
claude mcp add --transport http volai https://volai.eu/mcp \
  --header "Authorization: Bearer vk_SINUN_AVAIMESI"

API-avain (vk_SINUN_AVAIMESI) löytyy volain portaalista kohdasta Käyttöoikeus ja API, kun on rekisteröitynyt. Ilman kelvollista avainta palvelin hylkää pyynnön - editori ilmoittaa siitä heti ensimmäisessä viestissä.

Cursor ja muut editorit

Sama palvelin, eri merkintätapa. Lisää tämä tiedostoon ~/.cursor/mcp.json (tai tiedostoon .cursor/mcp.json yksittäistä projektia varten):

json
{
  "mcpServers": {
    "volai": {
      "url": "https://volai.eu/mcp",
      "headers": {
        "Authorization": "Bearer vk_SINUN_AVAIMESI"
      }
    }
  }
}

Windsurf, VS Code (Copilot) ja Claude Desktop yhdistetään samalla periaatteella, vain asetustiedoston muoto on hieman erilainen - tarkka syntaksi kullekin löytyy sivulta MCP-palvelin.

Jos editori ei tarjoa työkaluja heti yhteyden jälkeen: syy on yleensä jokin kolmesta. Useimmat editorit lukevat MCP-palvelinten asetukset vain käynnistyessään, joten ensimmäisen tallennuksen jälkeen tarvitaan uudelleenkäynnistys (tai vähintään ikkunan tai projektin lataaminen uudelleen). Tarkista, ettei liitetyn avaimen alussa tai lopussa ole ylimääräistä välilyöntiä - se ei näy terminaalissa eikä JSON-tiedostossa, mutta se pilaa otsakkeen Authorization. Ja nopein tapa varmistaa, että palvelin vastaa, on täsmälleen se prompt, joka on vähän alempana - heti kun editori kutsuu itse jotakin työkalua, yhteys toimii.

Ensimmäinen puhelu kehotteella

Kun yhteys on valmis, riittää kirjoittaa editorille omin sanoin, mitä pitää tehdä - esimerkiksi juuri näin:

  • Soita minulle heti numeroon +420777123456 ja kokeile pizzerian tilauslinjan roolia - en halua hankkia omaa numeroa tai omaa agenttia pelkästään tätä varten.

Editori tunnistaa tämän työkaluksi make_call ja parametriksi systemPrompt - koepuhelu, jota varten ei tarvitse etukäteen luoda numeroa tai agenttia. Puhelu soitetaan volain jaetusta demonumerosta - se näkyy vastaanottajan näytöllä, ei oma numerosi - ja se käyttää agentin oletusääntä, koska omaa voiceId -arvoa ei voi lähettää koepuhelun mukana. systemPrompt saa olla enintään 1200 merkkiä pitkä, puhelu veloitetaan täysin tavallisesti agenttilisä mukaan lukien (ei alennusta), ja koepuheluita sallitaan enintään 3 vuorokaudessa tiliä kohden - vahvistettu sähköpostiosoite vaaditaan. Jos haluat mieluummin soittaa omasta numerostasi oman agenttisi kautta, sano se vain editorille - se kutsuu silloin työkalua make_call parametrilla agentId parametrin systemPrompt sijaan.

Ensimmäinen tekstiviesti kehotteella

Sama periaate toimii tekstiviesteillä:

  • Lähetä tekstiviesti numeroon +420777123456: varattu aika on vahvistettu huomenna aamupäivälle.

Tällä kertaa editori valitsee työkalun send_sms - konepellin alla täsmälleen sama kutsu, jonka itse kirjoittaisi REST API:a vastaan (POST /v1/messages {"to": "+420...", "body": "..."}), vain ilman koodin kirjoittamista. Ilman omaa numeroa tekstiviestit lähtevät jaetulla lähettäjänimellä SMSinfo Tšekkiin, Slovakiaan ja muihin voimassa olevan tarjonnan maihin (maakohtaiset hinnat ovat hinnastossa), eikä vastaanottaja voi vastata - volain puhenumerot eivät vastaanota tekstiviestejä. Tekstiviestien vastaanotto ja lähettäminen omasta numerosta (vain tšekkiläisiin numeroihin) onnistuu lisäpalvelulla matkapuhelinnumero (12,09 € ilman ALV:tä 30 päivältä, enintään 2 tiliä kohden): editori ostaa sen työkalulla buy_sms_number vasta, kun olet nimenomaisesti hyväksynyt hinnan, ja lukee vastaanotetut viestit työkalulla list_messages; palveluiden vahvistuskoodeja emme takaa. Myös tuote ”numero puheluille ja tekstiviesteille” vastaanottaa tekstiviestejä ja lähettää omasta numerosta: lankanumero Prahassa hintaan 2,05 € ilman ALV:tä 30 päivältä (veloitetaan vasta, kun numero on aktivoitu, yleensä 1 arkipäivän kuluessa; enintään 2 tiliä kohden), johon voi soittaa ja lähettää tekstiviestejä ja josta agentti soittaa ja lähettää tekstiviestejä. Editori tilaa sen työkalulla order_voice_sms_number vasta, kun olet nimenomaisesti hyväksynyt hinnan, ohjaa saapuvat puhelut työkalulla set_voice_sms_number_routing ja lähettää tekstiviestit siitä työkalulla send_sms ja kentällä fromNumber (vain tšekkiläisiin numeroihin, ilman toimituskuittauksia). Tekstiviestit toimivat vasta saldon ensimmäisen latauksen jälkeen: tervetulosaldo riittää koepuheluihin, ei tekstiviesteihin.

Mitä muuta voi pyytää?

Sama kaava toimii mille tahansa 116 työkalusta - vielä muutama esimerkki:

  • ”Käy läpi kymmenen viimeisintä puheluani ja kerro, mitkä niistä oikeasti vaativat huomiotani.” - työkalu list_calls.
  • ”Kerro, paljonko saldoa minulla on juuri nyt, ja ilmoita, jos se on loppumassa.” - työkalu get_balance.
  • ”Hanki numero uudelle toimipisteelle ja yhdistä siihen agentti, joka ottaa vastaan pöytävarauksia.” - työkalut buy_number ja create_agent peräkkäin.

Koko taulukko kaikista 116 työkalusta ja kuvaus siitä, milloin editori käyttää kutakin, on sivulla MCP-palvelin - ja sivulla Integraatiot: Claude Code on lisäksi muutama valmis prompt yleisiin tehtäviin.

Onko editorille turvallista antaa API-avain?

MCP todennetaan samalla API-avaimella kuin REST API, ja siihen pätee myös sama 60 pyynnön minuuttiraja - avaimen haltija toimii tilisi puolesta täsmälleen samalla tavalla kuin sinä: ostaa numeron, soittaa puhelun, lähettää tekstiviestin tai luo agentin, ja kaikki veloitetaan saldostasi.

Suojaa avain kuin maksukortti

Älä koskaan anna avaimen päätyä frontend-koodiin, GitHub-repositorioon tai viestiin, joka lähetetään selkokielisenä. Vuotoepäilyssä ongelman ratkaisee yksi napsautus: poista avain portaalissa kohdassa Käyttöoikeus ja API - se lakkaa toimimasta välittömästi, eikä sitä voi palauttaa. Luo uusi samassa kohdassa ja korvaa vanha editorin asetuksissa.

Maksulliset toiminnot (send_sms, make_call, buy_number, buy_sms_number) on tarkoituksella merkitty arvolla idempotentHint: false - toinen kutsu lähettää toisen tekstiviestin tai veloittaa toisen summan, joten hyvin käyttäytyvä editori ei toista niitä omatoimisesti katkoksen jälkeen. Ja vaikka prompt livahtaisi numeroon, johon ei saa soittaa, viimeinen este on olemassa: soittokieltolista. Työkalut add_to_dnc, list_dnc ja remove_from_dnc valvovat numeroita, joihin mikään agentti - ei sisäänrakennettu eikä oma - ei enää saa soittaa. Se koskee puheluita, ei tekstiviestejä, eikä sitä voi kiertää millään kehotteella tai API-kutsulla.

Jokainen työkalu myös kertoo editorille etukäteen, miten se käyttäytyy - lukeeko se vain (readOnlyHint), onko se peruuttamaton (destructiveHint), vai saako sitä toistaa vain harkiten (maksullisilla toiminnoilla ei ole idempotenssilippua). Siksi hyvä editori kysyy ensin, ennen kuin poistaa agentin tai peruuttaa käyttämättömän relay leasen, kun taas lukevat työkalut (saldo, puheluhistoria, numeroluettelo) ajetaan heti kysymättä - siinä ei ole mitään menetettävää.

Kahta asiaa MCP ei tarkoituksella osaa: ostetun numeron (DELETE /v1/numbers/{e164}) tai matkapuhelinnumeron (DELETE /v1/sms-numbers/{e164}) vapauttaminen onnistuu vain portaalin tai REST API:n kautta, jotta yksi väärin luettu lause ei maksa sinulle lentolehtiseesi painettua numeroa, ja laskun PDF ladataan vain REST:n kautta (itse laskut lukevat työkalut list_billing_documents ja get_billing_document, laskutustietoja muutetaan työkalulla update_billing_details). Samoin puhelun tallenteen lataamiselle ei ole omaa työkalua - se on äänitiedosto, ei JSON, ja se ladataan samalla API-avaimella suoraan RESTistä.

Koko läpikäynti, mukaan lukien yksittäisten työkalujen turvaominaisuudet (mitä hyvä asiakasohjelma kysyy ennen toimimista), löytyy sivulta MCP-palvelin, ja minuutti- ja tekstiviestikohtaiset hinnat ovat kohdassa hinnasto.

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