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:

Öffnen Sie im Admin-Dashboard den Benutzer, für den Sie ein Token erstellen möchten.
Wechseln Sie zum Abschnitt API Keys.
Geben Sie einen Namen für den Schlüssel ein, z. B. Claude MCP.
Klicken Sie auf Add.
Klicken Sie auf das Augensymbol, um den API-Schlüssel bzw. user_token anzuzeigen. Kopieren Sie diesen Wert.
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

info

https://mcp.voipstudio.workers.dev/sse

Schritte (Claude.ai)

Gehen Sie in Claude.ai zu Settings → Integrations (oder zum Connector-Bereich, abhängig von Ihrem Tarif).
Wählen Sie Add custom MCP server (oder die entsprechende Option).
Geben Sie die oben genannte MCP-Server-URL ein.
Geben Sie bei der Authentifizierungsaufforderung Ihren Voipstudio-API-Schlüssel an.
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.

	Ohne CX Addon	Mit CX Addon
Transkript	Claude muss Audio abrufen und transkribieren/übersetzen	✓ Enthalten, mit Sprechererkennung
Zusammenfassung	Claude muss sie erstellen	✓ Enthalten
Stimmungsanalyse	Claude muss sie ableiten	✓ Enthalten
Aktionspunkte	Claude muss sie extrahieren	✓ Enthalten
CX-Score	Nicht verfügbar	✓ 1–10 für jeden Anruf
Ca. Tokens pro Anruf	10.000–15.000	300–500
Kostenmodell	Variable KI-Kosten	Festes Monatsabonnement

Durch das CX Addon freigeschaltete Felder

Feld	Typ	Beschreibung
`transcript`	string	Vollständiges Transkript auf Wortebene
`transcript_speakers`	object	Transkriptsegmente mit Sprecherzuordnung
`summary`	string	Kurze Zusammenfassung des Anrufergebnisses
`sentiment`	string	Kundenstimmung: `positive`, `neutral`, `negative`
`cx_score`	number (1–10)	Kundenerlebnis-Score
`metadata.timeline`	array	Wichtige Ereignisse und Aktionspunkte aus dem Gespräch

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

Parameter	Typ	Standard	Beschreibung
`filters`	array	—	Filterobjekte – siehe Filtering
`limit`	number	10	Datensätze pro Seite (max. 1000)
`page`	number	1	Seitennummer

Antwortfelder

Feld	Typ	Beschreibung
`id`	number	Eindeutige Aufzeichnungs-ID
`call_id`	number	Verknüpft mit der CDR-`call_id`
`timestamp`	string	Beginn der Aufzeichnung (UTC, `YYYY-MM-DD HH:mm:ss`)
`caller`	string	Rufnummer des Anrufers
`called`	string	Zielrufnummer
`src_name`	string	Name des Agenten (Quelle)
`dst_name`	string	Name des Ziels
`duration`	number	Dauer in Sekunden
`type`	string	`I` = eingehend, `O` = ausgehend
`context`	string	Anrufkontext (z. B. `LOCAL_USER`, `QUEUE`)
`transcript`	string	null
`transcript_speakers`	object	null
`summary`	string	null
`sentiment`	string	null
`cx_score`	number	null
`metadata.timeline`	array	null

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

Feld	Typ	Beschreibung
`call_id`	number	Eindeutige Anruf-ID
`calldate`	string	Anrufbeginn (UTC)
`src_name`	string	Agenten-/Anrufername
`dst_name`	string	Zielname
`billsec`	number	Abrechenbare Sekunden
`duration`	number	Gesamtdauer einschließlich Klingelzeit
`disposition`	string	`CONNECTED`, `NO ANSWER`, `BUSY`, `FAILED`
`charge`	number	Gesprächskosten
`type`	string	`I` = eingehend, `O` = ausgehend
`src_ua`	string	Quellgerät / Softphone User-Agent
`labels`	array	Benutzerdefinierte Tags in Voipstudio

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.

info

Audio-URLs sind zeitlich begrenzt gültig. Verwenden Sie sie zeitnah und speichern Sie sie nicht langfristig zwischen.

Filterung & Paginierung

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

Eigenschaft	Beschreibung
`property`	Feldname, nach dem gefiltert wird (z. B. `calldate`, `cx_score`, `src_name`)
`operator`	`eq`, `ne`, `lt`, `lte`, `gt`, `gte`, `in`, `like`, `notlike`
`value`	String, Zahl oder Array (für den Operator `in`)

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.

API-Schlüssel erhalten​

Verbindung mit Claude herstellen​

MCP-Server-URL​

Schritte (Claude.ai)​

Anthropic API (für Entwickler)​

Verbindung mit anderen KI-Plattformen​

CX Addon​

Durch das CX Addon freigeschaltete Felder​

Tool-Referenz​

get_recordings​

get_cdrs​

get_live_calls​

get_voicemails​

get_recording_audio​

Filterung & Paginierung​

Häufige Beispiele​

Anwendungsfälle​

QA-Bericht für Agenten​

Anrufvolumen im Callcenter​

Analyse von Stimmungstrends​

Liste verpasster Anrufe für Rückrufe​

Kosten- und Abrechnungsanalyse​

Überprüfung des Live-Betriebs​

Token-Effizienz​