Så ger du Claude Code ett telefonnummer via MCP

Vill du att Claude Code (eller Cursor, Windsurf, VS Code) ska kunna ringa och skicka sms direkt från en prompt, utan att någon kod skrivs? Ett enda kommando i terminalen kopplar in volai som MCP-server, och sedan beskriver du bara med vanliga ord vad som ska göras - ”ring mig på...”, ”skicka ett sms till...”. Editorn väljer själv rätt verktyg bland de 110 som volai erbjuder via MCP och anropar det. Ingen API-dokumentation att läsa, ingen egen telefonikod.

Vad är MCP och varför fungerar det utan kod?

MCP (Model Context Protocol) är sättet för en AI-editor att under körning hämta ett verktyg från en extern tjänst och faktiskt använda det, i stället för att bara prata om det. När volai är kopplat ser editorn alla 110 verktyg (ringa, skicka sms, köpa nummer, skapa agent och mer) och väljer utifrån beskrivningen rätt verktyg för det du just skrev. En djupare förklaring av principen finns i artikeln Vad är en MCP-server och hur hänger den ihop med telefoni; här handlar det framför allt om att ge Claude Code ett telefonnummer och prova det direkt.

Installation i Claude Code

Ett kommando i terminalen och sedan är det klart:

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

API-nyckeln (vk_DIN_NYCKEL) finns i volai-portalen under API och MCP när man har registrerat sig. Utan giltig nyckel avvisar servern förfrågan - editorn säger till direkt vid det första meddelandet.

Cursor och andra editorer

Samma server, annan notation. Lägg till detta i ~/.cursor/mcp.json (eller i .cursor/mcp.json för ett enskilt projekt):

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

Windsurf, VS Code (Copilot) och Claude Desktop kopplas in enligt samma princip, bara med en något annorlunda form på konfigurationsfilen - exakt syntax för var och en finns på sidan MCP-server.

Om editorn inte erbjuder några verktyg direkt efter anslutningen: det brukar vara en av tre saker. De flesta editorer läser konfigurationen av MCP-servrar bara vid start, så efter första sparningen krävs en omstart (eller åtminstone att fönstret eller projektet laddas om). Kontrollera att den inklistrade nyckeln inte har ett överflödigt mellanslag först eller sist - det syns varken i terminalen eller i en JSON-fil, men det förstör rubriken Authorization. Och det snabbaste sättet att bekräfta att servern svarar är exakt den prompt som står en bit längre ned - så fort editorn själv anropar ett verktyg fungerar anslutningen.

Det första samtalet, med en prompt

När anslutningen är klar räcker det att med egna ord skriva vad som ska göras till editorn - till exempel precis så här:

• ›Ring mig direkt på +420777123456 och prova rollen som en pizzerias beställningslinje - jag vill inte skaffa ett eget nummer eller en egen agent bara för det här.

Editorn känner igen detta som verktyget make_call med parametern systemPrompt - ett provsamtal utan att ett nummer eller en agent behöver skapas i förväg. Samtalet görs från volais delade demonummer - det är exakt det som visas på mottagarens display, inte ditt eget nummer - och körs med agentens standardröst, eftersom en egen voiceId inte kan skickas med vid ett provsamtal. systemPrompt får vara högst 1200 tecken, samtalet debiteras helt som vanligt inklusive agentpåslaget (ingen rabatt) och är begränsat till högst 3 provsamtal per 24 timmar och konto - en verifierad e-postadress krävs. Om du hellre vill ringa från ditt eget nummer via din egen agent, säg det bara till editorn - den anropar då make_call med agentId i stället för systemPrompt.

Det första sms:et, med en prompt

Samma princip fungerar för textmeddelanden:

• ›Skicka ett sms till +420777123456 om att den bokade tiden är bekräftad för i morgon förmiddag.

