Kuidas anda Claude Code'ile telefoninumber MCP kaudu

Kas soovite, et Claude Code (või Cursor, Windsurf, VS Code) oskaks helistada ja SMS-e saata ainult promptist, ilma koodi kirjutamata? Piisab ühest käsust terminalis, mis ühendab volai MCP serverina, ja seejärel tavalise lausega redaktorile kirjutada, mida soovite - „helista mulle numbril...“, „saada SMS...“. Redaktor valib ise õige tööriista 110 hulgast, mida volai MCP kaudu pakub, ja kutsub selle välja. Ei mingit API dokumentatsiooni lugemist, ei mingit oma telefonikoodi.

Mis on MCP ja miks see toimib ilma koodi kirjutamata?

MCP (Model Context Protocol) on viis, kuidas AI redaktor saab töö käigus küsida välise teenuse tööriista ja seda kohe kasutada - mitte ainult sellest rääkida. Niipea kui volai on ühendatud, näeb redaktor kõiki 110 tööriista (helista, saada SMS, osta number, loo agent ja teised) ning iga kirjelduse põhjal teab ise, milline neist sobib sellega, mida te just kirjutasite. Kes soovib põhimõtte üksikasjalikku selgitust, leiab selle artiklist Mis on MCP server ja kuidas see telefonimisega seostub; siin on peamiselt küsimus selles, kuidas anda Claude Code'ile telefoninumber ja see kohe järele proovida.

Paigaldamine Claude Code'i

Üks käsk terminalis ja valmis:

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

API võtme (vk_TEIE_VOTI) leiate volai portaalist jaotisest API ja MCP pärast seda, kui olete registreerunud. Ilma kehtiva võtmeta server päringu tagasi lükkab - redaktor ütleb seda teile esimese sõnumi juures kohe.

Cursor ja teised redaktorid

Sama server, teistsugune kirjutusviis. Faili ~/.cursor/mcp.json (või ainult ühe projekti jaoks faili .cursor/mcp.json) lisage:

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

Windsurf, VS Code (Copilot) ja Claude Desktop ühenduvad sama põhimõttega, ainult seadistusfaili kuju on pisut teine - täpne sõnastus igaühe jaoks on lehel MCP server.

Kui redaktor pärast ühendamist ühtegi tööriista ei paku: tavaliselt on põhjuseks üks kolmest asjast. Redaktor laadib MCP serverite seadistuse tavaliselt ainult käivitumisel, nii et pärast esmast salvestamist vajab see taaskäivitust (või vähemalt akna või projekti uuesti laadimist). Kontrollige kopeeritud võtit, kas selle alguses või lõpus pole üleliigset tühikut - terminalis ja JSON-failis on see nähtamatu, kuid rikub päise Authorization. Ja kas server üldse vastab, kontrollite kiiremini just allpool oleva promptiga - niipea kui redaktor kutsub tööriista ise välja, on ühendus korras.

Esimene kõne ühe promptiga

Pärast ühendamist piisab, kui kirjutate redaktorile oma sõnadega, mida soovite - näiteks täpselt nii:

• ›Helista mulle kohe numbril +420777123456 ja proovi pitsakoha tellimusliini rolli - ma ei soovi selle pärast oma numbrit ega agenti luua.

Redaktor tunneb sellest ära tööriista make_call ja selle parameetri systemPrompt - proovikõne ilma numbri ostmise või agendi eelneva loomiseta. Helistatakse volai jagatud demonumbrilt - täpselt see number, mitte teie oma, on helistatavale ekraanil nähtav, ja kõne kasutab agendi vaikehäält, sest oma voiceId proovikõne puhul saata ei saa. systemPrompt võib olla kuni 1200 märki pikk, kõne arvestatakse täiesti tavapäraselt, sh agendi lisatasu (ilma allahindluseta), ning see on piiratud kuni 3 proovikõnega 24 tunni jooksul konto kohta - kinnitatud e-post on tingimus. Kui soovite helistada oma numbrilt oma agendiga, öelge seda redaktorile otse - ta kutsub välja make_call parameetriga agentId parameetri systemPrompt asemel.

Esimene SMS ühe promptiga

Sama põhimõte toimib tekstisõnumite puhul:

• ›Saada SMS numbrile +420777123456, et tellitud aeg kinnitatakse homseks hommikupoolikuks.

