Yandex Metrica MCP

Yandex Metrica MCP verbindet eine KI-Anwendung mit der Web-Analyse Ihrer Website. Fragen Sie in natürlicher Sprache, woher die Besucher kommen, wie sich die Conversion ändert oder wo die Absprungrate steigt – der Assistent holt die Daten aus Ihrem Zähler und erklärt das Ergebnis. Die Verbindung beginnt direkt im Dialog: Sie müssen weder vorab einen Token erstellen noch die Konfiguration bearbeiten.

• Acht Werkzeuge. Zähler, Ziele und Berichte von Metrica, Verbinden und Trennen des Zugriffs sowie eine universelle API-Abfrage.

• Berichte und Conversions. Besuche, Nutzer, Aufrufe, Absprünge, Besuchsdauer, Quellen, Geräte und Ziele für den gewählten Zeitraum.

• Verbindung im Chat. Yandex öffnet die Anmeldeseite; der Einmalcode ist 10 Minuten gültig, und der Server prüft den Zugriff auf die Zähler direkt nach der Verbindung.

• Normale Abfragen – nur lesen. Die spezialisierten Werkzeuge verändern keine Zähler, Ziele oder Metrica-Daten.

• Kein stilles Abschneiden. Im Bericht sind die Gesamtwerte und das Stichprobenkennzeichen sichtbar; bei großer Ausgabe markiert der Server, wenn er an ein Limit gestoßen ist.

Versuchen Sie es mit der ersten Nachricht:

Wie viele Besuche, Nutzer und Absprünge gab es in der letzten Woche auf meiner Website?

Server verbinden · Szenarien ansehen · Technische Dokumentation öffnen

In einer Minute in Aktion sehen

Sie: Verbinde Yandex Metrica.

Assistent: Gibt einen Link zur Anmeldung bei Yandex. Öffnen Sie ihn mit dem Konto, das Zugriff auf die gewünschten Zähler hat, bestätigen Sie den Zugriff und senden Sie den angezeigten Code.

Sie: Sendet den Code von der Yandex-Seite.

Assistent: Verbindet Metrica, prüft, ob die Zähler sichtbar sind, und meldet das Ergebnis. Ein Neustart der Anwendung ist nicht nötig.

Sie: Zeige für die letzten 30 Tage die Traffic-Quellen und die Conversion für das Ziel „Bestellung aufgeben“.

Assistent: Findet das Ziel, erstellt einen Bericht nach Quellen und zeigt Besuche, Zielerreichungen und Conversion. Wenn Metrica eine Stichprobe angewendet hat, weist er darauf hin, dass die Zahlen ungefähr sind.

Related MCP server: ya-metrics-mcp

Inhalt

• Schnellstart

• Was kann man übergeben

• So funktioniert es

• Was kann Daten verändern

• Verbindung und Einrichtung

• Daten und Telemetrie

• Einschränkungen

• Technische Dokumentation

• Support

Schnellstart

Sie benötigen Node.js 20 oder neuer. Der Server wird über npx gestartet, eine separate Installation des Pakets ist daher nicht erforderlich.

1. Fügen Sie den Server in die KI-Anwendung ein – unten ist ein Beispiel für Codex geöffnet, die übrigen Anwendungen sind in aufklappbaren Anleitungen zusammengefasst.

2. Schreiben Sie: „Verbinde Yandex Metrica“. Der Assistent führt Sie durch die Anmeldung bei Yandex und prüft sofort, ob ihm Ihre Zähler angezeigt werden.

3. Stellen Sie Ihre erste Frage, zum Beispiel: „Welche Quellen haben im letzten Monat die meisten Besuche gebracht?“

Über die Anwendungsoberfläche:

1. Öffnen Sie Settings → Plugins → MCP servers.

2. Klicken Sie auf Add server.

3. Fügen Sie den Startbefehl npx -y mcp-yandex-metrica@latest hinzu.

Über die Befehlszeile:

codex mcp add yandex-metrica -- npx -y mcp-yandex-metrica@latest

Verbindung prüfen:

codex mcp list

Bitten Sie dann im Codex-Chat: „Verbinde Yandex Metrica“.

Offizielle Codex-Anleitung

claude mcp add --transport stdio --scope user yandex-metrica -- npx -y mcp-yandex-metrica@latest

Server mit folgendem Befehl prüfen:

claude mcp list

Beginnen Sie dann den Dialog mit der Bitte, Metrica zu verbinden.

Claude-Code-Dokumentation

Öffnen Sie Settings → Developer → Edit Config und fügen Sie den Server in claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "yandex-metrica": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-metrica@latest"]
    }
  }
}

Öffnen Sie nach dem Speichern einen neuen Dialog und bitten Sie darum, Metrica zu verbinden.

Erstellen Sie für alle Projekte ~/.cursor/mcp.json; nur für das aktuelle Projekt – .cursor/mcp.json:

{
  "mcpServers": {
    "yandex-metrica": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-metrica@latest"]
    }
  }
}

Im Cursor-Chat erscheint der Server unter den verfügbaren Werkzeugen. Bitten Sie darum, Metrica zu verbinden, und führen Sie die Anmeldung über Yandex durch.

Cursor-Dokumentation

Öffnen Sie die Befehlspalette und führen Sie MCP: Open User Configuration aus. Fügen Sie in mcp.json hinzu:

{
  "servers": {
    "yandex-metrica": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-yandex-metrica@latest"]
    }
  }
}

Prüfen Sie den Start mit dem Befehl MCP: List Servers, öffnen Sie dann den Chat und bitten Sie darum, Metrica zu verbinden.

VS-Code-Dokumentation

Was kann man übergeben

Verstehen, was mit der Website passiert

