KI - Künstliche Intelligenz - VoIPstudio MCP-Server¶

Der VoIPstudio MCP-Server (Model Context Protocol) ermöglicht Claude AI einen direkten und sicheren Zugriff auf Ihre VoIPstudio-Kontodaten, einschließlich Aufzeichnungen, CDRs, laufender Anrufe und Voicemails. Nach der Verbindung kann Claude Anrufe abfragen, Muster analysieren, Leistungsprobleme von Agenten aufdecken und QA-Berichte in natürlicher Sprache erstellen – ganz ohne individuelle Entwicklung.

Mit dem CX Addon wird jede Aufzeichnung bereits mit einem Transkript, einer Zusammenfassung, einer Stimmungsanalyse, Aktionspunkten und einem CX-Score angereichert. Dadurch wird der Analyseaufwand für Claude erheblich reduziert, der Token-Verbrauch gesenkt und die Kosten bleiben besser vorhersehbar.

API-Schlüssel erhalten¶

Der MCP-Server authentifiziert sich über ein VoIPstudio-API-Token. Jeder Schlüssel ist einem bestimmten Benutzer zugeordnet, sodass Claude nur auf die Daten zugreifen kann, auf die dieser Benutzer Zugriff hat.

So erstellen Sie einen Schlüssel:

1. Öffnen Sie im Admin-Dashboard den Benutzer, für den Sie ein Token erstellen möchten.
2. Wechseln Sie zum Abschnitt API Keys.
3. Geben Sie einen Namen für den Schlüssel ein, z. B. Claude MCP.
4. Klicken Sie auf Add.
5. Klicken Sie auf das Augensymbol, um den API-Schlüssel bzw. user_token anzuzeigen. Kopieren Sie diesen Wert.
6. Um weitere Details anzuzeigen oder den Schlüssel zu löschen, klicken Sie auf das Zahnradsymbol und wählen Show Details.

Hinweis: Der API-Schlüssel bleibt gültig, solange er mindestens einmal innerhalb von 7 Tagen verwendet wird (Standard-Timeout). Falls erforderlich, legen Sie vor dem Klicken auf „Add“ ein längeres Timeout (oder unbegrenzt) fest.

Siehe die REST-API-Dokumentation.

Verbindung mit Claude herstellen¶

VoIPstudio ist derzeit nicht im Connector-Verzeichnis von Claude.ai aufgeführt. Sie können es manuell als benutzerdefinierten MCP-Server hinzufügen.

MCP-Server-URL¶

Schritte (Claude.ai)¶

1. Gehen Sie in Claude.ai zu Settings → Integrations (oder zum Connector-Bereich, abhängig von Ihrem Tarif).
2. Wählen Sie Add custom MCP server (oder die entsprechende Option).
3. Geben Sie die oben genannte MCP-Server-URL ein.
4. Geben Sie bei der Authentifizierungsaufforderung Ihren VoIPstudio-API-Schlüssel an.
5. Speichern und autorisieren Sie die Verbindung.

Claude kann nun in jeder Unterhaltung auf VoIPstudio-Tools zugreifen. Beim ersten Aufruf eines Tools innerhalb einer Sitzung wird Claude Sie bitten, die Datenfreigabe zu bestätigen. Klicken Sie auf Always allow, um diese Abfrage künftig zu überspringen.

Anthropic API (für Entwickler)¶

const response = await fetch("https://api.anthropic.com/v1/messages", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-Api-Key": "YOUR_ANTHROPIC_API_KEY"
  },
  body: JSON.stringify({
    model: "claude-sonnet-4-6",
    max_tokens: 1024,
    mcp_servers: [{
      type: "url",
      url: "https://mcp.voipstudio.workers.dev/sse",
      name: "voipstudio",
      authorization_token: "YOUR_VOIPSTUDIO_API_KEY"
    }],
    messages: [{
      role: "user",
      content: "Show me agents with a CX score below 6 this week"
    }]
  })
});

Verbindung mit anderen KI-Plattformen¶

Die meisten KI-Plattformen, die externe MCPs unterstützen, können sich mit dem VoIPstudio MCP-Server über dieselbe URL und denselben API-Schlüssel verbinden. Die genauen Einrichtungsschritte unterscheiden sich je nach Plattform. Suchen Sie in den Integrationen oder Einstellungen Ihrer Plattform nach Optionen wie external MCP server, custom MCP oder remote MCP.

CX Addon¶

Ohne das CX Addon werden Aufzeichnungen lediglich als Rohdaten bereitgestellt. Claude muss jeden Anruf selbst transkribieren und analysieren, was pro Aufzeichnung eine erhebliche Anzahl von Tokens verbraucht.

Mit dem CX Addon übernimmt VoIPstudio die Transkription, Zusammenfassung, Sentiment-Analyse, Extraktion von Aktionspunkten und die CX-Bewertung auf der eigenen Infrastruktur – zu einem festen monatlichen Preis ohne Gebühren pro Anruf und ohne Transkriptionslimits. Claude erhält bereits aufbereitete Informationen und kann sofort mit der Analyse beginnen.

Durch das CX Addon freigeschaltete Felder¶

Tool-Referenz¶

Dank der einfachen MCP-Integration müssen komplexe APIs nicht verstanden werden. Stattdessen können einfache Prompts verwendet werden, damit die KI-Plattform die von VoIPstudio bereitgestellten Daten interpretiert und passende Antworten liefert.

