voiceOne in Claude, Cursor & ChatGPT

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.

Setup in 3 Schritten

Setup pro Tool

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

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

# 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": {}
    }
  }'

Was Sie sofort fragen können

Sobald der MCP-Server verbunden ist, erkennen Claude, Cursor und ChatGPT die voiceOne-Werkzeuge automatisch. Hier sind neun typische Beispiel-Aufgaben:

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.

Agent aus einem Dokument erstellen

Aus einem Firmendokument entsteht in rund 30 Sekunden ein fertig konfigurierter Telefon-Agent: Begrüßung, Verhaltensregeln und thematisch gegliedertes Wissen mit Öffnungszeiten, Preisen und Kontaktdaten. Übernommen wird nur, was im Dokument steht; fehlende Angaben werden als offene Punkte zurückgemeldet.

• Formate: PDF, gescanntes PDF (Texterkennung, bis 12 Seiten), Word (.docx), Text/Markdown/CSV, HTML, Foto (PNG/JPEG) – oder einfach die Adresse Ihrer Website.
• Quelle: genau eine von document_base64 (Datei, max. 10 MB), document_url (öffentliche https-Adresse) oder document_text.
• Erst Entwurf, dann anlegen: Standardmäßig kommt nur ein Entwurf zurück – gespeichert wird nichts. Mit create: true wird der Agent sofort angelegt.
• Original zum Nachschlagen: Mit store_document: true (zusammen mit create: true) wird das Dokument zusätzlich beim Agenten abgelegt. Im Anruf kann er darin suchen – sinnvoll für lange Preislisten oder Kataloge.

Per MCP (Claude, Cursor, ChatGPT)

Die Werkzeuge erscheinen automatisch, sobald der Schlüssel write-Berechtigung hat:

• create_agent_from_document – Entwurf oder fertiger Agent aus einem Dokument.
• add_agent_document – Dokument an einen bestehenden Agenten hängen (wie der Dokumenten-Upload in der App). Die Einstellungen des Agenten bleiben unverändert.
• get_document_agent_job – Ergebnis abholen, falls die Verarbeitung länger dauert.

Dauert die Verarbeitung länger als die Wartezeit (Standard 45 Sekunden), antwortet der Server mit "status": "running" und einer job_id. Ihr KI-Tool fragt dann selbstständig nach.

Per REST-API (eigene Software, Zapier, Make)

Derselbe Schlüssel funktioniert auch ohne MCP-Client. Dateien als multipart/form-data im Feld file, alle übrigen Felder wie oben – oder alles als JSON.

# Agent aus einer PDF anlegen und das PDF zum Nachschlagen ablegen
curl -X POST https://mcp.voice-one.ai/api/v1/agents/from-document \
  -H "Authorization: Bearer vok_live_a1b2c3d4_IHR_SCHLUESSEL_HIER" \
  -F file=@praxis-info.pdf \
  -F create=true \
  -F store_document=true

# Nur einen Entwurf aus Ihrer Website erzeugen (JSON)
curl -X POST https://mcp.voice-one.ai/api/v1/agents/from-document \
  -H "Authorization: Bearer vok_live_a1b2c3d4_IHR_SCHLUESSEL_HIER" \
  -H "Content-Type: application/json" \
  -d '{"document_url": "https://www.ihre-firma.de/", "instructions": "Nur Nachrichten aufnehmen, keine Termine"}'

# Preisliste an einen bestehenden Agenten hängen
curl -X POST https://mcp.voice-one.ai/api/v1/agents/AGENT_ID/documents \
  -H "Authorization: Bearer vok_live_a1b2c3d4_IHR_SCHLUESSEL_HIER" \
  -F file=@preisliste-2026.pdf

# Status eines laufenden Auftrags (Adresse steht im Location-Header)
curl https://mcp.voice-one.ai/api/v1/agents/jobs/dok_... \
  -H "Authorization: Bearer vok_live_a1b2c3d4_IHR_SCHLUESSEL_HIER"

Antworten: 200 Entwurf fertig · 201 Agent angelegt bzw. Dokument abgelegt · 202 läuft noch (Adresse im Location-Header) · 401 Schlüssel fehlt oder ungültig · 403 keine Berechtigung · 404 Agent bzw. Auftrag nicht gefunden · 422 Dokument nicht verwertbar (Begründung im Feld error) · 429 Limit erreicht.

Limits: 40 Dokument-Aufträge pro Konto und Tag, zusätzlich zu den Rate-Limits Ihres Plans. Es werden nur öffentlich erreichbare Adressen abgerufen.

