Claude Code een telefoonnummer geven via MCP

Wilt u dat Claude Code (of Cursor, Windsurf, VS Code) rechtstreeks vanuit een prompt kan bellen of een sms kan sturen, zonder code te schrijven? Eén opdracht in de terminal verbindt volai als MCP-server, en daarna vertelt u uw editor in gewone taal wat u wilt - „bel me op...”, „stuur een sms naar...”. De editor kiest zelf de juiste tool uit de 110 die volai via MCP aanbiedt en roept die aan. Geen API-documentatie lezen, geen eigen telefoniecode.

Wat is MCP, en waarom werkt dit zonder code?

MCP (Model Context Protocol) is de manier waarop een AI-editor tijdens het werk een tool van een externe dienst ophaalt en die ook echt gebruikt, in plaats van er alleen over te praten. Zodra volai is verbonden, ziet de editor alle 110 tools (bellen, sms sturen, een nummer kopen, een agent aanmaken en meer) en kiest hij op basis van de beschrijving zelf de juiste voor wat u zojuist hebt getypt. Een diepere uitleg van het principe vindt u in het artikel Wat is een MCP-server en hoe hangt die samen met bellen; hier gaat het vooral om Claude Code een telefoonnummer geven en het meteen uitproberen.

Installeren in Claude Code

Eén opdracht in de terminal en u bent klaar:

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

De API-sleutel (vk_UW_SLEUTEL) vindt u in het volai-portaal onder API en MCP, zodra u zich hebt geregistreerd. Zonder geldige sleutel weigert de server het verzoek - de editor meldt dat u meteen bij het eerste bericht.

Cursor en andere editors

Dezelfde server, een andere notatie. Plaats in ~/.cursor/mcp.json (of in .cursor/mcp.json alleen voor één project) het volgende:

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

Windsurf, VS Code (Copilot) en Claude Desktop verbinden op hetzelfde principe, alleen met een iets andere vorm van het configuratiebestand - de exacte tekst voor elk ervan staat op de pagina MCP-server.

Als de editor na het verbinden geen enkele tool toont: meestal is het een van drie dingen. Een editor leest de configuratie van MCP-servers doorgaans alleen bij het opstarten, dus na de eerste keer opslaan is een herstart nodig (of in elk geval het opnieuw laden van het venster of project). Controleer of de gekopieerde sleutel aan het begin of einde geen extra spatie heeft - in de terminal en in een JSON-bestand is die onzichtbaar, maar ze maakt de header Authorization onbruikbaar. En of de server wel antwoordt, controleert u het snelst met precies de prompt hieronder - zodra de editor zelf een tool aanroept, is de verbinding in orde.

Uw eerste gesprek met één prompt

Na het verbinden hoeft u de editor alleen in uw eigen woorden te zeggen wat u wilt - bijvoorbeeld precies dit:

• ›Bel me meteen op +420777123456 en probeer de rol van de bestellijn van een pizzeria - ik wil hiervoor geen eigen nummer en geen eigen agent aanmaken.

De editor herkent hieruit de tool make_call en de parameter systemPrompt - een proefgesprek zonder dat u een nummer hoeft te kopen of vooraf een agent hoeft aan te maken. Het gesprek gaat via het gedeelde demonummer van volai - precies dat nummer, niet uw eigen, ziet de gebelde persoon op het scherm - en draait op de standaardstem van de agent, omdat een eigen voiceId bij een proefgesprek niet kan worden meegegeven. systemPrompt mag maximaal 1200 tekens bevatten, het gesprek wordt volledig normaal afgerekend inclusief de toeslag voor de agent (geen korting) en is beperkt tot maximaal 3 proefgesprekken per 24 uur per account - een geverifieerd e-mailadres is vereist. Wilt u vanaf uw eigen nummer bellen via uw eigen agent, zeg dat dan gewoon tegen de editor - die roept make_call aan met agentId in plaats van systemPrompt.

Uw eerste sms met één prompt

Hetzelfde principe werkt voor sms-berichten:

• ›Stuur een sms naar +420777123456 dat de afspraak is bevestigd voor morgenochtend.

