MCP-Server · Neu in Phase 1

voiceOne in Claude, Cursor & ChatGPT

Verbinden Sie Ihren KI-Telefonassistenten direkt mit Ihrem AI-Tool. Agenten anlegen, Anrufe abfragen, Rückrufe auslösen – alles per natürlicher Sprache. In 3 Minuten eingerichtet.

Was ist MCP — und warum voiceOne der erste KI-Telefonassistent damit ist

Das Model Context Protocol (MCP) ist ein offener Standard, mit dem KI-Tools wie Claude Desktop, Cursor oder ChatGPT auf externe Daten und Funktionen zugreifen können. Statt Copy & Paste oder eigener Plugin-API kann ein KI-Modell „Werkzeuge“ in Ihrem System aufrufen – transaktional, autorisiert, auditierbar.

voiceOne ist der erste KI-Telefonassistent mit eigenem MCP-Server. Das heißt: Ihr Claude kann Sie fragen „Wer hat heute angerufen?“ oder „Leg bitte einen Kontakt für Hans Meier an“ – und voiceOne führt es aus.

Endpoint: https://mcp.voice-one.ai/mcp
Authentifizierung: Authorization: Bearer vok_<env>_<id>_<secret>
Protokoll: MCP 2025-03-26 (Streamable HTTP, JSON-RPC 2.0)

Setup in 3 Schritten

1

MCP-Schlüssel im voiceOne-Account erstellen

Loggen Sie sich in app.voice-one.ai ein und gehen Sie zu Einstellungen → API-Integration. Klicken Sie oben auf „MCP-Schlüssel ausstellen“, vergeben Sie eine Bezeichnung (z. B. Claude Desktop Büro) und wählen Sie die Berechtigungen.

Der Schlüssel wird im Format vok_live_a1b2c3d4_<32 Zeichen> ausgegeben. Er wird nur einmal angezeigt – kopieren Sie ihn direkt in einen Passwort-Manager.

2

Tool konfigurieren

Tragen Sie Endpoint und Schlüssel in Ihrem AI-Tool ein – die genaue Anleitung für Claude Desktop, Cursor und ChatGPT finden Sie unten.

3

Testen

Starten Sie das AI-Tool neu und stellen Sie eine erste Anfrage: „Welche KI-Agenten habe ich in voiceOne?“. Das Modell wird das Tool list_agents aufrufen und Ihre Agenten zurückgeben.

Setup pro Tool

Claude Desktop (macOS & Windows)

Öffnen Sie die Konfigurationsdatei von Claude Desktop:

Fügen Sie den voiceOne-Eintrag unter mcpServers ein:

{
  "mcpServers": {
    "voiceone": {
      "url": "https://mcp.voice-one.ai/mcp",
      "headers": {
        "Authorization": "Bearer vok_live_a1b2c3d4_IHR_SCHLUESSEL_HIER"
      }
    }
  }
}

Speichern und Claude Desktop neu starten. Im Chat erscheint voiceOne in der Tool-Leiste.

Hinweis: Falls Sie schon andere MCP-Server eingetragen haben, fügen Sie "voiceone": {…} einfach als zusätzliches Schlüssel-Wert-Paar in das bestehende mcpServers-Objekt ein.

Cursor

Öffnen Sie Cursor → Settings → MCPAdd new MCP server. Wählen Sie den Modus Remote (HTTP).

{
  "voiceone": {
    "url": "https://mcp.voice-one.ai/mcp",
    "headers": {
      "Authorization": "Bearer vok_live_a1b2c3d4_IHR_SCHLUESSEL_HIER"
    }
  }
}

Cursor verbindet sich sofort – im Composer steht voiceOne dann als Tool-Provider zur Verfügung. In neueren Cursor-Versionen können Sie das Tool je Workspace separat aktivieren.

ChatGPT Connector (Plus, Team, Enterprise)

ChatGPT unterstützt MCP-Server seit dem Connector-Update. Gehen Sie zu Settings → Connectors → Add custom connector:

Aktivieren Sie den Connector in einem neuen Chat (Connector-Icon unter dem Eingabefeld) und voiceOne ist verfügbar.

Verfügbarkeit: Der ChatGPT Connector ist je nach Plan und Region in mehreren Wellen ausgerollt worden. Wenn der Punkt „Connectors“ bei Ihnen noch nicht erscheint, prüfen Sie ob ein Update verfügbar ist.

Direkter HTTP/JSON-RPC-Zugriff (curl, Node, Python)

Der MCP-Endpoint ist ein klassisches JSON-RPC 2.0 über HTTP POST. Für eigene Skripte oder Server-zu-Server-Integrationen:

