Napojení
MCP server
MCP (Model Context Protocol) je způsob, jak si AI editor - Claude Code, Cursor, Windsurf a další - 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 volai připojíš, stačí napsat editoru, co chceš („pošli SMS", „vytvoř agenta"), a on si sám vybere správný nástroj a zavolá ho - bez psaní kódu a bez čtení API dokumentace.
Instalace
Server běží na https://volai.cz/mcp, k ověření stačí API klíč z portálu - jak ho získat, popisuje první krok Quickstartu. Vyber si editor:
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"Nástroje
Všech 16 nástrojů volá stejnou servisní vrstvu jako REST API a portál - stejná pravidla, stejné ceny, stejné limity. Editor si podle popisu každého nástroje sám vybere ten správný, tobě stačí napsat, co chceš.
| Nástroj | Kdy ho AI použije |
|---|---|
get_balance | Zjištění aktuálního zůstatku kreditu - kolik zbývá utratit. |
list_numbers | Výpis telefonních čísel účtu a jejich směrování. |
search_available_numbers | Nabídka volných čísel k zakoupení, než se něco koupí. |
buy_number | Uživatel chce nové telefonní číslo pro svou aplikaci. |
set_number_routing | Přepnutí, kam číslo směruje hovory - na agenta, přesměrování, SIP nebo nic. |
get_sip_credentials | Uživatel chce číslo připojit do vlastního softphonu nebo PBX. |
send_sms | Odeslání textové zprávy na české nebo slovenské číslo. |
list_messages | Výpis historie odeslaných SMS. |
make_call | Zavolání na číslo (to) - zadá se právě jeden parametr: agentId (hovor povede hlasový agent) nebo from (přímé spojení dvou čísel bez agenta). |
list_calls | Výpis historie hovorů (příchozích i odchozích). |
get_call | Detail konkrétního hovoru včetně přepisu a shrnutí - typicky když má agent hovor okomentovat. |
create_agent | Vytvoření nového hlasového agenta podle popisu úkolu. |
list_agents | Výpis existujících agentů účtu. |
update_agent | Úprava promptu, hlasu nebo čísla u existujícího agenta. |
delete_agent | Smazání agenta, který se už nepoužívá. |
set_webhook | Nastavení URL, kam má volai posílat události (dokončený hovor, odeslaná SMS...). |
Vyzkoušej si
Až budeš mít MCP připojené, zkus editoru napsat některou z těchhle vět (klidně svými slovy - nejde o přesné znění):
- ›Kup mi telefonní číslo a nastav na něj agenta, který bude brát objednávky na kávu.
- ›Pošli SMS na +420777123456, že objednávka je hotová k vyzvednutí.
- ›Vypiš mi posledních 10 hovorů a stručně mi je shrň.
- ›Zjisti, kolik mi zbývá kreditu, a upozorni mě, jestli je to málo.
- ›Vytvoř agenta na krátký průzkum spokojenosti a rovnou mi na moje číslo zavolej, ať si to vyzkouším.
Bezpečnost
MCP se autorizuje stejným API klíčem jako REST API - kdo ho má, může tvým jménem utrácet kredit: kupovat čísla, volat, posílat SMS, vytvářet agenty.
Zacházej s klíčem jako s heslem
Nikdy ho nedávej do frontendového kódu, do repozitáře na GitHubu ani nikomu neposílej v čistém textu. Když ho někdo jiný uvidí, může utratit tvůj kredit, dokud nedojde.
Podezření na únik (nebo jen chuť klíč vyměnit) řeší jedno tlačítko: v portálu v sekci API a MCP klíč smaž - přestane fungovat okamžitě a nejde obnovit. Vytvoř si nový a aktualizuj ho v konfiguraci editoru.