Ringostat über MCP mit Microsoft Copilot verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Ringostat klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Ringostat + Microsoft Copilot

Ringostat Call-Tracking und virtuelle Telefonanlage: Anrufprotokoll mit Traffic-Quellen, Gesprächsdauer, Status, Mitarbeitern und Aufnahme-Links, wer online oder im Gespräch ist, Mitarbeiter mit Abteilungen, SIP-Online-Bericht und Smart-Phone-Status. Rückrufe sind bei der Installation deaktiviert.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

RINGOSTAT_AUTH_KEY, RINGOSTAT_PROJECT_ID

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten und braucht einen Projektadministrator in Ringostat.

1. Öffne in Ringostat Settings, Integrations, Ringostat API und kopiere den Auth-key in RINGOSTAT_AUTH_KEY. Er gehört zu einem Projekt und wird im Header Auth-key gesendet.
2. Setz RINGOSTAT_PROJECT_ID auf die Nummer dieses Projekts: den Wert nach project_id= oder projectId= in der Adresszeile der Ringostat-Web-App, z. B. 39071. Nur die Tools für Mitarbeiter, SIP-Bericht und eigene Status nutzen sie.
3. Installiere den Connector; die Prüfung führt ringostat_list_online_sip aus.

Was er liest: das Anrufprotokoll eines Zeitraums, eine Zeile pro Anruf mit den Spalten, die du anforderst: Datum, anrufende und angerufene Nummer, Anruftyp, Status (disposition), Gesprächsdauer, Gesamtdauer und Wartezeit, Name und Abteilung des Mitarbeiters, Nummernpool und Weiterleitungsschema, Ziel- und Wiederholungsmarkierung, UTM-Source, -Medium, -Campaign, -Content und -Term, Landingpage und Referrer, der Grund für einen verpassten Anruf, CSAT-Bewertung, Anruf-ID und Aufnahme-Link; die SIP-Konten, die gerade online sind, und die, die gerade telefonieren; die Mitarbeiter mit SIP-Status, vollem Namen, E-Mail, Durchwahl, staffId, Abteilungen und Rufzielen (Haupt- und Ersatz-SIP-Konten oder Telefonnummern); Online- und Offline-Zeit pro Mitarbeiter und Tag; und die eigenen Smart-Phone-Status wie Mittagspause oder Meeting.

Anrufprotokoll: ringostat_list_calls nimmt from und to als YYYY-MM-DD HH:MM:SS; ohne sie liefert es die letzten 24 Stunden. Die Antwort ist ein einziges Array mit jedem Anruf des Zeitraums, ohne Seiten, deshalb hält die KI die Zeiträume bei stark genutzten Projekten kurz (ein Tag oder eine Woche) und fordert nur die fields an, die sie braucht. Die Gesprächsdauer ist billsec in Sekunden; call_type ist in, out, callback, transitin oder transitout; proper_flag und repeated_flag markieren Ziel- und Wiederholungsanrufe. Für Statistiken pro Mitarbeiter gruppiert die KI die Zeilen nach employee_fio und summiert billsec.

Filter und Sortierung: Filter sind Ringostat-Ausdrücke, durch Kommas getrennt, z. B. call_type=in,billsec>=30, mit =, <>, >, <, >=, <= oder ~ (ein regulärer Ausdruck, base64-kodiert). order sortiert, z. B. calldate desc; merge fasst Anrufe nach anrufender Nummer pro Tag (1) oder über den ganzen Zeitraum (2) zusammen.

Personenbezogene Daten: Telefonnummern und Aufnahme-Links sind personenbezogene Daten. Die Aufnahme-Links in recording und recording_wav bleiben ein Jahr lang abrufbar.

Bei der Installation deaktiviert: ringostat_start_callback startet einen echten Anruf, der eine Projektnummer mit einer Telefonnummer oder dem SIP-Login eines Mitarbeiters verbindet. Es wählt sofort und kostet Gesprächsminuten, deshalb schaltet ein Administrator es bewusst ein. Auch dann zeigt dir die KI beide Nummern und wartet auf dein Ja. Nummern stehen im internationalen Format ohne +.

Lesende POST-Aufrufe: Mitarbeiterliste, SIP-Bericht und eigene Status sind in der Ringostat-API POST-Anfragen, lesen aber nur.

Häufige Fehler: 401 oder 403 bedeuten einen fehlenden oder falschen Auth-key oder Key und Projekt-ID aus verschiedenen Projekten. Ein JSON-RPC-Fehler bei den Tools für Mitarbeiter, Bericht oder Status bedeutet meist eine falsche RINGOSTAT_PROJECT_ID; "User does not exist" heißt, dass der Mitarbeiterfilter niemanden gefunden hat.

Der Connector ändert keine Einstellungen der Telefonanlage, keine Mitarbeiter, Nummernpools oder Weiterleitungsschemata, und er liefert Aufnahme-Links, nicht das Audio selbst.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Microsoft Copilot hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Ringostat-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

Verfügbare Tools

Beispiel-Prompts

• „Wie viele eingehende Anrufe hatten wir gestern, wie viele davon wurden verpasst, und wie lang war die durchschnittliche Gesprächsdauer?“
• „Gruppiere die Anrufe der letzten Woche nach Mitarbeiter mit Anzahl der Anrufe und gesamter Gesprächsdauer.“
• „Welche UTM-Quellen und Kampagnen haben diesen Monat Zielanrufe gebracht?“
• „Wer ist gerade online, und wer davon telefoniert gerade?“
• „Wie lange war jeder Mitarbeiter letzte Woche pro Tag online?“

FAQ

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden