Yandex Metrica MCP mit Gemini CLI verbinden

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

Yandex Metrica + Gemini

Lass deine KI deine Webanalyse in Yandex Metrica auswerten: Zähler, Ziele, Filter und Segmente, Tabellen-, Zeitreihen-, Drill-down- und Vergleichsberichte zu Besuchen, Quellen, Seiten und Conversions sowie Rohdaten zu Besuchen und Hits über die Logs API.

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:

YANDEX_METRICA_TOKEN

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 5 Minuten. Du brauchst ein Yandex-Konto, dem die Metrica-Zähler gehören oder das Zugriff auf sie hat, und eine eigene App, registriert auf oauth.yandex.com.

1. Leg auf oauth.yandex.com eine App vom Typ For API access or debugging an und gib ihr den Zugriff metrika:read (Metrica-Statistiken, Zählereinstellungen, Liste der Zähler). Notier dir ihre ClientID.
2. Melde dich mit dem Yandex-Konto an, dem die Zähler gehören oder das sie sehen kann, öffne https://oauth.yandex.com/authorize?response_type=token&client_id=<ClientID> mit deiner ClientID und kopiere das Token (es beginnt mit y0_) in YANDEX_METRICA_TOKEN, ohne OAuth oder Bearer davor.
3. Installiere den Connector und führe yandex_metrica_list_counters aus: Es prüft das Token und listet die Zähler-IDs auf, die die anderen Tools brauchen.

Cloud und Self-Hosting funktionieren gleich: Du fügst das Token ein, und der Connector sendet es bei jedem Aufruf als Authorization: OAuth .... In AnythingMCP ist keine Redirect URL einzutragen.

Das Token gilt etwa ein Jahr: Solange es benutzt wird, verlängert es sich. Lesezugriff reicht für alles hier: metrika:read deckt die Berichte, die Zählereinstellungen und die Anfragen an die Logs API ab.

Zuerst Zähler und Ziele: Die Zähler-ID gehört in Berichten in ids und überall sonst in counterId. yandex_metrica_list_goals liefert die Ziel-IDs, die in Ziel-Metriken stecken, etwa ym:s:goal123reaches und ym:s:goal123conversionRate.

Metriken, Daten und Filter: Metriken und Dimensionen beginnen mit ym:s: für Sitzungen (Besuche) und ym:pv: für Seitenaufrufe, zum Beispiel ym:s:visits, ym:s:bounceRate oder ym:s:lastTrafficSource. Datumsangaben sind YYYY-MM-DD, today, yesterday oder 30daysAgo. Filter nutzen ==, !=, =@ (enthält) und =~ (Regex), verknüpft mit AND und OR; die gespeicherten Segmente aus yandex_metrica_list_segments lassen sich als Filter wiederverwenden. Zeilen blättern mit limit (Standard 100, höchstens 100.000) und offset, das bei 1 beginnt.

Hochgerechnete Zahlen: Berichte enthalten sampled und sample_share. Ist sampled true, sind die Zahlen Schätzungen aus einer Stichprobe: Für kleine Zeiträume lässt sich volle Genauigkeit anfordern (accuracy full), sonst hilft die Logs API.

Logs API: Rohe, nicht hochgerechnete Besuche und Hits werden auf Yandex-Seite vorbereitet. Die KI prüft mit yandex_metrica_evaluate_log_request, ob sich die Anfrage erstellen lässt, legt sie an, wartet, bis ihr Status processed ist, und lädt jeden Teil als tabulatorgetrennten Text herunter; die erste Zeile enthält die Feldnamen. Der Zeitraum darf den heutigen Tag nicht enthalten, und vorbereitete Logs zählen gegen das Log-Speicherkontingent des Zählers.

Limits: 5.000 Anfragen pro Tag und Nutzer, 200 Berichtsanfragen pro 5 Minuten und Nutzer, 3 parallele Anfragen pro Nutzer und 30 Anfragen pro Sekunde und IP-Adresse (10 bei der Logs API). Darüber antwortet Yandex mit 429: Warte und versuch es erneut.

Häufige Fehler: 401 heißt, dass das Token falsch, abgelaufen oder widerrufen ist: Hol dir wie in Schritt 2 mit der ClientID deiner App ein neues. 403 heißt, dass das Token funktioniert, sein Konto aber keinen Zugriff auf diesen Zähler hat oder der App metrika:read fehlt. 400 heißt, dass eine Metrik, Dimension oder ein Filter ungültig ist; die Meldung nennt sie.

Was der Connector liest: Zähler mit Website, Spiegeln, Status, Zeitzone, Code-Status, Inhaber und deiner Berechtigung sowie die Labels (Ordner), in die sie sortiert sind; Ziele mit Typ, Bedingungen, Schritten und Preis; Datenfilter, URL-Operationen, gespeicherte Segmente und wer Zugriff auf einen Zähler hat; Tabellen-, Zeitreihen-, Drill-down- und Vergleichsberichte zu Besuchen, Nutzern, Absprungrate, Traffic-Quellen, Seiten, Ländern, Geräten und Ziel-Conversions; dazu rohe, nicht hochgerechnete Besuche und Hits aus der Logs API.

Bei der Installation deaktiviert: yandex_metrica_clean_log_request. Es löscht die vorbereiteten Dateien einer abgeschlossenen Logs-API-Anfrage, um das Log-Speicherkontingent des Zählers freizugeben; danach lassen sich die Dateien nicht mehr herunterladen. Schalte es auf der Connector-Seite nur ein, wenn du es brauchst; die KI lässt sich jede Änderung vorher von dir bestätigen. yandex_metrica_create_log_request und yandex_metrica_cancel_log_request sind eingeschaltet: Sie starten oder stoppen nur die Vorbereitung eines Rohdaten-Exports auf Yandex-Seite und ändern keinen Zähler, kein Ziel und keine Einstellung.

Nicht enthalten: Zähler, Ziele, Filter und Zugriffe anlegen oder bearbeiten sowie Offline-Conversions, Anrufe, Ausgaben, Nutzerparameter oder CRM-Daten hochladen.

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 Yandex Metrica-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche Traffic-Quellen haben letzten Monat die meisten Besuche gebracht, und wie hoch war jeweils die Absprungrate?“
• „Wie hat sich die Conversion-Rate meines Bestell-Ziels in den letzten drei Monaten von Woche zu Woche entwickelt?“
• „Vergleiche Besuche und Zielerreichungen nach Traffic-Quelle zwischen Oktober und September.“
• „Welche Seiten hatten gestern die meisten Seitenaufrufe, und auf welchen Geräten?“
• „Hol die rohen, nicht hochgerechneten Besuche der letzten Woche über die Logs API und zähl sie nach Region.“

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