Claude Codu dodelite telefonsko številko prek MCP

Želite, da Claude Code (ali Cursor, Windsurf, VS Code) pokliče ali pošlje SMS neposredno iz poziva, ne da bi pisali kodo? En ukaz v terminalu poveže volai kot strežnik MCP, nato pa urejevalniku v navadnem jeziku povete, kaj želite - „pokliči me na ...“, „pošlji SMS na ...“. Urejevalnik sam izbere ustrezno orodje med 110, ki jih volai ponuja prek MCP, in ga pokliče. Brez branja dokumentacije API, brez lastne telefonske kode.

Kaj je MCP in zakaj to deluje brez kode?

MCP (Model Context Protocol) je način, kako urejevalnik z umetno inteligenco med delom prevzame orodje zunanje storitve in ga dejansko uporabi, namesto da bi o njem le govoril. Ko je volai povezan, urejevalnik vidi vseh 110 orodij (klicanje, pošiljanje SMS, nakup številke, ustvarjanje agenta in drugo) in glede na opis sam izbere pravo za tisto, kar ste pravkar vtipkali. Globlja razlaga načela je v članku Kaj je strežnik MCP in kako je povezan s telefoniranjem; tukaj gre predvsem za to, kako Claude Codu dodeliti telefonsko številko in jo takoj preizkusiti.

Namestitev v Claude Code

En ukaz v terminalu in končano:

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

Ključ API (vk_VAS_KLJUC) najdete v portalu volai pod API in MCP, ko ste registrirani. Brez veljavnega ključa strežnik zahtevo zavrne - urejevalnik vam to sporoči že ob prvem sporočilu.

Cursor in drugi urejevalniki

Isti strežnik, drug zapis. V ~/.cursor/mcp.json (ali v .cursor/mcp.json, če velja le za en projekt) dodajte naslednje:

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

Windsurf, VS Code (Copilot) in Claude Desktop se povežejo po istem načelu, le oblika konfiguracijske datoteke je nekoliko drugačna - natančno besedilo za vsakega od njih je na strani Strežnik MCP.

Če urejevalnik po povezavi ne pokaže nobenega orodja: navadno gre za eno od treh stvari. Urejevalnik konfiguracijo strežnikov MCP praviloma prebere le ob zagonu, zato je po prvem shranjevanju potreben ponovni zagon (ali vsaj ponovno nalaganje okna ali projekta). Preverite, da kopirani ključ na začetku ali koncu nima odvečnega presledka - v terminalu in v datoteki JSON je nevidno, a naredi glavo Authorization neuporabno. Najhitreje pa preverite, ali strežnik odgovarja, prav s pozivom v nadaljevanju - ko urejevalnik sam pokliče orodje, je povezava v redu.

Vaš prvi klic z enim pozivom

Po povezavi urejevalniku povejte, kaj želite, svojimi besedami - na primer prav to:

• ›Takoj me pokliči na +420777123456 in poskusi vlogo naročniške linije picerije - za to ne želim ustvarjati lastne številke ne lastnega agenta.

Urejevalnik iz tega prepozna orodje make_call in parameter systemPrompt - preizkusni klic, pri katerem vam ni treba kupiti številke ali vnaprej ustvariti agenta. Klic poteka prek skupne demo številke volai - prav to številko, ne vaše, vidi poklicana oseba na zaslonu - in uporablja privzeti glas agenta, ker lastnega voiceId pri preizkusnem klicu ni mogoče podati. systemPrompt je lahko dolg največ 1200 znakov, klic se obračuna povsem običajno, vključno z doplačilom za agenta (brez popusta), in je omejen na največ 3 preizkusne klice v 24 urah na račun - potreben je preverjen e-poštni naslov. Če želite klicati z lastne številke prek lastnega agenta, to preprosto povejte urejevalniku - ta pokliče make_call z agentId namesto systemPrompt.

Vaš prvi SMS z enim pozivom

Isto načelo deluje za sporočila SMS:

• ›Pošlji SMS na +420777123456, da je termin potrjen za jutri zjutraj.

Tokrat urejevalnik poseže po orodju send_sms - v ozadju je to popolnoma enak klic, kot bi ga sami napisali neposredno na REST API (POST /v1/messages {"to": "+420...", "body": "..."}), le brez pisanja kode. Brez lastne številke gre SMS pod skupnim imenom pošiljatelja SMSinfo, le na češko (+420) ali slovaško (+421) številko, prejemnik pa ne more odgovoriti - glasovne številke volai ne prejemajo SMS. Prejemanje SMS in pošiljanje z lastne številke (le na češke številke) omogoča dodatek mobilna številka (290 CZK brez DDV na 30 dni, največ 2 na račun): urejevalnik ga kupi z buy_sms_number šele, ko izrecno pritrdite ceni, prejeta sporočila pa prebere z list_messages; potrditvenih kod storitev ne zagotavljamo. Prejemanje SMS in pošiljanje z lastne številke omogoča tudi „številka za klice in SMS“: stalna praška številka za 49 CZK brez DDV na 30 dni (znesek se odpiše šele po aktivaciji, običajno v 1 delovnem dnevu; največ 2 na račun), na katero lahko ljudje kličejo in pošiljajo SMS ter s katere agent kliče in pošilja SMS. Urejevalnik jo naroči z order_voice_sms_number šele, ko izrecno pritrdite ceni, dohodne klice preusmeri z set_voice_sms_number_routing in z nje pošilja SMS z send_sms s poljem fromNumber (le na češke številke, brez potrdil o dostavi). SMS-i delujejo šele po prvem polnjenju dobroimetja: pozdravno dobroimetje zadošča za preizkusne klice, ne pa za SMS.

Kaj še lahko zahtevate?

Na enak način deluje vsako od 110 orodij - še nekaj primerov:

• „Povzemi mojih zadnjih deset klicev - predvsem, ali je bilo med njimi kaj nujnega.“ - orodje list_calls.
• „Povej mi, koliko dobroimetja imam zdaj, in opozori me, če ga zmanjkuje.“ - orodje get_balance.
• „Ustvari novo številko za poslovalnico in nanjo takoj priključi agenta, ki sprejema rezervacije miz.“ - orodji buy_number in create_agent zaporedoma.

Celotna tabela vseh 110 orodij z opisom, kdaj jih urejevalnik uporablja, je na strani Strežnik MCP - stran Integracije: Claude Code pa vsebuje tudi nekaj pripravljenih pozivov za tipične naloge.

Ali je varno urejevalniku dati ključ API?

MCP avtorizira z istim ključem API kot REST API in si z njim deli tudi omejitev 60 zahtev na minuto - kdor ima ta ključ, v imenu vašega računa ravna povsem enako kot vi: kupi številko, pokliče, pošlje SMS ali ustvari agenta, vse pa se odpiše z vašega dobroimetja.

Plačljiva dejanja (send_sms, make_call, buy_number, buy_sms_number) imajo namenoma idempotentHint: false - drugi klic pošlje drugi SMS ali odpiše drugi znesek, zato jih dober urejevalnik po izpadu sam ne ponavlja. Če pa bi poziv vendarle zašel na številko, ki je ne želite klicati, obstaja še zadnja zaščita: seznam prepovedanih klicev. Orodja add_to_dnc, list_dnc in remove_from_dnc varujejo številke, ki jih agent (vaš ali vgrajeni) ne sme več klicati - to velja za klice, ne za SMS, in ga ni mogoče zaobiti z nobenim pozivom ali klicem API.

Vsako orodje urejevalniku vnaprej tudi sporoči, kako se obnaša - ali samo bere (readOnlyHint), je nepovratno (destructiveHint) ali se ga ne sme brez premisleka ponavljati (pri plačljivih dejanjih ni zastavice idempotentnosti). Zato dober urejevalnik, preden izbriše agenta ali prekliče neuporabljen relay lease, vpraša, bralna orodja (stanje, zgodovina klicev, pregled številk) pa izvede takoj brez vprašanja - tako ne tvegate ničesar.

Dveh stvari MCP namenoma ne zna: sprostitev kupljene številke (DELETE /v1/numbers/{e164}) in mobilne številke (DELETE /v1/sms-numbers/{e164}) je mogoča le prek portala ali REST API, da vas ena narobe razumljena poved ne oropa številke, ki je natisnjena na vašem letaku, PDF davčnega dokumenta pa se prenaša le prek REST (same dokumente berejo orodja list_billing_documents in get_billing_document, podatke za račun spreminja update_billing_details). Tudi prenos posnetka klica nima lastnega orodja - gre za zvočno datoteko, ne za JSON, in se z istim ključem API pridobi neposredno prek REST.

Celoten postopek, vključno z varnostnimi lastnostmi posameznih orodij (o katerih urejevalnik najprej vpraša, preden karkoli stori), je na strani Strežnik MCP, cene na minuto in na SMS pa na strani s cenikom.

Kaj naprej