Claude Code per MCP eine Telefonnummer geben

Sie möchten, dass Claude Code (oder Cursor, Windsurf, VS Code) direkt aus einem Prompt telefoniert oder eine SMS sendet, ganz ohne Code? Ein einziger Befehl im Terminal verbindet volai als MCP-Server, und danach sagen Sie Ihrem Editor in normalen Worten, was er tun soll - „Ruf mich an unter ...“, „Schick per SMS ...“. Der Editor wählt aus den 110 Tools, die volai über MCP bereitstellt, das passende aus und ruft es für Sie auf. Keine API-Dokumentation lesen, kein eigener Telefonie-Code.

Was ist MCP, und warum funktioniert das ohne Code?

MCP (Model Context Protocol) ist der Weg, auf dem ein KI-Editor zur Laufzeit ein Tool eines externen Dienstes einbindet und tatsächlich nutzt, statt nur darüber zu reden. Sobald volai verbunden ist, sieht der Editor alle 110 Tools (anrufen, SMS senden, Nummer kaufen, Agenten anlegen und mehr) und erkennt anhand der Beschreibung selbst, welches zu dem passt, was Sie gerade getippt haben. Eine ausführlichere Erklärung des Prinzips finden Sie im Artikel Was ist ein MCP-Server und wie hängt er mit Telefonieren zusammen; hier geht es vor allem darum, Claude Code eine Telefonnummer zu geben und es gleich auszuprobieren.

Installation in Claude Code

Ein Befehl im Terminal, und Sie sind fertig:

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

Den API-Schlüssel (vk_IHR_SCHLUESSEL) erhalten Sie im volai-Portal unter API und MCP, sobald Sie sich registriert haben. Ohne gültigen Schlüssel lehnt der Server die Anfrage ab - der Editor meldet es Ihnen bei der ersten Nachricht.

Cursor und andere Editoren

Derselbe Server, andere Syntax. Tragen Sie Folgendes in ~/.cursor/mcp.json (oder .cursor/mcp.json für ein einzelnes Projekt) ein:

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

Windsurf, VS Code (Copilot) und Claude Desktop werden nach demselben Prinzip verbunden, nur mit einer etwas anderen Form der Konfigurationsdatei - die genaue Syntax für jeden steht auf der Seite MCP-Server.

Wenn der Editor nach dem Verbinden keine Tools anbietet: Meist liegt es an einer von drei Ursachen. Die meisten Editoren lesen die MCP-Konfiguration nur beim Start, daher braucht das erste Speichern einen Neustart (oder wenigstens ein Neuladen des Fensters oder Projekts). Prüfen Sie den eingefügten Schlüssel auf ein überzähliges Leerzeichen am Anfang oder Ende - im Terminal oder in einer JSON-Datei unsichtbar, aber genug, um den Header Authorization zu zerstören. Und am schnellsten bestätigen Sie, dass der Server tatsächlich antwortet, mit dem genauen Prompt weiter unten - sobald der Editor ein Tool aufruft, funktioniert die Verbindung.

Ihr erster Anruf in einem Prompt

Sobald die Verbindung steht, sagen Sie Ihrem Editor einfach, was Sie wollen - eigene Worte genügen, hier aber ein konkretes Beispiel:

• ›Ruf mich sofort unter +420777123456 an und spiel die Bestellannahme einer Pizzeria - ich möchte dafür keine eigene Nummer und keinen eigenen Agenten einrichten.

Der Editor erkennt darin das Tool make_call mit dem Parameter systemPrompt - ein Testanruf, für den vorher weder eine Nummer noch ein Agent eingerichtet sein muss. Er ruft von der gemeinsamen Demo-Nummer von volai aus an - genau die erscheint auf dem Display des Angerufenen, nicht Ihre eigene Nummer - und läuft mit der Standardstimme des Agenten, denn eine eigene voiceId lässt sich bei einem Testanruf nicht mitsenden. systemPrompt ist auf 1200 Zeichen begrenzt, der Anruf wird ganz normal abgerechnet, einschließlich des Agentenzuschlags (kein Rabatt), und pro Konto sind höchstens 3 Testanrufe in 24 Stunden möglich - eine bestätigte E-Mail-Adresse ist erforderlich. Wenn Sie stattdessen von Ihrer eigenen Nummer über Ihren eigenen Agenten anrufen möchten, sagen Sie das dem Editor einfach - er ruft make_call dann mit agentId statt systemPrompt auf.

Ihre erste SMS in einem Prompt

Dasselbe Prinzip funktioniert bei Textnachrichten:

• ›Schick +420777123456 eine SMS, dass der Termin für morgen früh bestätigt ist.