Seekord haarab redaktor tööriista send_sms järele - kapoti all täpselt sama kutse, mille kirjutaksite ise otse REST API-le (POST /v1/messages {"to": "+420...", "body": "..."}), ainult ilma koodi kirjutamata. Ilma oma numbrita läheb SMS jagatud saatjanime SMSinfo all ainult Tšehhi (+420) või Slovakkia (+421) numbrile ja saaja ei saa sellele vastata - volai häälnumbrid SMS-e vastu ei võta. SMS-ide vastuvõttu ja saatmist oma numbrilt (ainult Tšehhi numbritele) oskab lisateenus mobiilinumber (290 kr ilma käibemaksuta 30 päeva kohta, kuni 2 konto kohta), mille redaktor ostab tööriistaga buy_sms_number alles pärast teie selgesõnalist nõusolekut hinnaga ja vastuvõetud sõnumid loeb tööriistaga list_messages; teenuste kinnituskoodide kättesaamist me ei garanteeri. SMS-e oskab vastu võtta ja oma numbrilt saata ka „number kõnede ja SMS-ide jaoks“: Praha lauatelefoninumber hinnaga 49 kr ilma käibemaksuta 30 päeva kohta (arvestatakse alles pärast aktiveerimist, tavaliselt 1 tööpäeva jooksul; kuni 2 konto kohta), millele inimesed saavad nii helistada kui ka kirjutada ning millelt agent nii helistab kui ka SMS-e saadab. Redaktor tellib selle tööriistaga order_voice_sms_number alles pärast teie selgesõnalist nõusolekut hinnaga, sissetulevad kõned suunab tööriistaga set_voice_sms_number_routing ja SMS-e saadab sellelt tööriistaga send_sms väljaga fromNumber (ainult Tšehhi numbritele, ilma kohaletoimetamise teatisteta). Tekstisõnumid lähevad alles pärast esimest saldo täiendamist: tervitussaldost piisab proovikõnedeks, SMS-ideks mitte.

Mida veel saab teha lasta?

Samamoodi toimib iga 110 tööriistast - mõned lisanäited:

• „Võta mulle kokku viimased kümme kõnet - eelkõige, kas nende hulgas oli midagi kiireloomulist.“ - tööriist list_calls.
• „Ütle mulle saldo praegune seis ja anna hoiatus, kui see hakkab otsa saama.“ - tööriist get_balance.
• „Loo filiaali jaoks uus number ja määra sellele kohe agent, kes võtab vastu lauabroneeringuid.“ - tööriistad buy_number ja create_agent järjest.

Täielik tabel kõigist 110 tööriistast koos kirjeldusega, millal redaktor neid kasutab, on lehel MCP server - ja leht Integratsioonid: Claude Code sisaldab kohe ka mõnda valmis prompti tüüpiliste ülesannete jaoks.

Kas on turvaline anda redaktorile API võti?

MCP autoriseeritakse sama API võtmega nagu REST API ja jagab sellega ka sama limiiti 60 päringut minutis - kes selle võtme omab, tegutseb teie konto nimel täiesti samamoodi nagu teie: ostab numbri, võtab telefoni vastu, saadab tekstisõnumi või loob agendi, ja kõik see arvatakse maha teie saldost.

Tasulistel toimingutel (send_sms, make_call, buy_number, buy_sms_number) on tahtlikult idempotentHint: false - teine kutse saadab teise SMS-i või arvab maha teise summa, seega hea redaktor neid pärast katkestust ise ei korda. Ja isegi kui prompt eksiks numbrile, millele te helistada ei soovi, on veel viimane kaitse: helistamiskeeluga nimekiri. Tööriistad add_to_dnc, list_dnc ja remove_from_dnc valvavad numbreid, millele agent (nii oma kui sisseehitatud) enam helistada ei tohi - see kehtib kõnede, mitte SMS-ide kohta ja seda ei saa mööda minna ühegi prompti ega API kutsega.

Iga tööriist ütleb lisaks redaktorile ette, kuidas ta käitub - kas ainult loeb (readOnlyHint), kas on pöördumatu (destructiveHint), või ei tohi seda mõtlematult korrata (tasuliste toimingute puhul puudub idempotentsuse tunnus). Tänu sellele küsib hea redaktor enne, kui kustutab agendi või tühistab kasutamata relay lease'i, ja lugemistööriistad (saldo, kõneajalugu, numbrite väljavõte) käivitab otse küsimata - te ei riski sellega millegagi.

Kaks asja MCP tahtlikult ei oska: ostetud numbri (DELETE /v1/numbers/{e164}) ja mobiilinumbri (DELETE /v1/sms-numbers/{e164}) vabastamine käib ainult portaali või REST API kaudu, et üks valesti mõistetud lause ei jätaks teid ilma numbrita, mis on teil flaierile trükitud, ning maksudokumendi PDF-i laaditakse alla ainult REST-i kaudu (dokumente endid loevad tööriistad list_billing_documents ja get_billing_document, arveldusandmeid muudab update_billing_details). Samamoodi pole kõnesalvestuse allalaadimisel oma tööriista - see on helifail, mitte JSON, ja see laaditakse alla sama API võtmega otse REST-ist.

Kogu protseduur koos üksikute tööriistade turvaomadustega (mille kohta redaktor enne küsib, kui midagi teeb) on lehel MCP server, minuti- ja SMS-hinnad hinnakirjas.

Mis edasi