Kā dot Claude Code tālruņa numuru ar MCP

Vēlaties, lai Claude Code (vai Cursor, Windsurf, VS Code) varētu zvanīt un sūtīt SMS tikai no prompta, nerakstot kodu? Pietiek ar vienu komandu terminālī, kas pieslēdz volai kā MCP serveri, un pēc tam parastā teikumā redaktoram uzrakstīt, ko vēlaties - „piezvani man uz numuru...“, „nosūti SMS...“. Redaktors pats izvēlas pareizo rīku no 110, ko volai piedāvā ar MCP, un to izsauc. Nav jālasa API dokumentācija, nav jāraksta sava telefonijas koda.

Kas ir MCP un kāpēc tas darbojas bez koda rakstīšanas?

MCP (Model Context Protocol) ir veids, kā AI redaktors darba gaitā var pieprasīt ārēja pakalpojuma rīku un uzreiz to izmantot, nevis tikai par to runāt. Tiklīdz volai ir pieslēgts, redaktors redz visus 110 rīkus (zvanīt, sūtīt SMS, nopirkt numuru, izveidot aģentu un citus) un pēc katra apraksta pats zina, kurš no tiem der tam, ko tikko uzrakstījāt. Kam vajag detalizētu principa skaidrojumu, to atradīs rakstā Kas ir MCP serveris un kā tas saistīts ar telefoniju; šeit galvenais jautājums ir, kā dot Claude Code tālruņa numuru un to uzreiz izmēģināt.

Instalēšana Claude Code

Viena komanda terminālī, un gatavs:

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

API atslēgu (vk_JUSU_ATSLEGA) atradīsiet volai portālā sadaļā API un MCP pēc tam, kad esat reģistrējies. Bez derīgas atslēgas serveris pieprasījumu noraidīs - redaktors par to pateiks jau pie pirmā ziņojuma.

Cursor un citi redaktori

Tas pats serveris, cits pieraksta veids. Failā ~/.cursor/mcp.json (vai tikai viena projekta ietvaros failā .cursor/mcp.json) pievienojiet:

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

Windsurf, VS Code (Copilot) un Claude Desktop pieslēdzas pēc tā paša principa, tikai konfigurācijas faila forma ir nedaudz atšķirīga - precīzs pieraksts katram ir lapā MCP serveris.

Ja redaktors pēc pieslēgšanas nepiedāvā nevienu rīku: parasti iemesls ir viens no trim. Redaktors MCP serveru konfigurāciju parasti ielādē tikai startējot, tāpēc pēc pirmās saglabāšanas tam vajag restartu (vai vismaz loga vai projekta pārlādi). Pārbaudiet nokopēto atslēgu, vai tās sākumā vai beigās nav lieka atstarpe - terminālī un JSON failā tā ir neredzama, bet sabojā galveni Authorization. Un vai serveris vispār atbild, ātrāk pārbaudīsiet ar tālāk redzamo promptu - tiklīdz redaktors pats izsauc rīku, savienojums ir kārtībā.

Pirmais zvans ar vienu promptu

Pēc pieslēgšanas pietiek redaktoram ar saviem vārdiem uzrakstīt, ko vēlaties - piemēram, tieši tā:

• ›Piezvani man tūlīt uz numuru +420777123456 un izmēģini picērijas pasūtījumu līnijas lomu - es nevēlos šī iemesla dēļ veidot savu numuru vai aģentu.

No tā redaktors atpazīst rīku make_call un tā parametru systemPrompt - izmēģinājuma zvans bez numura iegādes vai iepriekšējas aģenta izveides. Zvans tiek veikts no volai kopīgā demonstrācijas numura - tieši šis numurs, nevis jūsu, ir redzams zvanāmā ekrānā, un zvans izmanto aģenta noklusējuma balsi, jo izmēģinājuma zvanam savu voiceId nosūtīt nevar. systemPrompt drīkst būt līdz 1200 rakstzīmēm garš, zvans tiek rēķināts pilnīgi parastā veidā, ieskaitot aģenta piemaksu (bez atlaides), un ir ierobežots līdz 3 izmēģinājuma zvaniem 24 stundu laikā uz vienu kontu - nosacījums ir apstiprināts e-pasts. Ja vēlaties zvanīt no sava numura ar savu aģentu, pasakiet to redaktoram tieši - viņš izsauks make_call ar parametru agentId parametra systemPrompt vietā.

Pirmā SMS ar vienu promptu

Tas pats princips darbojas arī ar īsziņām:

• ›Nosūti SMS uz numuru +420777123456, ka pasūtītais laiks tiek apstiprināts rītdienas priekšpusdienai.