Diesmal greift der Editor zu send_sms - im Hintergrund ist es genau derselbe Aufruf, den Sie selbst gegen die REST-API schreiben würden (POST /v1/messages {"to": "+420...", "body": "..."}), nur ohne eine Zeile Code. Ohne eigene Nummer geht die SMS unter dem gemeinsamen Absendernamen SMSinfo hinaus, nur an eine tschechische (+420) oder slowakische (+421) Nummer, und die Empfänger können nicht antworten - Sprachnummern von volai können keine SMS empfangen. SMS empfangen und von der eigenen Nummer senden (nur an tschechische Nummern) kann das Zusatzangebot Mobilnummer (290 CZK ohne MwSt. pro 30 Tage, höchstens 2 pro Konto): Der Editor kauft es mit buy_sms_number erst, nachdem Sie dem Preis ausdrücklich zugestimmt haben, und liest die empfangenen Nachrichten mit list_messages; Verifizierungscodes von Diensten garantieren wir nicht. Auch die Nummer für Anrufe und SMS empfängt SMS und sendet von der eigenen Nummer: ein Prager Festnetzanschluss für 49 CZK ohne MwSt. pro 30 Tage (abgerechnet, sobald er aktiv ist, meist innerhalb von 1 Werktag; höchstens 2 pro Konto), den man anrufen und per SMS erreichen kann und von dem Ihr Agent Anrufe tätigt und SMS sendet. Der Editor bestellt ihn mit order_voice_sms_number erst, nachdem Sie dem Preis ausdrücklich zugestimmt haben, leitet eingehende Anrufe mit set_voice_sms_number_routing um und sendet SMS von ihm mit send_sms und dem Feld fromNumber (nur tschechische Nummern, keine Zustellberichte). SMS funktionieren erst nach der ersten Guthabenaufladung: Das Willkommensguthaben deckt Testanrufe ab, keine SMS.

Worum können Sie noch bitten?

Das gleiche Muster funktioniert für jedes der 110 Tools - noch ein paar Beispiele:

• „Geh meine letzten zehn Anrufe durch und sag mir, welche wirklich meine Aufmerksamkeit brauchen.“ - das Tool list_calls.
• „Sag mir meinen aktuellen Guthabenstand und warne mich, wenn er knapp wird.“ - das Tool get_balance.
• „Richte eine Nummer für die neue Filiale ein und leg einen Agenten darauf, der Tischreservierungen annimmt.“ - buy_number und create_agent, nacheinander.

Die vollständige Tabelle aller 110 Tools mit einer Beschreibung, wann der Editor welches nutzt, steht auf der Seite MCP-Server - und auf der Seite Claude-Code-Integration finden Sie eine Handvoll fertiger Prompts für typische Aufgaben.

Ist es sicher, dem Editor einen API-Schlüssel zu geben?

MCP authentifiziert sich mit demselben API-Schlüssel wie die REST-API und teilt sich mit ihr das Limit von 60 Anfragen pro Minute - wer diesen Schlüssel besitzt, handelt auf Ihrem Konto genau wie Sie: eine Nummer kaufen, einen Anruf tätigen, eine SMS abschicken oder einen Agenten anlegen, und alles geht zulasten Ihres Guthabens.

Kostenpflichtige Aktionen (send_sms, make_call, buy_number, buy_sms_number) sind bewusst mit idempotentHint: false gekennzeichnet - ein zweiter Aufruf sendet eine zweite SMS oder belastet einen zweiten Betrag, deshalb wiederholt ein gut erzogener Editor sie nach einem Timeout nicht von allein. Und selbst wenn ein Prompt einmal in Richtung einer Nummer abdriften sollte, die nicht angerufen werden soll, gibt es eine weitere Sicherung: die Sperrliste (Do-not-call). Die Tools add_to_dnc, list_dnc und remove_from_dnc schützen Nummern, die kein Agent - weder der integrierte noch Ihr eigener - mehr anrufen darf. Sie gilt für Anrufe, nicht für SMS, und kein Prompt und kein API-Aufruf kann sie umgehen.

Jedes Tool teilt dem Editor außerdem vorab mit, wie es sich verhält - ob es nur liest (readOnlyHint), ob es unumkehrbar ist (destructiveHint) oder ob es nicht gedankenlos wiederholt werden darf (kein Idempotenz-Hinweis bei kostenpflichtigen Aktionen). Deshalb fragt ein guter Editor nach, bevor er einen Agenten löscht oder ein ungenutztes Relay-Lease kündigt, während reine Lesetools (Guthaben, Anrufverlauf, Nummernliste) einfach ohne Rückfrage laufen - dabei lässt sich nichts verlieren.

Zwei Dinge kann MCP bewusst nicht: Das Freigeben einer gekauften Nummer (DELETE /v1/numbers/{e164}) oder einer Mobilnummer (DELETE /v1/sms-numbers/{e164}) funktioniert nur über das Portal oder die REST-API, damit ein missverstandener Satz Sie nicht die Nummer kostet, die auf Ihrem Flyer steht, und das PDF einer Rechnung lässt sich nur über REST herunterladen (die Rechnungen selbst lesen Sie mit list_billing_documents und get_billing_document, die Rechnungsdaten ändern Sie mit update_billing_details). Auch für das Herunterladen einer Anrufaufzeichnung gibt es aus demselben Grund kein eigenes Tool - es ist eine Audiodatei, kein JSON, und wird mit demselben API-Schlüssel direkt über REST geladen.

Die vollständige Anleitung, einschließlich der Sicherheitseigenschaften jedes Tools (wonach ein guter Client fragt, bevor er handelt), steht auf der Seite MCP-Server; die Preise pro Minute und pro SMS finden Sie unter Preise.

Wie es weitergeht