Zum Hauptinhalt springen

KI - Künstliche Intelligenz - Voipstudio MCP-Server

Der Voipstudio MCP-Server (Model Context Protocol) ermöglicht KI-Assistenten wie Claude und ChatGPT einen direkten und sicheren Zugriff auf Ihre Voipstudio-Kontodaten, einschließlich Aufzeichnungen, CDRs, laufender Anrufe, Voicemails und des Verlaufs Ihrer Konversationen mit einer Rufnummer. Sobald die Verbindung hergestellt ist, kann der Assistent 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. Das reduziert den Aufwand für die KI erheblich, hält den Token-Verbrauch niedrig und macht die Kosten besser vorhersehbar.

MCP-Server-URL​

Dies ist ein Remote-MCP-Server (Streamable-HTTP-Transport). Die Verbindung erfolgt über die Anmeldung mit Ihrem Voipstudio-Konto: Sie müssen keinen API-Schlüssel erstellen oder einfügen.

So funktioniert die Verbindung​

Wenn Sie den Server zu einer KI-Anwendung hinzufügen, öffnet die Anwendung eine Voipstudio-Anmeldeseite:

  1. Melden Sie sich mit Ihrer Voipstudio-E-Mail-Adresse und Ihrem Passwort an (bei aktivierter Zwei-Faktor-Authentifizierung zusätzlich mit Ihrem 2FA-Code) oder mit Google, Microsoft oder Apple, wenn Ihr Konto Single Sign-On verwendet. Das Konto muss bereits bestehen: Über diese Seite lässt sich kein neues Konto anlegen.
  2. Eine Zustimmungsseite zeigt an, wer den Zugriff anfordert. Sie nennt die Adresse, die den Zugriff erhält, und zusätzlich die Anwendung, wenn es sich um eine bekannte Anwendung (Claude, ChatGPT) handelt oder sie auf Ihrem eigenen Computer läuft. Jede andere Website wird mit einer Warnung angezeigt: Erlauben Sie den Zugriff nur, wenn Sie die Adresse kennen.
  3. Klicken Sie auf Allow, um die Verbindung herzustellen, oder auf Cancel, wenn nichts verbunden werden soll.

Der Assistent kann anschließend das sehen, was Ihr Voipstudio-Benutzer sehen kann – und nichts darüber hinaus.

Der API-Schlüssel für jede Anwendung​

Wenn Sie auf Allow klicken, erstellt der Server für diese Anwendung einen Voipstudio-API-Schlüssel im Abschnitt API Keys Ihres Benutzers. Sein Name beginnt mit VoIPstudio MCP - , gefolgt vom Namen der Anwendung, zum Beispiel VoIPstudio MCP - Claude (claude.ai) [1a2b3c4d].

  • Jede verbundene Anwendung hat einen eigenen Schlüssel. Eine erneute Anmeldung aus derselben Anwendung ersetzt nur den Schlüssel dieser Anwendung, sodass Ihre anderen Anwendungen verbunden bleiben.
  • Ein Benutzer kann bis zu 10 dieser Schlüssel haben. Wird eine elfte Anwendung verbunden, wird der am längsten nicht verwendete Schlüssel entfernt.
  • Ein Schlüssel läuft nach 30 Tagen ohne Nutzung ab. Normale Nutzung – auch die Erneuerung der Anmeldung, die die Anwendung im Hintergrund vornimmt – hält ihn aktiv.
  • Um eine Anwendung zu trennen, entfernen Sie den Connector in der Anwendung oder löschen Sie ihren Schlüssel unter API Keys. Nach dem Löschen des Schlüssels melden die Tool-Aufrufe der Anwendung, dass die Verbindung entfernt wurde, und die Anwendung fordert Sie auf, sich erneut anzumelden.

Verbindung mit Claude herstellen​

Fügen Sie Voipstudio in Claude (Web- oder Desktop-App) als benutzerdefinierten Connector hinzu:

  1. Öffnen Sie Settings → Connectors und wählen Sie Add custom connector. Bei Team- und Enterprise-Tarifen fügt ein Inhaber den Connector für die Organisation hinzu.
  2. Geben Sie einen Namen, zum Beispiel Voipstudio, und die oben genannte MCP-Server-URL ein.
  3. Klicken Sie auf Connect und schließen Sie die oben beschriebenen Schritte zur Anmeldung und Zustimmung ab.

Claude kann die Voipstudio-Tools nun in jeder Unterhaltung verwenden. Beim ersten Aufruf eines Tools bittet Claude Sie um eine Bestätigung. Wählen Sie Always allow, um diese Abfrage künftig zu überspringen.

Claude Code​

claude mcp add --transport http voipstudio https://mcp.voipstudio.com/mcp
claude mcp login voipstudio

Ihr Browser öffnet die Anmeldeseite. Klicken Sie nach Allow auf Continue, um die Anmeldung an Claude Code zurückzugeben.

Auf einem Rechner ohne Browser, zum Beispiel über SSH, führen Sie stattdessen claude mcp login voipstudio --no-browser aus. Öffnen Sie die ausgegebene Adresse in einem Browser auf einem beliebigen Computer, melden Sie sich an und erlauben Sie den Zugriff. Kopieren Sie dann die Adresse, die auf der letzten Seite angezeigt wird, und fügen Sie sie in Claude Code ein, sobald Sie dazu aufgefordert werden.

