Ako dať Claude Code telefónne číslo cez MCP

Chcete, aby Claude Code (alebo Cursor, Windsurf, VS Code) vedel zavolať a poslať SMS len z promptu, bez písania kódu? Stačí jeden príkaz v termináli, ktorý pripojí volai ako MCP server, a potom editoru obyčajnou vetou napísať, čo chcete - „zavolaj mi na...“, „pošli SMS...“. Editor si sám vyberie správny nástroj zo 110, ktoré volai cez MCP ponúka, a zavolá ho. Žiadne čítanie API dokumentácie, žiadny vlastný kód na telefonovanie.

Čo je MCP a prečo to funguje bez písania kódu?

MCP (Model Context Protocol) je spôsob, ako si AI editor vie za behu vyžiadať nástroj z cudzej služby a hneď ho použiť - nie sa o ňom len rozprávať. Hneď ako je volai pripojené, editor vidí všetkých 110 nástrojov (zavolať, poslať SMS, kúpiť číslo, založiť agenta a ďalšie) a podľa popisu každého z nich sám pozná, ktorý sa hodí na to, čo ste práve napísali. Kto chce podrobné vysvetlenie princípu, nájde ho v článku Čo je MCP server a ako súvisí s telefonovaním; tu ide hlavne o to, ako dať Claude Code telefónne číslo a hneď si to vyskúšať.

Inštalácia do Claude Code

Jeden príkaz v termináli a je hotovo:

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

API kľúč (vk_VAS_KLUC) nájdete v portáli volai v sekcii API a MCP po tom, čo sa zaregistrujete. Bez platného kľúča server požiadavku odmietne - editor vám to pri prvej správe rovno povie.

Cursor a ďalšie editory

Rovnaký server, iný zápis. Do ~/.cursor/mcp.json (alebo do .cursor/mcp.json len pre jeden projekt) vložíte:

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

Windsurf, VS Code (Copilot) a Claude Desktop sa pripájajú rovnakým princípom, len s trochu iným tvarom konfiguračného súboru - presné znenie pre každý z nich je na stránke MCP server.

Keď editor po pripojení žiadny nástroj neponúkne: býva to jedna z troch vecí. Editor si konfiguráciu MCP serverov zvyčajne načíta len pri štarte, takže po prvom uložení potrebuje reštart (alebo aspoň opätovné načítanie okna či projektu). Skopírovaný kľúč skontrolujte, či na začiatku alebo na konci nemá medzeru navyše - v termináli aj v JSON súbore je neviditeľná, ale hlavičku Authorization znehodnotí. A či server vôbec odpovedá, najrýchlejšie overíte presne tým promptom o kúsok nižšie - hneď ako editor sám zavolá nástroj, je pripojenie v poriadku.

Prvý hovor jedným promptom

Po pripojení stačí editoru napísať vlastnými slovami, čo chcete - napríklad presne toto:

• ›Zavolaj mi hneď na +420777123456 a skús rolu objednávkovej linky pizzerie - nechcem si kvôli tomu zakladať vlastné číslo ani agenta.

Editor z toho spozná nástroj make_call a jeho parameter systemPrompt - skúšobný hovor bez nutnosti kupovať číslo alebo vopred zakladať agenta. Volá sa zo zdieľaného demo čísla volai - presne toto číslo, nie vaše vlastné, uvidí volaný na displeji, a pobeží na predvolenom hlase agenta, pretože vlastné voiceId pri skúšobnom hovore poslať nejde. systemPrompt smie mať najviac 1200 znakov, hovor sa účtuje úplne normálne vrátane agentovej prirážky (žiadna zľava) a je obmedzený na najviac 3 skúšobné hovory za 24 hodín na účet - overený e-mail je podmienkou. Ak chcete volať z vlastného čísla cez vlastného agenta, povedzte to editoru rovno - zavolá make_call s agentId namiesto systemPrompt.

Prvá SMS jedným promptom

Rovnaký princíp funguje pri textovkách:

• ›Pošli SMS na +420777123456, že sa objednaný termín potvrdzuje na zajtrajšie dopoludnie.

