Как да дадете на Claude Code телефонен номер през MCP

Искате Claude Code (или Cursor, Windsurf, VS Code) да може да се обади по телефона или да изпрати SMS направо от промпт, без да пишете код? Една команда в терминала свързва volai като MCP сървър, а после е достатъчно с обикновени думи да кажете на редактора какво да направи - „обади ми се на...“, „изпрати SMS на...“. Редакторът сам избира подходящия инструмент от 110-те, които volai предоставя през MCP, и го извиква. Без четене на документацията на API, без собствен код за телефониране.

Какво е MCP и защо работи без код?

MCP (Model Context Protocol) е начинът, по който AI редакторът по време на работа взема инструмент от външна услуга и реално го използва, вместо само да говори за него. Когато volai е свързан, редакторът вижда всичките 110 инструмента (обаждане, изпращане на SMS, купуване на номер, създаване на агент и други) и по описанията им сам разпознава кой пасва на току-що написаното. По-подробно обяснение на самата идея ще намерите в статията Какво е MCP сървър и как се свързва с телефонирането; тук става дума главно за това как да дадете на Claude Code телефонен номер и веднага да го изпробвате.

Инсталиране в Claude Code

Една команда в терминала и готово:

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

API ключът (vk_VASHIYAT_KLYUCH) ще намерите в портала на volai в раздела API и MCP, след регистрация. Без валиден ключ сървърът ще отхвърли заявката - редакторът ще Ви каже това веднага при първото съобщение.

Cursor и други редактори

Същият сървър, различен запис. В ~/.cursor/mcp.json (или в .cursor/mcp.json само за един проект) поставяте:

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

Windsurf, VS Code (Copilot) и Claude Desktop се свързват по същия принцип, само че конфигурационният файл има малко по-различна форма - точният запис за всеки от тях е на страницата MCP сървър.

Когато след свързването редакторът не показва нито един инструмент: обикновено причината е една от три неща. Редакторите по правило зареждат конфигурацията на MCP сървърите само при стартиране, така че след първия запис е нужно рестартиране (или поне презареждане на прозореца или проекта). Копираният ключ трябва да се провери за излишен интервал в началото или в края - в терминала и във файла JSON той е невидим, а обезсилва заглавката Authorization. А дали сървърът изобщо отговаря, най-бързо ще покаже точно този промпт малко по-надолу - щом редакторът сам извика инструмент, връзката работи.

Първо обаждане с един промпт

След свързването е достатъчно да кажете на редактора със свои думи какво искате - например точно така:

• ›Обади ми се сега на +420777123456 и се превъплъти в телефонна линия на пицария, която приема поръчки - не искам да създавам собствен номер или агент само за това.

Редакторът разпознава в това инструмента make_call с параметър systemPrompt - пробно обаждане без предварително конфигуриран номер и агент. Обажда се от общия демо номер на volai - именно той се показва на дисплея на човека, на когото се звъни, а не Вашият номер - и използва стандартния глас на агента, защото в пробното обаждане не може да се подаде собствен voiceId. systemPrompt е ограничен до 1200 знака, обаждането се таксува напълно нормално, включително добавката за агент (без отстъпка), а на акаунт се падат най-много 3 пробни обаждания за 24 часа - изисква се потвърден имейл адрес. Ако вместо това искате да се обадите от собствения си номер през собствения си агент, просто кажете това на редактора - той ще извика make_call с agentId вместо systemPrompt.

Първи SMS с един промпт

Същата идея работи и при текстовите съобщения:

• ›Изпрати SMS на +420777123456, че часът е потвърден за утре сутрин.