Verbindung mit anderen KI-Plattformen​

Jede KI-Anwendung, die Remote-MCP-Server mit Anmeldung (OAuth) unterstützt, kann sich über die oben genannte URL verbinden, zum Beispiel ChatGPT, sofern Ihr Tarif benutzerdefinierte Connectors zulässt. Suchen Sie in den Einstellungen der Anwendung nach einer Option mit der Bezeichnung custom connector, custom MCP oder remote MCP, geben Sie die URL ein und schließen Sie die Schritte zur Anmeldung und Zustimmung ab. Die genauen Menüs hängen von der Anwendung und Ihrem Tarif ab.

Anwendungen, die nur einen festen API-Schlüssel senden können, lassen sich nicht verbinden: Dieser Server akzeptiert ausschließlich die Anmeldung, die er selbst ausstellt.

Für Entwickler​

Der Server implementiert die MCP-Autorisierung:

  • OAuth-2.1-Autorisierungscode-Flow mit PKCE (S256) und dynamischer Client-Registrierung. Die Metadaten werden unter https://mcp.voipstudio.com/.well-known/oauth-authorization-server und https://mcp.voipstudio.com/.well-known/oauth-protected-resource/mcp veröffentlicht.
  • Access-Tokens sind eine Stunde gültig und werden mit einem Refresh-Token erneuert. Ein Refresh-Token bleibt gültig, solange es mindestens einmal alle 30 Tage verwendet wird.
  • Nur initialize und tools/list funktionieren ohne Token. Ein Voipstudio-API-Schlüssel wird nicht als Bearer-Token akzeptiert.
  • Anfragen sind pro Client-Adresse begrenzt: Client-Registrierungen auf 20 pro Stunde, Token-Anfragen auf 50 und Autorisierungsanfragen auf 100 pro 15 Minuten.

Um den Server über den MCP-Connector der Claude API aufzurufen, bezieht Ihre Anwendung über den oben beschriebenen Flow ein Access-Token und übergibt es als authorization_token des Servers. Das Anfrageformat finden Sie in der Dokumentation von Anthropic zum MCP-Connector.

CX Addon​

Ohne das CX Addon werden Aufzeichnungen als Rohmetadaten geliefert. Die KI muss jeden Anruf selbst transkribieren und analysieren und verbraucht dabei pro Aufzeichnung eine erhebliche Anzahl von Tokens.

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. Die KI erhält bereits aufbereitete Informationen und kann sofort mit der Analyse beginnen.

Ohne CX AddonMit CX Addon
TranskriptDie KI muss Audio abrufen und transkribieren/übersetzen✓ Enthalten, mit Sprechererkennung
ZusammenfassungDie KI muss sie erstellen✓ Enthalten
StimmungDie KI muss sie ableiten✓ Enthalten
AktionspunkteDie KI muss sie extrahieren✓ Enthalten
CX-ScoreNicht verfügbar✓ 1–10 für jeden Anruf
Ca. Tokens pro Anruf10.000–15.000300–500
KostenmodellVariable KI-KostenFestes Monatsabonnement

Durch das CX Addon freigeschaltete Felder​

FeldTypBeschreibung
transcriptstringVollständiges Transkript auf Wortebene
transcript_speakersobjectTranskriptsegmente mit Sprecherzuordnung
summarystringKurze Zusammenfassung des Anrufergebnisses
sentimentstringKundenstimmung: positive, neutral, negative
cx_scorenumber (1–10)Kundenerlebnis-Score
metadata.timelinearrayWichtige Ereignisse und Aktionspunkte aus dem Gespräch

Tool-Referenz​

Mit MCP müssen Sie sich nicht in die Voipstudio-API einarbeiten: Sie stellen Ihre Fragen in natürlicher Sprache, und die KI wählt die Tools aus und ruft die Daten für Sie ab.

Technisch versierte Nutzer, die wissen möchten, was „unter der Haube“ passiert, finden unten die sechs Tools, die der Server bereitstellt. Alle greifen ausschließlich lesend auf Daten zu.

get_recordings​

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

Parameter

ParameterTypStandardBeschreibung
filtersarray—Filterobjekte, siehe Filterung, Sortierung und Paginierung unten
sortobject—{ "by": "<field>", "dir": "ASC" } oder "DESC"
limitnumber10Datensätze pro Seite (1–1000)
pagenumber1Seitennummer

Antwortfelder

FeldTypBeschreibung
idnumberEindeutige Aufzeichnungs-ID
call_idnumberVerknüpft mit der CDR-call_id
timestampstringBeginn der Aufzeichnung (UTC, YYYY-MM-DD HH:mm:ss)
callerstringRufnummer des Anrufers
calledstringZielrufnummer
src_namestringName des Agenten (Quelle)
dst_namestringName des Ziels
durationnumberDauer in Sekunden
typestringI = eingehend, O = ausgehend
contextstringAnrufkontext (z. B. LOCAL_USER, QUEUE)
transcriptstring | nullVollständiges Transkript (CX Addon)
transcript_speakersobject | nullSprechergetrenntes Transkript (CX Addon)
summarystring | nullGesprächszusammenfassung (CX Addon)
sentimentstring | nullKundenstimmung (CX Addon)
cx_scorenumber | nullCX-Score 1–10 (CX Addon)
metadata.timelinearray | nullWichtige Ereignisse & Aktionen (CX Addon)

