Voipstudio MCP

KI – Künstliche Intelligenz – VoIPstudio MCP-Server

Der VoIPstudio-MCP-Server (Model Context Protocol) gibt Claude AI direkten, sicheren Zugriff auf Ihre VoIPstudio-Kontodaten, einschließlich Aufnahmen, CDRs, Live-Anrufen und Voicemails. Nach der Verbindung kann Claude Anrufe abfragen, Muster analysieren, Leistungsprobleme von Agenten aufdecken und QA-Berichte in einfachem Englisch erstellen – ohne dass eine individuelle Entwicklung erforderlich ist.

Fügen Sie das CX-Addon hinzu, und jede Aufnahme wird bereits mit Transkript, Zusammenfassung, Stimmung, Aktionspunkten und einem CX-Score angereichert. Dies reduziert die KI-Arbeit, die Claude leisten muss, erheblich, hält Ihren Token-Verbrauch niedrig und macht die Kosten besser planbar.

API-Schlüssel erhalten

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

So generieren Sie einen Schlüssel:

1. Öffnen Sie im Admin-Dashboard den Benutzer, für den Sie ein Token generieren möchten.
2. Gehen Sie zum Abschnitt API-Schlüssel.
3. Geben Sie einen Namen für den Schlüssel ein – zum Beispiel Claude MCP.
4. Klicken Sie auf Hinzufügen.
5. Klicken Sie auf das Augen-Symbol, um den API-Schlüssel / user_token anzuzeigen. Kopieren Sie diesen Wert.
6. Um weitere Details anzuzeigen oder den Schlüssel zu löschen, klicken Sie auf das Zahnrad-Symbol und wählen Sie Details anzeigen.

Hinweis: Der API-Schlüssel bleibt gültig, solange er mindestens einmal alle 7 Tage verwendet wird (Standard-Timeout). Legen Sie bei Bedarf vor dem Klicken auf „Hinzufügen“ einen längeren Timeout (oder unbegrenzt) fest.

Siehe REST-API-Dokumentation

Verbindung mit Claude herstellen

VoIPstudio ist derzeit nicht im Connector-Verzeichnis von Claude.ai aufgeführt. Sie fügen es manuell als benutzerdefinierten MCP-Server hinzu.

MCP-Server-URL

[!info] MCP-Server-URL https://mcp.voipstudio.workers.dev/sse

Schritte (Claude.ai)

1. Gehen Sie in Claude.ai zu Einstellungen → Integrationen (oder zum Konnektoren-Bereich, je nach Ihrem Plan).
2. Wählen Sie Benutzerdefinierten MCP-Server hinzufügen (oder entsprechend).
3. Geben Sie die obige MCP-Server-URL ein.
4. Geben Sie bei Aufforderung zur Authentifizierung Ihren VoIPstudio-API-Schlüssel an.
5. Speichern und autorisieren Sie die Verbindung.

Claude kann nun in jeder Konversation VoIPstudio-Tools aufrufen. Beim ersten Aufruf eines Tools in einer Sitzung fragt Claude Sie, ob Sie die Datenfreigabe bestätigen. Klicken Sie auf Immer erlauben, um diese Aufforderung in zukünftigen Sitzungen 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 über dieselbe URL und denselben API-Schlüssel eine Verbindung zum VoIPstudio-MCP-Server herstellen. Die genauen Konfigurationsschritte variieren je nach Plattform. Suchen Sie in den Integrationen oder Einstellungen Ihrer Plattform nach einer Option mit der Bezeichnung externer MCP-Server, benutzerdefinierter MCP oder Remote-MCP.

CX-Addon

Ohne das CX-Addon kommen Aufnahmen als rohe Metadaten an. Claude muss jeden Anruf selbst transkribieren und analysieren, was pro Aufnahme erhebliche Token verbraucht.

Mit dem CX-Addon übernimmt VoIPstudio Transkription, Zusammenfassung, Stimmungsanalyse, Aktionspunkte-Extraktion und CX-Bewertung auf eigener Infrastruktur zu festen monatlichen Kosten ohne Gebühren pro Anruf und ohne Transkriptionslimits. Claude erhält fertige Informationen – sofort bereit für die Analyse.

	Ohne CX-Addon	Mit CX-Addon
Transkript	Claude muss Audio abrufen und transkribieren/übersetzen	✓ Enthalten, mit Sprecher-Diarisierung
Zusammenfassung	Claude muss sie erstellen	✓ Enthalten
Stimmung	Claude muss sie ableiten	✓ Enthalten
Aktionspunkte	Claude muss sie extrahieren	✓ Enthalten
CX-Score	Nicht verfügbar	✓ 1–10 bei jedem Anruf
Ca. Token/Anruf	10.000–15.000	300–500
Kostenmodell	Variable KI-Ausgaben	Feste monatliche Abonnementgebühr

Durch CX-Addon freigeschaltete Felder

Feld	Typ	Beschreibung
transcript	string	Vollständiges Wort-für-Wort-Transkript
transcript_speakers	object	Transkriptsegmente mit Sprecher-Diarisierung
summary	string	Präzise Zusammenfassung des Anrufergebnisses
sentiment	string	Kundenstimmung: positive, neutral, negative
cx_score	number (1–10)	Kundenerfahrungs-Score
metadata.timeline	array	Wichtige Momente und Aktionspunkte aus dem Anruf

Tool-Referenz

Die Einfachheit der MCP-Integration bedeutet, dass komplexe APIs nicht verstanden werden müssen; stattdessen können einfache Eingabeaufforderungen der KI-Plattform helfen, die von VoIPstudio bereitgestellten Daten zu verstehen und mit einer angemessenen Antwort zu reagieren.

