Ce este un server MCP și cum se leagă de telefonie

Un server MCP este o interfață prin care un editor AI sau un asistent (Claude Code, Cursor, Windsurf și altele) poate accesa în timpul funcționării un instrument al unui serviciu extern și îl poate folosi direct - nu doar să vorbească despre el. Model Context Protocol (MCP) este un standard deschis prin care editorul cere lista instrumentelor disponibile, îl alege pe cel potrivit pentru cerința primită și îl apelează cu parametri reali; serverul de la celălalt capăt rulează instrumentul și trimite rezultatul înapoi în conversație. La volai, unul dintre aceste instrumente este make_call - de aceea un editor AI poate, la propriu, să ridice receptorul și să sune pe cineva fără ca dumneavoastră să scrieți vreo linie de cod.

Ce este un server MCP?

Anthropic a introdus Model Context Protocol în noiembrie 2024 ca standard deschis pentru conectarea modelelor AI la instrumente și date externe - în loc ca fiecare editor și fiecare serviciu să-și inventeze propria integrare, toți vorbesc un protocol comun. MCP separă cele două părți: clientul MCP este aplicația pe care o rulați (Claude Code, Cursor, Claude Desktop), iar serverul MCP este interfața pe care un serviciu (aici volai) o expune în exterior - o listă de tools pe care i se poate cere să le ruleze.

Serverul MCP volai rulează la adresa https://volai.cz/mcp (un server la distanță, accesat printr-un așa-numit transport HTTP streamable, nu un proces de pe discul dumneavoastră) și expune 110 instrumente (la data de 3 noiembrie 2026; lista actuală se găsește întotdeauna la /docs/mcp) - de la verificarea creditului și cumpărarea unui număr până la trimiterea unui SMS și, da, efectuarea unui apel.

Cum apelează un client MCP un instrument?

Între instalarea serverului și un apel telefonic real au loc câțiva pași - editorul le face pe toate, dumneavoastră scrieți doar cerința:

1. Editorul se conectează la server și se autentifică cu o cheie API (Authorization: Bearer vk_...) - aceeași cheie ca pentru API-ul REST, cu aceeași limită de 60 de cereri pe minut.
2. Serverul trimite înapoi lista instrumentelor - pentru fiecare, un nume, o descriere pe înțelesul oamenilor și forma exactă a parametrilor (o schemă JSON).
3. Modelul citește descrierile și îl alege pe cel potrivit cerinței - de exemplu make_call, când cerința spune „sună”.
4. Editorul apelează instrumentul cu parametri reali - un număr de telefon real și instrucțiuni reale pentru agent, nu text generic.
5. Serverul nostru rulează instrumentul - pornește apelul, scade din credit - și returnează rezultatul în două forme: ca propoziție ușor de citit și, în același timp, ca date structurate (structuredContent) pentru un client care le poate citi direct.
6. Modelul primește rezultatul înapoi în conversație și vă spune ce s-a întâmplat - sau trece la un alt instrument, precum get_call, ca să aștepte încheierea apelului și să aducă transcrierea.

Exemplu: make_call în practică

Îi spuneți editorului ce doriți, în limbaj obișnuit - de exemplu: „Sună la +420777123456, prezintă-te ca recepționerul cafenelei Nordic Coffee și află dacă apelantul vrea să rezerve o masă.” Editorul transformă acest lucru într-un apel către instrumentul make_call - această parte nu o vedeți direct, dar în spate arată astfel:

{
  "to": "+420777123456",
  "systemPrompt": "Ești recepționerul cafenelei Nordic Coffee. Răspunde la apel, prezintă-te și află dacă apelantul vrea să rezerve o masă - dacă da, cere numele și ora."
}

Instrumentul cere o destinație (to - un număr ceh sau slovac, singurele pe care volai le poate suna în prezent) și exact UNA dintre cele trei modalități de a derula apelul - agentId (apelul îl preia propriul agent), from (o punte simplă între două numere, fără agent) sau systemPrompt (un apel de probă fără un număr propriu - o singură cerere, fără nimic de cumpărat sau configurat înainte). Serverul răspunde în ambele forme deodată (un extras - forma completă a obiectului apel se găsește în referința API-ului REST):

{
  "call": {
    "id": "c_7a2f91de",
    "direction": "out",
    "to": "+420777123456",
    "status": "initiated",
    "startedAt": 1756111400000
  },
  "trial": true,
  "from": "+420..."
}

Apelul pleacă de la un număr demo volai comun, urmează instrucțiunile din systemPrompt și se tarifează normal, inclusiv suplimentul pentru agent - doar cu o limită zilnică mai strictă decât în cazul unui agent real: cel mult trei apeluri de probă fără un număr propriu, pe cont, pe zi (descrisă în referința API-ului REST, la data de 6 septembrie 2026). De aceea răspunsul conține și trial: true și from cu numărul demo volai comun, ca să fie clar că apelul nu a plecat de la numărul dumneavoastră.

Cum se leagă un server MCP de apelurile telefonice?

Serverul MCP în sine nu ridică receptorul - este ușa de la intrare prin care cererea dumneavoastră ajunge la logica reală a serviciului. În spatele lui, make_call apelează același strat ca API-ul REST și portalul, care trimite apelul în rețeaua telefonică exact ca orice alt apel efectuat de volai - printr-un SIP trunk care leagă semnalizarea din internet de rețeaua telefonică propriu-zisă (cum anume, se explică în Ce este un SIP trunk). MCP este limba pe care o vorbește editorul AI; SIP trunk-ul este limba pe care o vorbește rețeaua telefonică - iar logica serviciului dintre ele le leagă.

Securitate

MCP se autentifică cu aceeași cheie API ca API-ul REST - cine o deține poate cheltui creditul dumneavoastră în numele dumneavoastră: poate cumpăra numere, efectua apeluri, trimite SMS-uri, crea agenți. Cheia aparține doar configurației editorului dumneavoastră, niciodată codului de frontend sau unui depozit GitHub. O suspiciune de scurgere se rezolvă dintr-un singur buton din portal (API și MCP) - ștergerea cheii are efect imediat și nu poate fi anulată.

Un al doilea nivel de protecție rulează pe server, nu în cerere. Un număr adăugat pe lista de nonapelare (instrumentul add_to_dnc) blochează apelurile prin make_call și prin relay, indiferent ce spune cererea - modelul nu trebuie să țină minte singur pe cine nu are voie să sune, limita o impune serverul. În aceeași direcție, instrumentele care costă bani sau modifică ceva ireversibil (make_call, send_sms, delete_agent...) poartă în protocol propriile indicatoare - serverul declară dinainte dacă o acțiune este distructivă sau sigur de repetat. Acțiunile tarifate nu sunt idempotente în mod deliberat: apelarea make_call a doua oară după o conexiune întreruptă efectuează un al doilea apel și percepe o a doua plată, așa că un client bine comportat nu îl va repeta singur după o expirare a timpului de așteptare.

Un lucru lipsește intenționat: eliberarea unui număr de telefon sau a unui număr de mobil cumpărat nu se numără printre cele 110 instrumente. Cumpărarea unui număr prin MCP funcționează, eliberarea unuia nu - o acțiune ireversibilă, care i-ar putea costa pe un client numărul tipărit pe fluturașul lui, necesită portalul sau API-ul REST, nu o propoziție înțeleasă greșit într-o cerere.

Încercați singuri

Instalarea în Claude Code este o singură comandă în terminal (Cursor, Windsurf și Claude Desktop au nevoie fiecare de câteva rânduri proprii de JSON, vezi /docs/mcp):

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

Pașii următori