Den här gången tar editorn send_sms - under huven exakt samma anrop som man själv skulle skriva mot REST API (POST /v1/messages {"to": "+420...", "body": "..."}), bara utan att skriva någon kod. Utan eget nummer går sms ut under det delade avsändarnamnet SMSinfo, bara till ett tjeckiskt (+420) eller slovakiskt (+421) nummer, och mottagaren kan inte svara - volais röstnummer tar inte emot sms. Att ta emot sms och skicka från ett eget nummer (bara till tjeckiska nummer) klarar tillägget mobilnummer (290 kr exklusive moms per 30 dagar, högst 2 per konto): editorn köper det med buy_sms_number först när du uttryckligen godkänt priset, och läser de mottagna meddelandena med list_messages; vi garanterar inte verifieringskoder från tjänster. Även ”nummer för samtal och sms” tar emot sms och skickar från ett eget nummer: en fast linje i Prag för 49 kr exklusive moms per 30 dagar (debiteras först när den har aktiverats, vanligtvis inom 1 arbetsdag; högst 2 per konto) som man kan ringa och skicka sms till och som agenten ringer och skickar sms från. Editorn beställer den med order_voice_sms_number först när du uttryckligen godkänt priset, styr inkommande samtal med set_voice_sms_number_routing och skickar sms från den med send_sms och fältet fromNumber (bara till tjeckiska nummer, utan leveranskvitton). Textmeddelanden fungerar först efter den första påfyllningen av saldot: välkomstsaldot räcker till provsamtal, inte till sms.

Vad mer kan man be om?

Samma mönster fungerar för vilket som helst av de 110 verktygen - några fler exempel:

• ”Gå igenom mina tio senaste samtal och säg vilka som faktiskt kräver min uppmärksamhet.” - verktyget list_calls.
• ”Berätta hur mycket saldo jag har just nu och skicka en varning om det håller på att ta slut.” - verktyget get_balance.
• ”Skaffa ett nummer till den nya filialen och koppla en agent till det som tar emot bordsbokningar.” - verktygen buy_number och create_agent, ett efter det andra.

Hela tabellen över alla 110 verktyg, med en beskrivning av när editorn använder vart och ett, finns på sidan MCP-server - och sidan Integrationer: Claude Code har dessutom några färdiga promptar för vanliga uppgifter.

Är det säkert att ge editorn en API-nyckel?

MCP autentiseras med samma API-nyckel som REST API och delar även dess gräns på 60 förfrågningar per minut - den som har nyckeln agerar för ditt konto på exakt samma sätt som du: köper ett nummer, ringer ett samtal, skickar ett textmeddelande eller skapar en agent, och allt dras från ditt saldo.

Betalda åtgärder (send_sms, make_call, buy_number, buy_sms_number) är medvetet markerade med idempotentHint: false - ett andra anrop skickar ett andra sms eller drar ett andra belopp, så en väluppfostrad editor upprepar dem inte på egen hand efter ett avbrott. Och även om en prompt skulle glida iväg mot ett nummer som inte ska ringas finns en sista spärr: listan över nummer som inte får ringas. Verktygen add_to_dnc, list_dnc och remove_from_dnc bevakar nummer som ingen agent - varken den inbyggda eller en egen - längre får ringa. Det gäller samtal, inte sms, och går inte att kringgå med någon prompt eller något API-anrop.

Varje verktyg talar dessutom i förväg om för editorn hur det beter sig - om det bara läser (readOnlyHint), om det är oåterkalleligt (destructiveHint), eller om det inte får upprepas utan eftertanke (ingen idempotent-flagga på betalda åtgärder). Därför frågar en bra editor först innan den raderar en agent eller avbryter ett oanvänt relay lease, medan läsande verktyg (saldo, samtalshistorik, nummerlista) körs direkt utan att fråga - det finns inget att förlora på det.

Två saker kan MCP medvetet inte göra: att frigöra ett köpt nummer (DELETE /v1/numbers/{e164}) eller ett mobilnummer (DELETE /v1/sms-numbers/{e164}) går bara via portalen eller REST API, så att en enda felläst mening inte kostar dig numret som står tryckt på ditt flygblad, och PDF:en av en faktura laddas bara ned via REST (själva fakturorna läser verktygen list_billing_documents och get_billing_document, faktureringsuppgifterna ändras med update_billing_details). På samma sätt har nedladdning av en samtalsinspelning inget eget verktyg - det är en ljudfil, inte JSON, och laddas ned med samma API-nyckel direkt från REST.

Hela genomgången, inklusive säkerhetsegenskaperna hos de enskilda verktygen (vad en bra klient frågar om innan den agerar), finns på sidan MCP-server, och priserna per minut och sms finns under priser.

Vad händer härnäst