Kako dati Claude Codeu telefonski broj preko MCP-a

Želite da Claude Code (ili Cursor, Windsurf, VS Code) može nazvati i poslati SMS samo iz prompta, bez pisanja koda? Dovoljna je jedna naredba u terminalu koja povezuje volai kao MCP poslužitelj, a zatim editoru običnom rečenicom napišete što želite - „nazovi me na...“, „pošalji SMS...“. Editor sam odabire pravi alat među 110 koje volai nudi preko MCP-a i poziva ga. Bez čitanja API dokumentacije, bez vlastitog koda za telefoniranje.

Što je MCP i zašto to radi bez pisanja koda?

MCP (Model Context Protocol) je način na koji AI editor tijekom rada može zatražiti alat od vanjskog servisa i odmah ga upotrijebiti - a ne samo razgovarati o njemu. Čim je volai povezan, editor vidi svih 110 alata (nazvati, poslati SMS, kupiti broj, stvoriti agenta i druge) i prema opisu svakoga sam prepoznaje koji odgovara onome što ste upravo napisali. Tko želi detaljno objašnjenje načela, naći će ga u članku Što je MCP poslužitelj i kako je povezan s telefoniranjem; ovdje je glavno kako Claude Codeu dati telefonski broj i odmah to isprobati.

Instalacija u Claude Code

Jedna naredba u terminalu i gotovo:

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

API ključ (vk_VAS_KLJUC) naći ćete u portalu volai u odjeljku API i MCP nakon što se registrirate. Bez valjanog ključa poslužitelj odbija zahtjev - editor će vam to reći već pri prvoj poruci.

Cursor i ostali editori

Isti poslužitelj, drukčiji zapis. U ~/.cursor/mcp.json (ili u .cursor/mcp.json samo za jedan projekt) upišete:

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

Windsurf, VS Code (Copilot) i Claude Desktop povezuju se istim načelom, samo s nešto drukčijim oblikom konfiguracijske datoteke - točan zapis za svakoga od njih nalazi se na stranici MCP poslužitelj.

Ako editor nakon povezivanja ne ponudi nijedan alat: obično je riječ o jednoj od triju stvari. Editor konfiguraciju MCP poslužitelja obično učitava samo pri pokretanju, pa mu nakon prvog spremanja treba ponovno pokretanje (ili barem ponovno učitavanje prozora ili projekta). Provjerite ima li kopirani ključ na početku ili na kraju suvišan razmak - u terminalu i u JSON datoteci je nevidljiv, ali zaglavlje Authorization čini neispravnim. A odgovara li poslužitelj uopće, najbrže ćete provjeriti upravo promptom nešto niže - čim editor sam pozove alat, veza je u redu.

Prvi poziv jednim promptom

Nakon povezivanja editoru svojim riječima napišete što želite - na primjer upravo ovo:

• ›Nazovi me odmah na +420777123456 i isprobaj ulogu linije za narudžbe u pizzeriji - ne želim zbog toga otvarati vlastiti broj ni agenta.

Editor iz toga prepoznaje alat make_call i njegov parametar systemPrompt - probni poziv bez potrebe da kupujete broj ili unaprijed stvarate agenta. Poziva se sa zajedničkog demo broja volai - upravo taj broj, a ne vaš vlastiti, vidi pozvana osoba na zaslonu, a razgovor se odvija na zadanom glasu agenta jer se vlastiti voiceId kod probnog poziva ne može poslati. systemPrompt smije imati najviše 1200 znakova, poziv se naplaćuje sasvim uobičajeno, uključujući agentov dodatak (bez popusta), a ograničen je na najviše 3 probna poziva u 24 sata po računu - preduvjet je potvrđena e-pošta. Ako želite zvati sa svog broja preko vlastitog agenta, recite to editoru izravno - pozvat će make_call s agentId umjesto systemPrompt.

Prvi SMS jednim promptom

Isto načelo vrijedi i za tekstualne poruke:

• ›Pošalji SMS na +420777123456 da se naručeni termin potvrđuje za sutra prijepodne.

