Ringostat über MCP mit Gemini 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 + Gemini

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 Gemini 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.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Ringostat-Tools aufrufen.

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

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden