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.
https://mcp.voice-one.ai/mcpAuthentifizierung:
Authorization: Bearer vok_<env>_<id>_<secret>Protokoll: MCP 2025-03-26 (Streamable HTTP, JSON-RPC 2.0)
Setup in 3 Schritten
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.
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.
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:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
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.
"voiceone": {…} einfach als zusätzliches Schlüssel-Wert-Paar in das bestehende mcpServers-Objekt ein.
Cursor
Öffnen Sie Cursor → Settings → MCP → Add 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:
- Name:
voiceOne - URL:
https://mcp.voice-one.ai/mcp - Authentication: Bearer Token
- Token:
vok_live_a1b2c3d4_IHR_SCHLUESSEL_HIER - Protocol: MCP
2025-03-26
Aktivieren Sie den Connector in einem neuen Chat (Connector-Icon unter dem Eingabefeld) und voiceOne ist verfügbar.
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:
1. Anrufe anzeigen
„Zeig mir die letzten fünf eingegangenen Anrufe mit Dauer und Anrufergrund.“
2. Transcript abrufen
„Hol das vollständige Transkript des Anrufs von heute Morgen 09:14 raus.“
3. Kontakt finden
„Such alle Kontakte mit dem Nachnamen Müller in meinem voiceOne-System.“
4. Agenten auflisten
„Welche KI-Agenten habe ich angelegt und welche Telefonnummer hängt an welchem?“
5. Kontakt anlegen
„Leg einen Kontakt an: Hans Meier, Mustermann GmbH, +49 30 1234567, Branche Handwerk.“
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
- Bcrypt-Hash (Cost 12) für jeden Schlüssel – das Geheimnis wird nie im Klartext gespeichert.
- Sofortiger Widerruf über das Schlüssel-Management; eine widerrufene Schlüssel-ID wird in der nächsten Anfrage zurückgewiesen.
- Tenant-Scoping – jeder Schlüssel sieht nur Ihre Tenant-Daten, nie die anderer Kunden.
- Audit-Log über alle Aufrufe (30 Tage Aufbewahrung); IPs werden gehasht, sensible Felder redigiert.
- Rate-Limits nach Plan: Free 10 r/min · 200 r/Tag · Starter 30/2.000 · Pro 60/10.000 · Business 120/50.000 · Enterprise unlimitiert.
FAQ & Troubleshooting
Ich bekomme „Invalid or revoked API key“ – was tun?
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.
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.
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?
Wie viele Schlüssel kann ich anlegen?
Welche Daten werden geloggt?
Schlüssel ausstellen und sofort loslegen
3 Minuten Einrichtungszeit. Kostenlos im Trial enthalten.
MCP-Schlüssel jetzt erstellen