Tentoraz editor siahne po send_sms - pod kapotou presne rovnaké volanie, aké by ste napísali sami priamo na REST API (POST /v1/messages {"to": "+420...", "body": "..."}), len bez písania kódu. Bez vlastného čísla ide SMS cez zdieľané meno SMSinfo len na české (+420) alebo slovenské (+421) číslo a príjemca na ňu neodpovie - hlasové čísla volai SMS neprijímajú. Príjem SMS a odosielanie z vlastného čísla (len na české čísla) vie doplnok mobilné číslo (290 kr bez DPH na 30 dní, najviac 2 na účet), ktorý si editor kúpi nástrojom buy_sms_number až po vašom výslovnom súhlase s cenou a prijaté správy prečíta nástrojom list_messages; overovacie kódy od služieb nezaručujeme. SMS vie prijímať a z vlastného čísla odosielať aj „číslo pre hovory aj SMS“: pražská pevná linka za 49 kr bez DPH na 30 dní (strhne sa až po aktivácii, zvyčajne do 1 pracovného dňa; najviac 2 na účet), na ktorú ľudia zavolajú aj napíšu a z ktorej agent volá aj posiela SMS. Editor ju objedná nástrojom order_voice_sms_number až po vašom výslovnom súhlase s cenou, prichádzajúce hovory nasmeruje cez set_voice_sms_number_routing a SMS z nej odosiela nástrojom send_sms s poľom fromNumber (len na české čísla, bez doručeniek). Textovky idú až po prvom dobití kreditu: uvítací kredit stačí na skúšobné hovory, na SMS nie.

Čo ďalšie si môžete nechať urobiť?

Rovnakým spôsobom funguje ktorýkoľvek zo 110 nástrojov - pár ďalších ukážok:

• „Zhrň mi posledných desať hovorov - hlavne či medzi nimi nebolo niečo urgentné.“ - nástroj list_calls.
• „Povedz mi aktuálny stav kreditu a pošli varovanie, keby dochádzal.“ - nástroj get_balance.
• „Založ nové číslo pre pobočku a hneď mu priraď agenta, ktorý bude prijímať rezervácie stolov.“ - nástroje buy_number a create_agent za sebou.

Plná tabuľka všetkých 110 nástrojov s popisom, kedy ich editor použije, je na stránke MCP server - a stránka Integrácie: Claude Code má hneď aj pár hotových promptov na typické úlohy.

Je bezpečné dať editoru API kľúč?

MCP sa autorizuje rovnakým API kľúčom ako REST API a zdieľa s ním aj rovnaký limit 60 požiadaviek za minútu - kto ten kľúč má, koná za váš účet úplne rovnako ako vy: kúpi číslo, zdvihne telefón, odošle textovku alebo založí agenta, a všetko sa to strhne z vášho kreditu.

Platené akcie (send_sms, make_call, buy_number, buy_sms_number) majú zámerne idempotentHint: false - druhé volanie pošle druhú SMS alebo strhne druhú sumu, takže ich dobrý editor po výpadku sám neopakuje. A aj keby prompt zablúdil na číslo, ktoré volať nechcete, je tu posledná poistka: zoznam nevolať. Nástroje add_to_dnc, list_dnc a remove_from_dnc strážia čísla, na ktoré agent (vlastný aj zabudovaný) už nesmie zavolať - platí to pre hovory, nie pre SMS, a nedá sa to obísť žiadnym promptom ani API volaním.

Každý nástroj navyše editoru vopred povie, ako sa správa - či len číta (readOnlyHint), či je nevratný (destructiveHint), alebo či sa nesmie bez rozmyslu opakovať (žiadny idempotentný príznak pri platených akciách). Vďaka tomu sa dobrý editor spýta predtým, než zmaže agenta alebo zruší nevyužitý relay lease, a čítacie nástroje (zostatok, história hovorov, výpis čísel) spustí rovno bez pýtania - nič tým neriskujete.

Dve veci MCP zámerne nevie: uvoľnenie zakúpeného čísla (DELETE /v1/numbers/{e164}) a mobilného čísla (DELETE /v1/sms-numbers/{e164}) ide len cez portál alebo REST API, aby jedna zle pochopená veta nepripravila o číslo, ktoré máte vytlačené na letáku, a PDF daňového dokladu sa sťahuje len cez REST (doklady samotné čítajú nástroje list_billing_documents a get_billing_document, fakturačné údaje mení update_billing_details). Podobne nemá vlastný nástroj stiahnutie nahrávky hovoru - to je zvukový súbor, nie JSON, a sťahuje sa rovnakým API kľúčom priamo z REST.

Celý postup aj s bezpečnostnými vlastnosťami jednotlivých nástrojov (na čo sa editor spýta skôr, než to urobí) je na stránke MCP server, ceny za minútu a SMS na cenníku.

Čo ďalej