Jak dát Claude Code telefonní číslo přes MCP

Chceš, aby Claude Code (nebo Cursor, Windsurf, VS Code) uměl zavolat a poslat SMS jen z promptu, bez psaní kódu? Stačí jeden příkaz v terminálu, který připojí volai jako MCP server, a pak editoru napsat obyčejnou větou, co chceš - „zavolej mi na...“, „pošli SMS...“. Editor si sám vybere správný nástroj z 31, které volai přes MCP nabízí, a zavolá ho. Žádné čtení API dokumentace, žádný vlastní kód pro telefonování.

Co je MCP a proč to funguje bez psaní kódu?

MCP (Model Context Protocol) je způsob, jak si AI editor umí za běhu vyžádat nástroj z cizí služby a rovnou ho použít - ne si o něm jen povídat. Jakmile je volai připojené, editor vidí všech 31 nástrojů (zavolat, poslat SMS, koupit číslo, založit agenta a další) a podle popisu každého z nich sám pozná, který se hodí na to, co jsi právě napsal. Kdo chce detailní vysvětlení principu, najde ho v článku Co je MCP server a jak souvisí s telefonováním; tady jde hlavně o to, jak dát Claude Code telefonní číslo a hned si to vyzkoušet.

Instalace do Claude Code

Jeden příkaz v terminálu a je hotovo:

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

API klíč (vk_TVUJ_KLIC) najdeš v portálu volai v sekci API a MCP, poté co se zaregistruješ. Bez platného klíče server požadavek odmítne - editor ti to při první zprávě rovnou řekne.

Cursor a další editory

Stejný server, jiný zápis. Do ~/.cursor/mcp.json (nebo do .cursor/mcp.json jen pro jeden projekt) vložíš:

{
  "mcpServers": {
    "volai": {
      "url": "https://volai.cz/mcp",
      "headers": {
        "Authorization": "Bearer vk_TVUJ_KLIC"
      }
    }
  }
}

Windsurf, VS Code (Copilot) a Claude Desktop se připojují stejným principem, jen s trochu jiným tvarem konfiguračního souboru - přesné znění pro každý z nich je na stránce MCP server.

Když editor po připojení žádný nástroj nenabídne: bývá to jedna ze tří věcí. Editor si konfiguraci MCP serverů obvykle načte jen při startu, takže po prvním uložení potřebuje restart (nebo aspoň znovunačtení okna či projektu). Zkopírovaný klíč zkontroluj na mezeru navíc na začátku nebo na konci - v terminálu i v JSON souboru je neviditelná, ale hlavičku Authorization zneplatní. A jestli server vůbec odpovídá, nejrychleji ověříš přesně tím promptem o kus níž - jakmile editor sám zavolá nástroj, je připojení v pořádku.

První hovor jedním promptem

Po připojení stačí editoru napsat vlastními slovy, co chceš - třeba přesně tohle:

• ›Zavolej mi hned na +420777123456 a zkus roli objednávkové linky pizzerie - nechci si kvůli tomu zakládat vlastní číslo ani agenta.

Editor z toho pozná nástroj make_call a jeho parametr systemPrompt - zkušební hovor bez nutnosti kupovat číslo nebo zakládat agenta předem. Volá se ze sdíleného demo čísla volai - přesně tohle číslo, ne tvoje vlastní, uvidí volaný na displeji, a poběží na výchozím hlase agenta, protože vlastní voiceId u zkušebního hovoru poslat nejde. systemPrompt smí mít nejvýš 1200 znaků, hovor se účtuje úplně normálně včetně agentní přirážky (žádná sleva) a je omezený na nejvýš 3 zkušební hovory za 24 hodin na účet - ověřený e-mail je podmínkou. Chceš-li volat z vlastního čísla přes vlastního agenta, řekni editoru rovnou to - zavolá make_call s agentId místo systemPrompt.

První SMS jedním promptem

Stejný princip funguje na textovky:

• ›Pošli SMS na +420777123456, že se objednaný termín potvrzuje na zítřejší dopoledne.

Tentokrát editor sáhne po send_sms - pod kapotou přesně stejné volání, jaké bys napsal sám přímo na REST API (POST /v1/messages {"to": "+420...", "body": "..."}), jen bez psaní kódu. SMS jde jen na české (+420) nebo slovenské (+421) číslo a jen ODCHOZÍ - příchozí SMS volai nedokáže přijmout ani přeposlat, žádný prompt to nezmění.

Co dalšího si můžeš nechat udělat?

Stejným způsobem funguje kterýkoli z 31 nástrojů - pár dalších ukázek:

• „Shrň mi posledních deset hovorů - hlavně jestli mezi nimi bylo něco urgentního.“ - nástroj list_calls.
• „Řekni mi aktuální stav kreditu a pošli varování, kdyby docházel.“ - nástroj get_balance.
• „Založ nové číslo pro pobočku a rovnou mu přiřaď agenta, co bude přijímat rezervace stolů.“ - nástroje buy_number a create_agent za sebou.

Plná tabulka všech 31 nástrojů s popisem, kdy je editor použije, je na stránce MCP server - a stránka Integrace: Claude Code má rovnou i pár hotových promptů na typické úkoly.

Je bezpečné dát editoru API klíč?

MCP se autorizuje stejným API klíčem jako REST API a sdílí s ním i stejný limit 60 požadavků za minutu - kdo ten klíč má, jedná za tvůj účet úplně stejně jako ty: koupí číslo, zvedne telefon, odešle textovku nebo založí agenta, a všechno se to strhne z tvého kreditu.

Placené akce (send_sms, make_call, buy_number) mají schválně idempotentHint: false - druhé volání pošle druhou SMS nebo strhne druhou částku, takže je dobrý editor po výpadku sám neopakuje. A i kdyby prompt zabloudil na číslo, které volat nechceš, je tu poslední pojistka: seznam nevolat. Nástroje add_to_dnc, list_dnc a remove_from_dnc hlídají čísla, na která agent (vlastní i zabudovaný) už nesmí zavolat - platí to pro hovory, ne pro SMS, a nejde to obejít žádným promptem ani API voláním.

Každý nástroj navíc editoru dopředu řekne, jak se chová - jestli jen čte (readOnlyHint), jestli je nevratný (destructiveHint), nebo jestli se nesmí bez rozmyslu opakovat (žádný idempotentní příznak u placených akcí). Díky tomu se dobrý editor zeptá, než smaže agenta nebo zruší nevyužitý relay lease, a čtecí nástroje (zůstatek, historie hovorů, výpis čísel) spustí rovnou bez ptaní - nic tím neriskuješ.

Dvě věci MCP schválně neumí: uvolnění zakoupeného čísla (DELETE /v1/numbers/{e164}) jde jen přes portál nebo REST API, ať jedna špatně pochopená věta nepřipraví o číslo, které máš vytištěné na letáku, a daňové doklady s fakturačními údaji bydlí jen v portálu pod Kredit a Nastavení. Podobně nemá vlastní nástroj stažení nahrávky hovoru - to je zvukový soubor, ne JSON, a stahuje se stejným API klíčem přímo z REST.

Celý postup i s bezpečnostními vlastnostmi jednotlivých nástrojů (co se editor zeptá dřív, než to udělá) je na stránce MCP server, ceny za minutu a SMS na ceníku.

Co dál