Ovaj put editor poseže za send_sms - ispod haube potpuno isti poziv koji biste sami napisali izravno na REST API (POST /v1/messages {"to": "+420...", "body": "..."}), samo bez pisanja koda. Bez vlastitog broja SMS ide preko zajedničkog imena SMSinfo samo na češki (+420) ili slovački (+421) broj i primatelj ne može odgovoriti - glasovni brojevi volai ne primaju SMS. Primanje SMS-ova i slanje s vlastitog broja (samo na češke brojeve) omogućuje dodatak mobilni broj (290 kr bez PDV-a na 30 dana, najviše 2 po računu), koji editor kupuje alatom buy_sms_number tek nakon vašeg izričitog pristanka na cijenu, a primljene poruke čita alatom list_messages; verifikacijske kodove od servisa ne jamčimo. SMS-ove može primati i slati s vlastitog broja i „broj za pozive i SMS“: praška fiksna linija za 49 kr bez PDV-a na 30 dana (naplaćuje se tek nakon aktivacije, obično u roku od 1 radnog dana; najviše 2 po računu), na koju ljudi mogu nazvati i pisati, a s koje agent zove i šalje SMS. Editor je naručuje alatom order_voice_sms_number tek nakon vašeg izričitog pristanka na cijenu, dolazne pozive usmjerava preko set_voice_sms_number_routing a SMS s nje šalje alatom send_sms s poljem fromNumber (samo na češke brojeve, bez potvrda isporuke). Tekstualne poruke idu tek nakon prve dopune stanja: dobrodošlica na stanju dovoljna je za probne pozive, ali ne za SMS.

Što još možete prepustiti editoru?

Na isti način radi svaki od 110 alata - još nekoliko primjera:

• „Sažmi mi posljednjih deset poziva - ponajprije je li među njima bilo nešto hitno.“ - alat list_calls.
• „Reci mi trenutačno stanje i upozori me ako ponestaje.“ - alat get_balance.
• „Otvori novi broj za podružnicu i odmah mu dodijeli agenta koji će primati rezervacije stolova.“ - alati buy_number i create_agent jedan za drugim.

Cjelovita tablica svih 110 alata s opisom kada ih editor koristi nalazi se na stranici MCP poslužitelj - a stranica Integracije: Claude Code ima i nekoliko gotovih promptova za tipične zadatke.

Je li sigurno editoru dati API ključ?

MCP se autorizira istim API ključem kao i REST API i dijeli s njim isto ograničenje od 60 zahtjeva u minuti - tko ima taj ključ, djeluje za vaš račun potpuno jednako kao vi: kupi broj, podigne slušalicu, pošalje poruku ili stvori agenta, a sve se skida s vašeg stanja.

Plaćene radnje (send_sms, make_call, buy_number, buy_sms_number) namjerno imaju idempotentHint: false - drugi poziv šalje drugi SMS ili skida drugi iznos, pa ih dobar editor nakon ispada sam ne ponavlja. A čak i kad bi prompt zalutao na broj koji ne želite zvati, tu je posljednje osiguranje: popis zabrane pozivanja. Alati add_to_dnc, list_dnc i remove_from_dnc čuvaju brojeve koje agent (vlastiti i ugrađeni) više ne smije nazvati - vrijedi za pozive, ne za SMS, a ne može se zaobići nikakvim promptom ni API pozivom.

Svaki alat uz to unaprijed javlja editoru kako se ponaša - samo li čita (readOnlyHint), je li nepovratan (destructiveHint) ili se ne smije bezrazložno ponavljati (nema idempotentne oznake kod plaćenih radnji). Zahvaljujući tome dobar editor pita prije nego što obriše agenta ili otkaže neiskorišteni relay lease, a alate za čitanje (stanje, povijest poziva, popis brojeva) pokreće odmah bez pitanja - time ništa ne riskirate.

Dvije stvari MCP namjerno ne zna: otpuštanje kupljenog broja (DELETE /v1/numbers/{e164}) i mobilnog broja (DELETE /v1/sms-numbers/{e164}) ide samo preko portala ili REST API-ja, da jedna krivo shvaćena rečenica ne bi oduzela broj koji imate otisnut na letku, a PDF računa preuzima se samo preko REST-a (same račune čitaju alati list_billing_documents i get_billing_document, podatke za naplatu mijenja update_billing_details). Slično, preuzimanje snimke poziva nema vlastiti alat - to je audio datoteka, a ne JSON, i preuzima se istim API ključem izravno s REST-a.

Cijeli postupak sa sigurnosnim svojstvima pojedinih alata (oko čega editor pita prije nego što nešto učini) nalazi se na stranici MCP poslužitelj, cijene po minuti i SMS-u na cjeniku.

Što dalje