Šoreiz redaktors paņems rīku send_sms - zem pārsega tieši tāds pats izsaukums, kādu paši rakstītu tieši REST API (POST /v1/messages {"to": "+420...", "body": "..."}), tikai bez koda rakstīšanas. Bez sava numura SMS tiek nosūtīta ar kopīgo sūtītāja vārdu SMSinfo tikai uz čehu (+420) vai slovāku (+421) numuru, un saņēmējs uz to nevar atbildēt - volai balss numuri SMS nesaņem. SMS saņemšanu un sūtīšanu no sava numura (tikai čehu numuriem) nodrošina papildpakalpojums mobilais numurs (290 kr bez PVN par 30 dienām, līdz 2 uz kontu), ko redaktors nopērk ar rīku buy_sms_number tikai pēc jūsu skaidras piekrišanas ar cenu, bet saņemtās ziņas nolasa ar rīku list_messages; verifikācijas kodu saņemšanu no pakalpojumiem mēs negarantējam. SMS saņemt un sūtīt no sava numura var arī „numurs zvaniem un SMS“: Prāgas fiksētā tīkla numurs par cenu 49 kr bez PVN par 30 dienām (tiek rēķināts tikai pēc aktivizēšanas, parasti 1 darbdienas laikā; līdz 2 uz kontu), uz kuru cilvēki var gan zvanīt, gan rakstīt un no kura aģents gan zvana, gan sūta SMS. Redaktors to pasūta ar rīku order_voice_sms_number tikai pēc jūsu skaidras piekrišanas ar cenu, ienākošos zvanus novirza ar rīku set_voice_sms_number_routing un SMS no tā sūta ar rīku send_sms ar lauku fromNumber (tikai čehu numuriem, bez piegādes paziņojumiem). Īsziņas tiek nosūtītas tikai pēc pirmās kredīta papildināšanas: sagaidīšanas kredīta pietiek izmēģinājuma zvaniem, bet SMS ne.

Ko vēl var likt izdarīt?

Tāpat darbojas jebkurš no 110 rīkiem - daži papildu piemēri:

• „Apkopo man pēdējos desmit zvanus - galvenokārt, vai starp tiem bija kaut kas steidzams.“ - rīks list_calls.
• „Pasaki man pašreizējo kredīta atlikumu un brīdini, ja tas sāk beigties.“ - rīks get_balance.
• „Izveido filiālei jaunu numuru un uzreiz piešķir tam aģentu, kas pieņems galdiņu rezervācijas.“ - rīki buy_number un create_agent pēc kārtas.

Pilna tabula ar visiem 110 rīkiem un aprakstu, kad redaktors tos izmanto, ir lapā MCP serveris - un lapā Integrācijas: Claude Code uzreiz ir arī daži gatavi promti tipiskiem uzdevumiem.

Vai ir droši dot redaktoram API atslēgu?

MCP tiek autorizēts ar to pašu API atslēgu kā REST API un ar to dalās arī tajā pašā limitā 60 pieprasījumu minūtē - kas šo atslēgu pārvalda, rīkojas jūsu konta vārdā tieši tāpat kā jūs: nopērk numuru, pieņem zvanu, nosūta īsziņu vai izveido aģentu, un tas viss tiek atrēķināts no jūsu kredīta.

Maksas darbībām (send_sms, make_call, buy_number, buy_sms_number) ir apzināti idempotentHint: false - otrs izsaukums nosūta otru SMS vai atrēķina otru summu, tāpēc labs redaktors tās pēc pārtraukuma pats neatkārto. Un pat ja prompts kļūdītos ar numuru, uz kuru zvanīt nevēlaties, ir vēl pēdējā aizsardzība: saraksts ar zvanu aizliegumu. Rīki add_to_dnc, list_dnc un remove_from_dnc sargā numurus, uz kuriem aģents (gan savs, gan iebūvētais) vairs zvanīt nedrīkst - tas attiecas uz zvaniem, nevis uz SMS, un to nevar apiet ne ar vienu promptu, ne ar API izsaukumu.

Katrs rīks papildus pasaka redaktoram jau iepriekš, kā uzvedas - vai tikai lasa (readOnlyHint), vai ir neatgriezenisks (destructiveHint), vai to nedrīkst bezdomīgi atkārtot (maksas darbībām nav idempotences pazīmes). Pateicoties tam, labs redaktors pirms aģenta dzēšanas vai neizmantota relay lease atcelšanas pajautās, bet lasīšanas rīkus (kredīta atlikumu, zvanu vēsturi, numuru pārskatu) palaiž tieši, nejautājot - ar to neko neriskējat.

Divas lietas MCP apzināti nemāk: nopirkta numura (DELETE /v1/numbers/{e164}) un SMS numura (DELETE /v1/sms-numbers/{e164}) atbrīvošana notiek tikai caur portālu vai REST API, lai viens nepareizi saprasts teikums neatstātu jūs bez numura, kas jums uzdrukāts uz skrejlapas, un nodokļu dokumenta PDF tiek lejupielādēts tikai caur REST (pašus dokumentus lasa rīki list_billing_documents un get_billing_document, norēķinu datus maina update_billing_details). Tāpat zvana ieraksta lejupielādei nav sava rīka - tā ir audio datne, nevis JSON, un to lejupielādē ar to pašu API atslēgu tieši no REST.

Visa procedūra ar atsevišķu rīku drošības īpašībām (par ko redaktors pirms darbības pajautās) ir lapā MCP serveris, minūšu un SMS cenas cenrādī.

Kas tālāk