Deze keer grijpt de editor naar send_sms - onder de motorkap precies dezelfde aanroep die u zelf rechtstreeks op de REST API zou schrijven (POST /v1/messages {"to": "+420...", "body": "..."}), alleen zonder code te schrijven. Zonder eigen nummer gaat de sms onder de gedeelde afzendernaam SMSinfo, alleen naar een Tsjechisch (+420) of Slowaaks (+421) nummer, en de ontvanger kan niet antwoorden - spraaknummers van volai ontvangen geen sms. Sms ontvangen en vanaf een eigen nummer verzenden (alleen naar Tsjechische nummers) kan met de add-on mobiel nummer (290 kr exclusief btw per 30 dagen, maximaal 2 per account): de editor koopt die met buy_sms_number pas nadat u expliciet akkoord bent gegaan met de prijs, en leest ontvangen berichten met list_messages; verificatiecodes van diensten garanderen we niet. Sms ontvangen en vanaf een eigen nummer verzenden kan ook met „nummer voor bellen en sms“: een vast Praags nummer voor 49 kr exclusief btw per 30 dagen (het bedrag wordt pas na activering afgeschreven, doorgaans binnen 1 werkdag; maximaal 2 per account), waarop mensen kunnen bellen en sms’en en van waaruit de agent belt en sms’t. De editor bestelt het met order_voice_sms_number pas nadat u expliciet akkoord bent gegaan met de prijs, leidt inkomende gesprekken om via set_voice_sms_number_routing en verzendt sms’en ervandaan met send_sms met het veld fromNumber (alleen naar Tsjechische nummers, zonder afleverbevestigingen). Sms-berichten gaan pas na de eerste keer tegoed opwaarderen: het welkomsttegoed volstaat voor proefgesprekken, niet voor sms.

Wat kunt u nog meer laten doen?

Op dezelfde manier werkt elk van de 110 tools - nog een paar voorbeelden:

• „Vat mijn laatste tien gesprekken samen - vooral of er iets urgents bij zat.” - tool list_calls.
• „Zeg me hoeveel tegoed ik nu heb en waarschuw me als het opraakt.” - tool get_balance.
• „Maak een nieuw nummer aan voor het filiaal en koppel er meteen een agent aan die tafelreserveringen aanneemt.” - de tools buy_number en create_agent na elkaar.

De volledige tabel van alle 110 tools met een beschrijving van wanneer de editor ze gebruikt, staat op de pagina MCP-server - en de pagina Integraties: Claude Code bevat meteen ook een paar kant-en-klare prompts voor typische taken.

Is het veilig om een editor een API-sleutel te geven?

MCP autoriseert met dezelfde API-sleutel als de REST API en deelt daarmee ook dezelfde limiet van 60 verzoeken per minuut - wie die sleutel heeft, handelt namens uw account precies zoals u: een nummer kopen, de telefoon opnemen, een sms versturen of een agent aanmaken, en alles wordt van uw tegoed afgeschreven.

Betaalde acties (send_sms, make_call, buy_number, buy_sms_number) hebben bewust idempotentHint: false - een tweede aanroep stuurt een tweede sms of schrijft een tweede bedrag af, dus een goede editor herhaalt ze na een storing niet zelf. En mocht een prompt toch op een nummer terechtkomen dat u niet wilt bellen, dan is er nog een laatste vangnet: de lijst met niet-bellen. De tools add_to_dnc, list_dnc en remove_from_dnc bewaken nummers die de agent (zowel uw eigen als de ingebouwde) niet meer mag bellen - dat geldt voor gesprekken, niet voor sms, en is met geen enkele prompt of API-aanroep te omzeilen.

Elke tool vertelt de editor bovendien vooraf hoe hij zich gedraagt - of hij alleen leest (readOnlyHint), onomkeerbaar is (destructiveHint) of niet zonder nadenken mag worden herhaald (geen idempotent-vlag bij betaalde acties). Daardoor vraagt een goede editor eerst na voordat hij een agent verwijdert of een ongebruikte relay lease annuleert, en voert hij leestools (saldo, gespreksgeschiedenis, overzicht van nummers) direct uit zonder te vragen - u riskeert daarmee niets.

Twee dingen kan MCP bewust niet: een gekocht nummer (DELETE /v1/numbers/{e164}) en een mobiel nummer (DELETE /v1/sms-numbers/{e164}) vrijgeven kan alleen via het portaal of de REST API, zodat één verkeerd begrepen zin u niet van een nummer berooft dat op uw folder staat, en de pdf van een belastingdocument wordt alleen via REST gedownload (de documenten zelf lezen de tools list_billing_documents en get_billing_document, factuurgegevens wijzigt update_billing_details). Ook het downloaden van een gespreksopname heeft geen eigen tool - dat is een audiobestand, geen JSON, en wordt met dezelfde API-sleutel rechtstreeks via REST opgehaald.

De volledige procedure, inclusief de veiligheidseigenschappen van de afzonderlijke tools (waarover de editor eerst vraagt voordat hij iets doet), staat op de pagina MCP-server, de prijzen per minuut en per sms op de prijzenpagina.

Wat nu