Cum îi dați lui Claude Code un număr de telefon prin MCP

Doriți ca Claude Code (sau Cursor, Windsurf, VS Code) să poată suna și trimite SMS-uri direct dintr-un prompt, fără să scrieți cod? Este suficientă o singură comandă în terminal, care conectează volai ca server MCP, apoi îi spuneți editorului pe înțeles ce doriți - „sună-mă la...”, „trimite un SMS la...”. Editorul alege singur instrumentul potrivit dintre cele 110 pe care volai le oferă prin MCP și îl apelează. Nu citiți documentația API și nu scrieți cod propriu pentru telefonie.

Ce este MCP și de ce funcționează fără cod?

MCP (Model Context Protocol) este modul în care un editor AI poate cere în timpul rulării un instrument de la un serviciu extern și îl poate folosi pe loc, nu doar discuta despre el. De îndată ce volai este conectat, editorul vede toate cele 110 instrumente (a suna, a trimite SMS, a cumpăra un număr, a crea un agent și altele) și, după descrierea fiecăruia, își dă seama singur care se potrivește cu ceea ce ați scris. Cine dorește o explicație detaliată a principiului o găsește în articolul Ce este un server MCP și cum se leagă de telefonie; aici este vorba mai ales despre cum îi dați lui Claude Code un număr de telefon și îl puteți încerca pe loc.

Instalarea în Claude Code

O singură comandă în terminal și gata:

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

Cheia API (vk_CHEIA_DVS) o găsiți în portalul volai, în secțiunea API și MCP, după ce vă înregistrați. Fără o cheie validă, serverul respinge cererea - editorul vă spune acest lucru chiar la primul mesaj.

Cursor și alte editoare

Același server, altă sintaxă. În ~/.cursor/mcp.json (sau în .cursor/mcp.json doar pentru un singur proiect) adăugați:

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

Windsurf, VS Code (Copilot) și Claude Desktop se conectează pe același principiu, doar cu o formă puțin diferită a fișierului de configurare - sintaxa exactă pentru fiecare se află pe pagina Server MCP.

Dacă editorul nu oferă niciun instrument după conectare: de obicei este vorba despre una dintre trei cauze. Editorul citește configurarea serverelor MCP de regulă doar la pornire, deci după prima salvare are nevoie de o repornire (sau măcar de reîncărcarea ferestrei ori a proiectului). Verificați dacă cheia copiată nu are un spațiu în plus la început sau la sfârșit - este invizibil în terminal și în fișierul JSON, dar strică antetul Authorization. Iar dacă serverul răspunde în general, se verifică cel mai repede cu promptul de mai jos - de îndată ce editorul apelează singur un instrument, conexiunea funcționează.

Primul apel, cu un singur prompt

După conectare, este suficient să scrieți editorului cu cuvintele dumneavoastră ce doriți - de exemplu exact asta:

• ›Sună-mă chiar acum la +420777123456 și încearcă rolul liniei de comenzi a unei pizzerii - nu vreau să-mi creez un număr sau un agent propriu doar pentru asta.

Din aceasta editorul recunoaște instrumentul make_call și parametrul său systemPrompt - un apel de probă, fără a fi nevoie să cumpărați un număr sau să creați în prealabil un agent. Apelul se face de la numărul demo comun al volai - exact acest număr, nu al dumneavoastră, îl vede persoana apelată pe ecran - și rulează cu vocea implicită a agentului, pentru că un voiceId propriu nu poate fi trimis la un apel de probă. systemPrompt poate avea cel mult 1200 de caractere, apelul se facturează complet normal, inclusiv suplimentul de agent (fără reducere), și este limitat la cel mult 3 apeluri de probă în 24 de ore pe cont - este necesar un e-mail verificat. Dacă doriți să sunați de la numărul dumneavoastră printr-un agent propriu, spuneți-i editorului acest lucru direct - va apela make_call cu agentId în loc de systemPrompt.

Primul SMS, cu un singur prompt

Același principiu funcționează și la mesajele text:

• ›Trimite un SMS la +420777123456 că programarea este confirmată pentru mâine dimineață.

