Voipstudio MCP Server

offiziell

Der VoIPstudio MCP Server gibt kompatiblen KI-Assistenten sicheren Zugriff auf autorisierte VoIPstudio-Kontodaten, einschließlich Aufzeichnungen, Anrufdetaildatensätzen, Live-Anrufen und Voicemails, um Anrufaktivitäten abzufragen, Muster zu analysieren, Leistungsprobleme von Agenten zu identifizieren und QA- oder Betriebsberichte in einfachem Englisch zu erstellen.

Auf voipstudio.com ansehen

Dokumentation

KI – Künstliche Intelligenz – VoIPstudio MCP Server¶

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

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

API-Schlüssel erhalten¶

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

So generieren Sie einen Schlüssel:

Öffnen Sie im Admin-Dashboard den Benutzer, für den Sie ein Token generieren möchten.
Gehen Sie zum Abschnitt API-Schlüssel.
Geben Sie einen Namen für den Schlüssel ein – zum Beispiel Claude MCP.
Klicken Sie auf Hinzufügen.
Klicken Sie auf das Augen-Symbol, um den API-Schlüssel / user_token anzuzeigen. Kopieren Sie diesen Wert.
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 ein längeres Timeout (oder unbegrenzt) fest, bevor Sie auf Hinzufügen klicken.

Siehe REST-API-Dokumentation

Mit Claude verbinden¶

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

MCP-Server-URL¶

MCP-Server-URL

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

Schritte (Claude.ai)¶

Gehen Sie in Claude.ai zu Einstellungen → Integrationen (oder zum Connectors-Panel, je nach Ihrem Plan).
Wählen Sie Benutzerdefinierten MCP-Server hinzufügen (oder Äquivalent).
Geben Sie die obige MCP-Server-URL ein.
Wenn Sie zur Authentifizierung aufgefordert werden, geben Sie Ihren VoIPstudio-API-Schlüssel an.
Speichern und autorisieren Sie die Verbindung.

Claude kann nun in jeder Konversation VoIPstudio-Tools aufrufen. Wenn ein Tool zum ersten Mal in einer Sitzung aufgerufen wird, wird Claude Sie bitten, die Datenfreigabe zu 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"
    }]
  })
});

Mit anderen KI-Plattformen verbinden¶

Die meisten KI-Plattformen, die externe MCPs unterstützen, können sich mit derselben URL und demselben API-Schlüssel mit dem VoIPstudio MCP-Server verbinden. 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 Aufzeichnungen als reine Metadaten an. Claude muss jeden Anruf selbst transkribieren und analysieren, was erhebliche Token pro Aufzeichnung verbraucht.

Mit dem CX Addon übernimmt VoIPstudio Transkription, Zusammenfassung, Stimmungsanalyse, Aktionspunktextraktion und CX-Bewertung auf seiner eigenen Infrastruktur zu festen monatlichen Kosten ohne Gebühren pro Anruf und ohne Transkriptionslimits. Claude erhält fertige Informationen – bereit zur sofortigen Verarbeitung.

Ohne CX Addon	Mit CX Addon
Transkript	Claude muss Audio abrufen und transkribieren/übersetzen	✓ Enthalten, mit Sprecherdiarisierung
Zusammenfassung	Claude muss generieren	✓ Enthalten
Stimmung	Claude muss ableiten	✓ Enthalten
Aktionspunkte	Claude muss extrahieren	✓ Enthalten
CX-Score	Nicht verfügbar	✓ 1–10 für jeden 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 Transkript auf Wortebene
transcript_speakers	object	Sprecherdiarisierte Transkriptsegmente
summary	string	Kurze Zusammenfassung des Anrufergebnisses
sentiment	string	Kundenstimmung: positiv, neutral, negativ
cx_score	number (1–10)	Kundenerfahrungs-Score
metadata.timeline	array	Schlüsselmomente und extrahierte Aktionspunkte

Tools-Referenz¶

Die Einfachheit der MCP-Integration bedeutet, dass komplexe APIs nicht verstanden werden müssen und stattdessen einfache Prompts der KI-Plattform helfen können, die von Voipstudio bereitgestellten Daten zu verstehen und angemessen zu antworten.

Einige technisch versiertere Benutzer möchten jedoch vielleicht wissen, was „unter der Haube“ passiert. Daher finden Sie unten eine Referenzanleitung zu einigen der MCP-Server-Funktionen.

get_recordings¶

Gibt Anrufaufzeichnungen 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 Aufzeichnungs-ID
call_id	number	Verknüpft mit CDR call_id
timestamp	string	Aufzeichnungsbeginn (UTC, JJJJ-MM-TT 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: "Zeige mir alle Aufzeichnungen dieser Woche, bei denen der CX-Score unter 6 lag, gruppiert nach Agent, mit einer Zusammenfassung, was bei jedem Anruf schiefgelaufen ist."

Claude ruft das Tool auf mit:

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

get_cdrs¶

Anrufdetaildatensätze – das Rohprotokoll jedes Anrufabschnitts. Verwenden Sie sie für Volumenstatistiken, Kostenanalyse, Dauer-Verteilungen und Agentenaktivitätsübersichten. Ohne CX Addon verfügbar.

Parameter: wie get_recordings (filters, limit, page)

Wichtige Antwortfelder

Feld	Typ	Beschreibung
call_id	number	Eindeutige Anrufkennung
calldate	string	Anrufbeginn-Zeitstempel (UTC)
src_name	string	Agenten-/Anrufername
dst_name	string	Zielname
billsec	number	Abrechenbare Sekunden
duration	number	Gesamtsekunden inklusive Klingeln
disposition	string	VERBUNDEN, KEINE ANTWORT, BESETZT, FEHLGESCHLAGEN
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-Momentaufnahme aller aktiven Anrufe auf Ihrem Konto zurück. Keine Parameter erforderlich.

Beispiel: "Wie viele Anrufe sind gerade in Bearbeitung 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 Aufzeichnung zurück.

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

Info

Audio-URLs sind zeitlich begrenzt. Verwenden Sie sie umgehend; speichern Sie sie nicht für längere Zeiträume zwischen.

Filterung & Paginierung¶

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

Eigenschaft	Beschreibung
property	Zu filternder Feldname (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 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¶

QA-Bericht für Agenten¶

"Gib mir eine QA-Zusammenfassung für jeden Agenten in diesem Monat – CX-Score-Durchschnitte, häufige Beschwerdethemen und ihre drei Anrufe mit den niedrigsten Bewertungen mit Zusammenfassungen."

Anrufzentralen-Volumenstatistiken¶

"Wie war unser Anrufvolumen nach Tagen in dieser Woche? Wie 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?"

Rückrufliste für verpasste Anrufe¶

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

Kosten- & Abrechnungsprüfung¶

"Welche Nebenstellen 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 bereits über 20 Minuten laufen?"

Token-Effizienz¶

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

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

Audiotranskription
Sprecherdiarisierung
Anrufzusammenfassung
Stimmungsklassifizierung
Aktionspunktextraktion
CX-Bewertung

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

Das bedeutet, Sie können Claude bitten, Hunderte von Anrufen in einer einzigen Sitzung zu analysieren, und das zu einem Bruchteil der Token-Kosten, was umfangreiche QA, Trendanalysen und Agenten-Coaching-Berichte ohne unvorhersehbare KI-Ausgaben praktikabel macht.