Beispiel – Niedrige CX-Scores in dieser Woche

Fragen Sie: „Zeige mir alle Aufzeichnungen dieser Woche mit einem CX-Score unter 6, gruppiert nach Agenten, mit einer Zusammenfassung dessen, was bei jedem Gespräch schiefgelaufen ist.“

Die KI ruft das Tool mit folgenden Parametern auf:

{
"filters": [
{ "property": "timestamp", "operator": "gte", "value": "2026-11-09 00:00:00" },
{ "property": "cx_score", "operator": "lt", "value": 6 }
],
"sort": { "by": "cx_score", "dir": "ASC" },
"limit": 100
}

get_cdrs​

Call Detail Records – das Rohprotokoll jeder Gesprächsverbindung. Geeignet für Volumenstatistiken, Kostenanalysen, Dauerverteilungen und Übersichten zur Agentenaktivität. Auch ohne CX Addon verfügbar.

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

Wichtige Antwortfelder

FeldTypBeschreibung
call_idnumberEindeutige Anruf-ID
calldatestringAnrufbeginn (UTC)
src_namestringAgenten-/Anrufername
dst_namestringZielname
billsecnumberAbrechenbare Sekunden
durationnumberGesamtdauer in Sekunden einschließlich Klingelzeit
dispositionstringCONNECTED, NO ANSWER, BUSY, FAILED
chargenumberGesprächskosten
typestringI = eingehend, O = ausgehend
src_uastringQuellgerät / Softphone-User-Agent
labelsarrayIn Voipstudio vergebene benutzerdefinierte Tags

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, sort, limit und page wie get_recordings.

Wichtige Felder: caller, callerid, dialled (die gewählte Rufnummer), origtime (Zeitpunkt, zu dem die Nachricht hinterlassen wurde), duration, folder, is_new, transcript

get_recording_audio​

Gibt die Adresse der MP3-Audiodatei einer Aufzeichnung zurück, zusammen mit Anrufer, Zielrufnummer, Zeitpunkt und Dauer.

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

info

Die Adresse verweist auf die Voipstudio-API. Zum Herunterladen ist ein Voipstudio-API-Schlüssel im Header x-auth-token erforderlich; die KI erhält daher die Adresse, nicht die Audiodatei.

get_history_for_number​

Listet für eine Rufnummer die Konversationen (Anrufe und SMS) in Ihrem Konto auf.

Parameter

ParameterTypStandardBeschreibung
numberstring—Die Rufnummer (erforderlich)
fromDateTimestring—Optionaler Beginn, YYYY-MM-DD HH:mm:ss
toDateTimestring—Optionales Ende, YYYY-MM-DD HH:mm:ss

Antwortfelder (ein Eintrag pro Anruf oder Nachricht): channel, date, direction (Inbound oder Outbound), src, dst, src_name, dst_name, content

Beispiel: „Zeige mir alle Anrufe und SMS mit +44 20 7946 0000 in diesem Monat.“

Filterung, Sortierung und Paginierung​

get_recordings, get_cdrs und get_voicemails akzeptieren ein optionales filters-Array. Jedes Filterobjekt hat drei Eigenschaften:

EigenschaftBeschreibung
propertyJedes Feld der Antwort des Tools (z. B. calldate, cx_score, src_name)
operatoreq, ne, lt, lte, gt, gte, in, like, notlike (die Symbole =, !=, <, <=, >, >= funktionieren ebenfalls)
valueString, Zahl oder Array (für den Operator in)

Das Datumsfeld unterscheidet sich je nach Tool: calldate für CDRs, timestamp für Aufzeichnungen, origtime für Voicemails.

Die Ergebnisse werden mit sort sortiert, zum Beispiel { "by": "calldate", "dir": "DESC" }, und mit limit (Standard 10, höchstens 1000) und page (Standard 1) paginiert.

Häufige Beispiele​

Datumsbereich (CDRs)

[
{ "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 (Aufzeichnungen)

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

Bestimmter Agent

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

Nur verbundene Anrufe (CDRs)

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

Eingehende Anrufe über 5 Minuten (CDRs)

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

Anwendungsfälle​

QA-Bericht für Agenten​

„Erstelle für jeden Agenten eine QA-Zusammenfassung für diesen Monat – 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.“

Kundenhistorie​

„Zeige mir alle Anrufe und SMS, die wir in diesem Jahr mit +44 20 7946 0000 hatten, und fasse zusammen, was besprochen wurde.“

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 die KI 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
  • Gesprächszusammenfassung
  • Sentiment-Klassifizierung
  • Extraktion von Aktionspunkten
  • CX-Bewertung

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

Dadurch können Sie die KI 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.