Hinweis zur Suche: Agenten ohne eigene Dokumente durchsuchen im Anruf die Dokumente des gesamten Kontos. Legen Sie Dokumente, die nur für einen Agenten bestimmt sind, deshalb gezielt bei diesem Agenten ab und geben Sie anderen Agenten bei Bedarf eigene Dokumente.

Sprach-Button für Ihre Website

Ihr KI-Agent lässt sich als Sprach-Button auf jeder Website einbinden: Besucher klicken, erlauben das Mikrofon und sprechen direkt mit dem Agenten – ohne Telefon, ohne App. Über MCP oder die REST-API schalten Sie den Button ein, legen die Farben fest und erhalten den fertigen HTML-Code zum Einfügen.

• Farben: primary_color und accent_color bilden den Farbverlauf des Buttons und der Sprechanimation, background_color färbt das geöffnete Fenster. Erlaubt sind Hex-Werte wie #1E3A8A oder #0a8.
• Design: theme = light (Standard) oder dark.
• Position: position = bottom-right (Standard), bottom-left, center (mittig unten) oder center-full (immer geöffnet in der Seite).
• Willkommenstext: welcome_text, höchstens 200 Zeichen; leer = Standardtext.
• Ausschalten: enabled: false.
• Nur Genanntes ändert sich: „Mach den Button grün“ lässt Position, Text und alle übrigen Einstellungen unverändert. Ist eine Farbe so hell, dass das weiße Symbol kaum lesbar ist, erhalten Sie einen Hinweis.

Per MCP (Claude, Cursor, ChatGPT)

• create_voice_widget – schaltet den Button ein, speichert Farben und Text und liefert Einbettungscode, Vorschau-Adresse und eine kurze Einbau-Anleitung. Benötigt einen Schlüssel mit write-Berechtigung.
• get_voice_widget – zeigt aktuelle Einstellungen und Code, ändert nichts (auch mit Lese-Schlüsseln).

Beispiel: „Erstelle für den Agenten ‘Empfang’ einen Sprach-Button für unsere Website in Dunkelblau mit dem Text ‚Fragen Sie uns einfach‘, unten links.“

Per REST-API

# Button einschalten, Farben setzen und Einbettungscode erhalten
curl -X POST https://mcp.voice-one.ai/api/v1/agents/AGENT_ID/voice-widget \
  -H "Authorization: Bearer vok_live_a1b2c3d4_IHR_SCHLUESSEL_HIER" \
  -H "Content-Type: application/json" \
  -d '{"primary_color": "#1E3A8A", "accent_color": "#3B82F6", "theme": "light",
       "position": "bottom-left", "welcome_text": "Fragen Sie uns einfach"}'

# Aktuellen Stand und Code abrufen
curl https://mcp.voice-one.ai/api/v1/agents/AGENT_ID/voice-widget \
  -H "Authorization: Bearer vok_live_a1b2c3d4_IHR_SCHLUESSEL_HIER"

Die Antwort enthält im Feld embed_code den HTML-Code. Fügen Sie ihn direkt vor </body> Ihrer Website ein (in WordPress z. B. über einen „Benutzerdefiniertes HTML“-Block oder ein Header/Footer-Plugin). Die Website muss über https laufen, sonst gibt der Browser das Mikrofon nicht frei.

Wann der Code neu eingefügt werden muss: Änderungen an Primärfarbe, Akzentfarbe und Willkommenstext wirken sofort auf der bereits eingebundenen Website. Hintergrundfarbe, Design und Position stecken im Code selbst – nach einer Änderung daran den neuen Code einfügen.

Antworten: 200 fertig · 400 Anfrage ist kein JSON-Objekt · 401 Schlüssel fehlt oder ungültig · 403 keine Berechtigung · 404 Agent nicht gefunden · 422 ungültiger Wert (z. B. keine Hex-Farbe, Begründung im Feld error) · 429 Limit erreicht. Änderungen zählen als schreibende Aufrufe Ihres Plans. Den Button können Sie auch weiterhin in der App unter Agent → Voice-Widget einrichten (Anleitung).

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 (Aufrufe pro Minute / pro Tag / davon schreibend pro Tag): Testphase 10 / 200 / 10 · Basic 30 / 2.000 / 100 · Professional 60 / 10.000 / 500 · Premium 120 / 50.000 / 2.000 · Enterprise nach Vereinbarung. Der Plan wird bei jedem Aufruf aus dem aktuellen Abo des Kontos gelesen.

FAQ & Troubleshooting