Technisch versierte Nutzer möchten jedoch möglicherweise wissen, was „unter der Haube“ passiert. Nachfolgend finden Sie eine Referenz der wichtigsten MCP-Server-Funktionen.

get_recordings¶

Gibt Gesprächsaufzeichnungen zurück. Ist das CX Addon aktiv, enthält jeder Datensatz zusätzlich Transkript, Zusammenfassung, Sentiment, CX-Score und Zeitleiste. Ohne das Addon liefern diese Felder null.

Parameter

Antwortfelder

Beispiel – Niedrige CX-Scores in dieser Woche

Fragen Sie Claude:

"Zeige mir alle Aufzeichnungen dieser Woche mit einem CX-Score unter 6, gruppiert nach Agenten, inklusive einer Zusammenfassung der Probleme in jedem Gespräch."

Claude ruft das Tool mit folgendem Filter auf:

{
  "filters": [
    { "property": "calldate", "operator": "gte", "value": "2026-06-09 00:00:00" },
    { "property": "cx_score", "operator": "lt", "value": 6 }
  ],
  "limit": 100
}

get_cdrs¶

Call Detail Records (CDRs) – das Rohprotokoll jeder Gesprächsverbindung. Geeignet für Volumenstatistiken, Kostenanalysen, Dauerverteilungen und Agentenaktivitätsberichte. Auch ohne CX Addon verfügbar.

Parameter: identisch zu get_recordings (filters, limit, page)

Wichtige Antwortfelder

get_live_calls¶

Liefert eine Echtzeitübersicht aller aktiven Anrufe in Ihrem Konto. Keine Parameter erforderlich.

Beispiel: „Wie viele Gespräche laufen derzeit und welche Agenten sind daran beteiligt?“

get_voicemails¶

Ruft Voicemail-Nachrichten ab. Unterstützt dieselben Parameter filters, limit und page wie die anderen Tools.

Wichtige filterbare Felder: src, dst, calldate, duration, listened

get_recording_audio¶

Gibt eine direkte Download-URL für die MP3-Audiodatei einer bestimmten Aufzeichnung zurück.

Parameter: id (number) – das Feld id aus einer get_recordings-Antwort.

Filterung & Paginierung¶

Alle Listen-Tools akzeptieren optional ein filters-Array. Jedes Filterobjekt besitzt drei Eigenschaften:

Häufige Beispiele¶

Datumsbereich

[
  { "property": "calldate", "operator": "gte", "value": "2026-06-01 00:00:00" },
  { "property": "calldate", "operator": "lte", "value": "2026-06-30 23:59:59" }
]

CX-Score-Schwelle

[
  { "property": "cx_score", "operator": "gte", "value": 8 }
]

Bestimmter Agent

[
  { "property": "src_name", "operator": "eq", "value": "Jane Ryder" }
]

Nur verbundene Anrufe

[
  { "property": "disposition", "operator": "eq", "value": "CONNECTED" }
]

Eingehende Anrufe über 5 Minuten

[
  { "property": "type", "operator": "eq", "value": "I" },
  { "property": "billsec", "operator": "gt", "value": 300 }
]

Anwendungsfälle¶

QA-Bericht für Agenten¶

"Erstelle für jeden Agenten diesen Monat eine QA-Zusammenfassung – durchschnittliche CX-Scores, häufige Beschwerdethemen und die drei Gespräche mit den niedrigsten Bewertungen inklusive Zusammenfassungen."

Anrufvolumen im Callcenter¶

"Wie hoch war unser tägliches Anrufvolumen in dieser Woche? Wie hoch war unsere durchschnittliche Bearbeitungszeit und wie viele Anrufe blieben unbeantwortet?"

Analyse von Stimmungstrends¶

"Verbessert oder verschlechtert sich die Kundenstimmung im Vergleich zum letzten Monat? Welche Gesprächsthemen korrelieren mit negativer Stimmung?"

Liste verpasster Anrufe für Rückrufe¶

"Liste alle verpassten eingehenden Anrufe der letzten 24 Stunden mit Anrufer-ID auf, damit ich Rückrufe priorisieren kann."

Kosten- und Abrechnungsanalyse¶

"Welche Nebenstellen haben in diesem Quartal die teuersten ausgehenden Gespräche geführt?"

Überprüfung des Live-Betriebs¶

"Wie viele Agenten befinden sich aktuell in Gesprächen und gibt es Anrufe, die bereits länger als 20 Minuten dauern?"

Token-Effizienz¶

Jeder Anruf, den Claude ohne das CX Addon analysiert, erfordert die Verarbeitung von Audiodaten sowie die Erstellung einer eigenen Transkription und Analyse. Das CX Addon lagert diesen gesamten Prozess an VoIPstudio aus.

Was VoIPstudio übernimmt (fester Monatspreis, unbegrenzte Anrufe):

• Audiotranskription
• Sprechererkennung (Speaker Diarisation)
• Gesprächszusammenfassung
• Sentiment-Klassifizierung
• Extraktion von Aktionspunkten
• CX-Bewertung

Was Claude erhält: Saubere, strukturierte Textfelder, die sofort für Analysen, Vergleiche und Berichte verwendet werden können.

Dadurch können Sie Claude bitten, Hunderte von Anrufen in einer einzigen Sitzung zu analysieren – bei einem Bruchteil der Token-Kosten. Umfangreiche QA-Auswertungen, Trendanalysen und Coaching-Berichte für Agenten werden so praktikabel, ohne unvorhersehbare KI-Ausgaben.