De data aceasta editorul apelează send_sms - în spate este exact același apel pe care l-ați scrie singur direct în API-ul REST (POST /v1/messages {"to": "+420...", "body": "..."}), doar că fără a scrie cod. Fără un număr propriu, SMS-ul pleacă sub numele comun de expeditor SMSinfo, doar către un număr ceh (+420) sau slovac (+421), iar destinatarul nu poate răspunde - numerele vocale volai nu primesc SMS-uri. Primirea SMS-urilor și trimiterea de la un număr propriu (doar către numere cehe) o asigură opțiunea număr de mobil (290 kr fără TVA pe 30 de zile, cel mult 2 pe cont), pe care editorul o cumpără cu instrumentul buy_sms_number abia după acordul dumneavoastră explicit privind prețul, iar mesajele primite le citește cu list_messages; codurile de verificare de la servicii nu sunt garantate. Și „număr pentru apeluri și SMS” primește SMS-uri și trimite de la un număr propriu: un număr fix din Praga la 49 kr fără TVA pe 30 de zile (se debitează abia după activare, de obicei în 1 zi lucrătoare; cel mult 2 pe cont), la care oamenii pot suna și scrie și de la care agentul sună și trimite SMS-uri. Editorul îl comandă cu instrumentul order_voice_sms_number abia după acordul dumneavoastră explicit privind prețul, direcționează apelurile primite prin set_voice_sms_number_routing și trimite SMS-uri de la el cu instrumentul send_sms și câmpul fromNumber (doar către numere cehe, fără rapoarte de livrare). SMS-urile funcționează abia după prima reîncărcare a creditului: creditul de bun venit acoperă apelurile de probă, nu SMS-urile.

Ce altceva puteți cere?

Același model funcționează pentru oricare dintre cele 110 instrumente - câteva exemple în plus:

• „Rezumă-mi ultimele zece apeluri - mai ales dacă a fost printre ele ceva urgent.” - instrumentul list_calls.
• „Spune-mi care este creditul actual și trimite un avertisment dacă se apropie de epuizare.” - instrumentul get_balance.
• „Creează un număr nou pentru sucursală și atribuie-i imediat un agent care preia rezervările de mese.” - instrumentele buy_number și create_agent, unul după altul.

Tabelul complet al tuturor celor 110 instrumente, cu descrierea momentului în care editorul le folosește, se află pe pagina Server MCP - iar pagina Integrări: Claude Code conține și câteva prompturi gata făcute pentru sarcini obișnuite.

Este sigur să dați editorului o cheie API?

MCP se autorizează cu aceeași cheie API ca API-ul REST și împarte cu acesta aceeași limită de 60 de cereri pe minut - cine are cheia acționează în contul dumneavoastră exact ca dumneavoastră: cumpără un număr, sună, trimite un SMS sau creează un agent, iar totul se scade din creditul dumneavoastră.

Acțiunile plătite (send_sms, make_call, buy_number, buy_sms_number) au în mod intenționat idempotentHint: false - un al doilea apel trimite un al doilea SMS sau debitează a doua sumă, deci un editor bun nu le repetă singur după o cădere de conexiune. Și chiar dacă un prompt ar aluneca spre un număr pe care nu doriți să îl sunați, există o ultimă protecție: lista de numere care nu se sună. Instrumentele add_to_dnc, list_dnc și remove_from_dnc păzesc numerele pe care agentul (și cel integrat, și cel propriu) nu mai are voie să le sune - se aplică apelurilor, nu SMS-urilor, și nu poate fi ocolită prin niciun prompt sau apel API.

Fiecare instrument îi spune în plus editorului din start cum se comportă - dacă doar citește (readOnlyHint), dacă este ireversibil (destructiveHint) sau dacă nu trebuie repetat fără gândire (niciun indicator de idempotență la acțiunile plătite). Datorită acestui lucru, un editor bun întreabă înainte de a șterge un agent sau de a anula un relay lease nefolosit, iar instrumentele de citire (sold, istoricul apelurilor, lista numerelor) le rulează direct, fără întrebări - nu riscați nimic.

Două lucruri MCP nu poate face în mod intenționat: eliberarea unui număr cumpărat (DELETE /v1/numbers/{e164}) și a unui număr de mobil (DELETE /v1/sms-numbers/{e164}) se face doar prin portal sau API-ul REST, pentru ca o frază înțeleasă greșit să nu vă lase fără numărul tipărit pe fluturașul dumneavoastră, iar PDF-ul facturii fiscale se descarcă doar prin REST (facturile propriu-zise se citesc cu instrumentele list_billing_documents și get_billing_document, datele de facturare se modifică cu update_billing_details). Similar, descărcarea înregistrării unui apel nu are un instrument propriu - este un fișier audio, nu JSON, și se descarcă cu aceeași cheie API direct din REST.

Întregul procedeu, împreună cu proprietățile de siguranță ale fiecărui instrument (despre ce întreabă editorul înainte de a acționa), se află pe pagina Server MCP, iar prețurile pe minut și pe SMS pe pagina Prețuri.

Pașii următori