Einige technisch versiertere Benutzer möchten jedoch möglicherweise wissen, was „unter der Haube“ passiert. Nachfolgend finden Sie daher eine Referenz zu einigen der MCP-Server-Funktionen.

get_recordings

Gibt Anrufaufnahmen zurück. Bei aktivem CX-Addon enthält jeder Datensatz Transkript, Zusammenfassung, Stimmung, CX-Score und Zeitachse. Ohne das Addon geben diese Felder null zurück.

Parameter

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

Antwortfelder

Feld	Typ	Beschreibung
id	number	Eindeutige Aufnahme-ID
call_id	number	Verknüpfung zu CDR call_id
timestamp	string	Aufnahmebeginn (UTC, YYYY-MM-DD HH:mm:ss)
caller	string	Rufnummer des Anrufers
called	string	Rufnummer des Angerufenen
src_name	string	Agentenname (Quelle)
dst_name	string	Zielname
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 diese Woche

Fragen Sie Claude: „Zeig mir alle Aufnahmen dieser Woche, bei denen der CX-Score unter 6 lag, gruppiert nach Agent, mit einer Zusammenfassung dessen, was bei jedem Anruf schiefgelaufen ist.“

Claude ruft das Tool mit folgenden Argumenten 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 – das rohe Protokoll jedes Anrufabschnitts. Verwenden Sie es für Volumenstatistiken, Kostenanalysen, Dauerverteilungen und Zusammenfassungen der Agentenaktivität. Ohne CX-Addon verfügbar.

Parameter: wie bei get_recordings (filters, limit, page)

Wichtige Antwortfelder

Feld	Typ	Beschreibung
call_id	number	Eindeutige Anrufkennung
calldate	string	Zeitstempel des Anrufbeginns (UTC)
src_name	string	Agenten-/Anrufername
dst_name	string	Zielname
billsec	number	Abrechenbare Sekunden
duration	number	Gesamtsekunden inklusive Klingeln
disposition	string	CONNECTED, NO ANSWER, BUSY, FAILED
charge	number	Anrufkosten
type	string	I \= eingehend, O \= ausgehend
src_ua	string	Quellgerät / Softphone-User-Agent
labels	array	In VoIPstudio angewendete benutzerdefinierte Tags

get_live_calls

Gibt eine Echtzeit-Snapshot aller aktiven Anrufe auf Ihrem Konto zurück. Keine Parameter erforderlich.

Beispiel: „Wie viele Anrufe laufen gerade, und welche Agenten sind daran beteiligt?“

get_voicemails

Ruft Voicemail-Nachrichten ab. Gleiche filters-, limit- und page-Schnittstelle wie andere Tools.

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

get_recording_audio

Gibt eine direkte Download-URL für das MP3-Audio einer bestimmten Aufnahme zurück.

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

[!info] Info Audio-URLs sind zeitlich begrenzt. Verwenden Sie sie zeitnah; speichern Sie sie nicht über längere Zeiträume zwischen.

Filterung & Paginierung

Alle Listen-Tools akzeptieren ein optionales filters-Array. Jedes Filterobjekt hat drei Eigenschaften:

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

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-Schwellenwert

[{ "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

Agent-QA-Bericht

„Gib mir eine QA-Zusammenfassung für jeden Agenten diesen Monat – CX-Score-Durchschnitte, häufige Beschwerdethemen und ihre drei Anrufe mit der niedrigsten Bewertung inklusive Zusammenfassungen.“

Callcenter-Volumenstatistiken

„Wie hoch war unser Anrufvolumen pro Tag diese Woche? Wie hoch war unsere durchschnittliche Bearbeitungszeit, und wie viele Anrufe blieben unbeantwortet?“

Stimmungstrend-Analyse

„Verbessert oder verschlechtert sich die Kundenstimmung im Vergleich zum letzten Monat? Welche Anrufthemen korrelieren mit negativer Stimmung?“

Liste verpasster Anrufe für Rückrufe

„Liste alle verpassten eingehenden Anrufe der letzten 24 Stunden mit Anruferkennungen auf, damit ich Rückrufe priorisieren kann.“

Kosten- & Abrechnungsprüfung

„Welche Nebenststellen haben in diesem Quartal die teuersten ausgehenden Anrufe getätigt?“

Live-Betriebsprüfung

„Wie viele Agenten sind gerade in Anrufen, und gibt es Anrufe, die länger als 20 Minuten laufen?“

Token-Effizienz

Jeder Anruf, den Claude ohne das CX-Addon analysiert, erfordert, dass Claude Audioinhalte verarbeitet und eigene Transkription und Analyse erstellt. Das CX-Addon lagert dies vollständig an VoIPstudio aus:

Was VoIPstudio übernimmt (feste monatliche Kosten, unbegrenzte Anrufe):

• Audiotranskription
• Sprecher-Diarisierung
• Anrufzusammenfassung
• Stimmungsklassifizierung
• Aktionspunkte-Extraktion
• CX-Bewertung

Was Claude erhält: Saubere, strukturierte Textfelder, bereit für Analyse, Vergleich und Berichterstattung.

Das bedeutet, Sie können Claude bitten, Hunderte von Anrufen in einer einzigen Sitzung zu analysieren – zu einem Bruchteil der Token-Kosten. So werden groß angelegte QA-, Trendanalysen und Agenten-Coaching-Berichte praktikabel, ohne unvorhersehbare KI-Ausgaben.