Този път редакторът посяга към send_sms - отдолу това е точно същото извикване, което бихте написали сами спрямо REST API (POST /v1/messages {"to": "+420...", "body": "..."}), само че без нито един ред код. Без собствен номер SMS-ът излиза под общото име на подателя SMSinfo, само към чешки (+420) или словашки (+421) номер, а получателите не могат да отговорят - гласовите номера на volai не приемат SMS. Приемането на SMS и изпращането от собствен номер (само към чешки номера) се осигуряват от добавката мобилен номер (290 CZK без ДДС за 30 дни, най-много 2 на акаунт): редакторът я купува през buy_sms_number едва след изричното Ви съгласие с цената, а получените съобщения чете през list_messages; верификационни кодове от услуги не гарантираме. номер за обаждания и SMS също приема SMS и изпраща от собствен номер: пражки стационарен номер за 49 CZK без ДДС за 30 дни (начислява се след активиране, обикновено до 1 работен ден; най-много 2 на акаунт), на който може да се звъни и да се изпращат SMS и от който Вашият агент извършва обаждания и изпраща SMS. Редакторът го поръчва през order_voice_sms_number едва след изричното Ви съгласие с цената, насочва входящите обаждания през set_voice_sms_number_routing и изпраща от него SMS през send_sms с полето fromNumber (само към чешки номера, без отчети за доставка). SMS-ите работят едва след първото зареждане на баланса: приветственият баланс стига за пробни обаждания, не за SMS.

За какво друго можете да помолите?

Същият модел работи за всеки от 110-те инструмента - още няколко примера:

• „Прегледай последните ми десет обаждания и ми кажи кои наистина изискват вниманието ми.“ - инструментът list_calls.
• „Кажи ми текущото състояние на баланса ми и ме предупреди, ако е нисък.“ - инструментът get_balance.
• „Създай номер за новия клон и свържи към него агент, който приема резервации на маси.“ - buy_number и create_agent, един след друг.

Пълната таблица на всичките 110 инструмента с описание кога редакторът използва всеки от тях е на страницата MCP сървър - а страницата Интеграция с Claude Code има няколко готови промпта за типични задачи.

Безопасно ли е да дадете на редактора API ключ?

MCP се удостоверява със същия API ключ като REST API и споделя с него лимита от 60 заявки в минута - който има този ключ, действа в акаунта точно като Вас: купува номер, извършва обаждане, изпраща SMS или създава агент, а всичко това се плаща от Вашия баланс.

Платените действия (send_sms, make_call, buy_number, buy_sms_number) са нарочно означени с idempotentHint: false - повторното извикване изпраща втори SMS или начислява втора сума, така че добре работещият редактор не ги повтаря сам след изтичане на времето. А дори промптът някога да се отклони към номер, на който не искате да звъните, има още една защита: списък с номера, на които не бива да се звъни. Инструментите add_to_dnc, list_dnc и remove_from_dnc защитават номера, на които никой агент - нито вграденият, нито Вашият собствен - вече не може да се обади. Отнася се за обажданията, не за SMS, и никакъв промпт или извикване на API не може да я заобиколи.

Всеки инструмент предварително съобщава на редактора и как се държи - дали само чете (readOnlyHint), дали е необратим (destructiveHint), дали не бива да се повтаря необмислено (липсва подсказка за идемпотентност при платените действия). Затова добрият редактор пита, преди да изтрие агент или да отмени неизползван релей лиз, а инструментите само за четене (баланс, история на обажданията, списък с номера) просто се изпълняват без въпрос - там няма какво да се загуби.

Две неща MCP нарочно не може: освобождаването на купен номер (DELETE /v1/numbers/{e164}) или мобилен номер (DELETE /v1/sms-numbers/{e164}) става само през портала или REST API, за да не Ви струва едно неправилно разбрано изречение номера, отпечатан на листовка, а PDF на данъчната фактура се изтегля само през REST (самите фактури се четат през list_billing_documents и get_billing_document, данните за фактуриране се променят през update_billing_details). Изтеглянето на запис на разговор също няма собствен инструмент, по същата причина - това е аудио файл, не JSON, и се изтегля със същия API ключ направо от REST.

Пълното описание, заедно със свойствата за сигурност на всеки инструмент (за което добрият клиент пита преди действие), е на страницата MCP сървър; ставките за минута и за SMS са на страницата Цени.

Какво следва