# 1. Tools auflisten
curl -X POST https://mcp.voice-one.ai/mcp \
  -H "Authorization: Bearer vok_live_a1b2c3d4_IHR_SCHLUESSEL_HIER" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

# 2. Tool aufrufen
curl -X POST https://mcp.voice-one.ai/mcp \
  -H "Authorization: Bearer vok_live_a1b2c3d4_IHR_SCHLUESSEL_HIER" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "list_agents",
      "arguments": {}
    }
  }'

Für Node-Projekte können Sie auch das offizielle MCP-Client-SDK von Anthropic oder das voiceOne-eigene NPM-Paket voiceone-mcp nutzen (Release in Kürze).

Was Sie sofort fragen können

Sobald der MCP-Server verbunden ist, erkennen Claude, Cursor und ChatGPT die voiceOne-Werkzeuge automatisch. Hier sind sechs typische Beispiel-Aufgaben aus unserem Phase-1-Toolkit:

read
1. Anrufe anzeigen

„Zeig mir die letzten fünf eingegangenen Anrufe mit Dauer und Anrufergrund.“

read
2. Transcript abrufen

„Hol das vollständige Transkript des Anrufs von heute Morgen 09:14 raus.“

read
3. Kontakt finden

„Such alle Kontakte mit dem Nachnamen Müller in meinem voiceOne-System.“

read
4. Agenten auflisten

„Welche KI-Agenten habe ich angelegt und welche Telefonnummer hängt an welchem?“

write
5. Kontakt anlegen

„Leg einen Kontakt an: Hans Meier, Mustermann GmbH, +49 30 1234567, Branche Handwerk.“

write
6. Rückruf auslösen

„Starte einen Outbound-Call an +49 151 1234567 mit Agent ‘Empfang Standard’.“

Werkzeuge mit write verändern Daten in Ihrem voiceOne-Konto. Sie brauchen die write-Berechtigung in Ihrem MCP-Schlüssel – Reine Lese-Schlüssel führen sie nicht aus.

Sicherheit & Limits

FAQ & Troubleshooting

Ich bekomme „Invalid or revoked API key“ – was tun?
Prüfen Sie, ob der Schlüssel komplett kopiert wurde (Format vok_live_<8 hex>_<32 Zeichen>) und dass Sie nicht versehentlich Anführungszeichen mitkopiert haben. Falls Sie den Schlüssel im voiceOne-Account widerrufen haben, stellen Sie einen neuen aus.
Mein Claude/Cursor erkennt voiceOne nicht.
Starten Sie das AI-Tool nach dem Eintragen vollständig neu. Bei Claude Desktop: Quit über Menü, nicht nur Fenster schließen. Prüfen Sie außerdem, dass die JSON-Datei valides JSON ist (keine Trailing Commas, keine Kommentare).
Was bedeuten read und write als Scopes?
read erlaubt lesende Operationen (Anrufe, Kontakte, Agenten anzeigen). write ist Voraussetzung für Operationen, die Daten ändern oder externe Aktionen auslösen (Kontakt anlegen, Outbound-Call starten). Sie können Schlüssel auch nur mit read ausstellen, z. B. für reine Auswertungs-Workflows.
Ich bekomme HTTP 429 / Rate-Limit-Fehler.
Der MCP-Server gibt Header X-RateLimit-Remaining und Retry-After zurück. Im Standard-Trial liegt das Limit bei 10 Anfragen pro Minute. Ein Upgrade auf einen größeren Plan hebt das Limit sofort an.
Kann ich den MCP-Server für Webhook-Automation in n8n / Make / Zapier nutzen?
Ja – jede Plattform, die einen HTTP-POST mit Bearer-Auth abschicken kann, spricht den MCP-Server an. Für komfortable Workflows ohne MCP-Spezifika empfehlen wir parallel die klassische REST-API.
Wie viele Schlüssel kann ich anlegen?
Bis zu 25 aktive Schlüssel pro Account – ideal um pro Tool, Team oder Workflow getrennte Schlüssel zu vergeben und gezielt widerrufen zu können.
Welche Daten werden geloggt?
Pro Aufruf: Schlüssel-ID, Tool-Name, Status, Latenz, gehashte IP, User-Agent. Sensible Felder (E-Mail-Body, Nachrichten, Transkripte) werden im Audit-Log automatisch redigiert. Aufbewahrung 30 Tage.

Schlüssel ausstellen und sofort loslegen

3 Minuten Einrichtungszeit. Kostenlos im Trial enthalten.

MCP-Schlüssel jetzt erstellen