• „Wie viele Besuche, Nutzer und Aufrufe gab es in der letzten Woche?“

• „Zeige die Besucher-Entwicklung pro Tag für Juni.“

• „Auf welchen Geräten ist die Absprungrate höher?“

Traffic-Quelle finden und ihre Qualität bewerten

• „Zeige die Traffic-Quellen für den Monat und sortiere nach Besuchen.“

• „Vergleiche organische Suche und Werbung nach Nutzern und Absprüngen.“

• „Welche Quellen haben diese Woche die meisten Übergänge gebracht?“

Conversions verstehen

• „Welche Ziele sind im Zähler eingerichtet?“

• „Wie hoch ist die Conversion für das Ziel ‚Bestellung aufgeben‘ in den letzten 30 Tagen?“

• „Zeige die Quellen, die die meisten Zielerreichungen gebracht haben.“

Zugriff und Datengenauigkeit prüfen

• „Welche Zähler sind für mich verfügbar?“

• „Zeige den Verbindungsstatus zu Metrica.“

• „Sind die Daten in diesem Bericht genau oder hat Metrica eine Stichprobe verwendet?“

So funktioniert es

Der Server arbeitet mit drei vertrauten Entitäten:

Normalerweise findet der Assistent zuerst einen verfügbaren Zähler, dann – falls nötig – ein Ziel und erstellt erst danach einen Bericht. In der Metrica-Antwort gibt es eine Summe über alle Zeilen, die Ausgabegröße und das Stichprobenkennzeichen.

Was kann Daten verändern

Der Server kennzeichnet beliebige Schreibvorgänge als potenziell destruktive Aktion. Wie genau die KI-Anwendung eine Bestätigung anfordert, hängt von der Anwendung selbst ab; prüfen Sie vor einer solchen Anfrage Pfad, Methode und Daten.

Verbindung und Einrichtung

Für die normale Nutzung ist kein Token im Voraus nötig:

1. Bitten Sie im Chat darum, Yandex Metrica zu verbinden.

2. Öffnen Sie den Link zu Yandex OAuth mit dem Konto, das Zugriff auf die gewünschten Zähler hat.

3. Bestätigen Sie den Zugriff und senden Sie den Code an den Assistenten. Er ist 10 Minuten gültig und wird nur innerhalb des laufenden Servers in einen Token umgewandelt.

Der Server verwendet PKCE: Der Code aus dem Chat kann allein nicht gegen einen Token eingetauscht werden. Der erhaltene Token wird lokal in ~/.config/mcp-yandex-metrica/credentials.json mit Rechten nur für den Eigentümer gespeichert. Bei einem gespeicherten Refresh-Token wird der Zugriff automatisch verlängert.

Für CI und ungewöhnliche Installationen ist die Einrichtung über Umgebungsvariablen verfügbar:

Wenn Sie eine eigene OAuth-Anwendung verwenden, fordern Sie darin die Berechtigung „Statistiken abrufen, Parameter der eigenen und vertrauenswürdigen Zähler lesen“ (metrika:read) an.

Daten und Telemetrie

Standardmäßig sendet der Server anonyme technische Telemetrie: eine zufällige Installationskennung, den Namen des Ereignisses oder Werkzeugs, die Serverversion, die Node.js-Version, das Betriebssystem und Angaben zum verbundenen KI-Client. Darin enthalten sind weder Token, Zählerdaten, Werkzeugargumente, Ihre Nachrichten noch Werte von Umgebungsvariablen.

Um die Telemetrie für Ask-Ads-MCP-Server zu deaktivieren, setzen Sie die Umgebungsvariable:

ASKADS_TELEMETRY=0

Einschränkungen

• Metrica-Stichprobe. Bei großen Zeiträumen oder komplexen Berichten kann die API Näherungswerte zurückgeben. Achten Sie auf die Felder sampled und sample_share; für eine genauere Berechnung verkleinern Sie den Zeitraum oder verwenden Sie accuracy: "full".

• Berichtsgröße. Eine Anfrage liefert bis zu 10 000 Zeilen. Die automatische Paginierung stoppt bei höchstens 100 Seiten, 100 000 Zeilen oder etwa 1 MB Daten und kennzeichnet eine unvollständige Antwort mit dem Feld _truncated.

• Wiederholungen von Anfragen. Das Timeout einer Anfrage beträgt 60 Sekunden. Der Server macht bis zu drei Wiederholungen bei vorübergehenden Fehlern: GET – bei Netzwerkfehlern, 429 und 5xx; POST und DELETE – nur bei 429, um eine verändernde Aktion nicht zu wiederholen. Die Verzögerung berücksichtigt Retry-After und überschreitet 30 Sekunden nicht.

• Echte Daten. Metrica hat keine Sandbox. Die spezialisierten Werkzeuge lesen Daten, aber POST und DELETE über eine beliebige Anfrage verändern reale Objekte.

• Keine Hintergrundbeobachtung. Der Server arbeitet, wenn die KI-Anwendung ihn aufruft, und überwacht selbst keine Kennzahlen. Wenn die Anwendung geplante Aufgaben unterstützt, kann darin eine periodische Berichtsanfrage eingerichtet werden.

Technische Dokumentation

• Katalog der MCP-Fähigkeiten – Seiten zu Benutzeraufgaben für jedes Werkzeug.

• Alle Werkzeuge – Parameter, Antworten und Grenzen jedes Werkzeugs.

• Entwicklungsdokumentation – Projektaufbau und Arbeit mit der Demo.

• Paket in npm.

• API von Yandex Metrica.

Support

Fehler gefunden oder fehlt ein Szenario? Erstellen Sie ein Issue oder schreiben Sie uns auf Telegram.