Skip to main content
Glama
ga-gsc-analytics

ga-gsc-analytics

ga-gsc-analytics

Schreibgeschützter MCP-Server, der Google Analytics 4- und Google Search Console-Daten (analytics.readonly + webmasters.readonly-Bereiche) für Claude Code / Codex bereitstellt.

Neu hier? Folgen Sie ONBOARDING.md für eine Schritt-für-Schritt-Anleitung von null bis funktionsfähig (Claude Code installieren, Anmeldedaten erhalten, autorisieren, verifizieren). Der Rest dieser Datei ist Referenzmaterial.

KI-Agenten: Diese Datei dient auch als AGENTS.md – beginnen Sie hier für die Einrichtung, lesen Sie dann skills/analyze-ga-gsc/SKILL.md für die Verwendung der Tools (Zugriffsprüfungen, Standard-Datumsbereiche, GA4- vs. GSC-Semantik, Präsentationsübergabeformat). Bitten Sie einen Benutzer niemals, Anmeldedaten in den Chat einzufügen.

Werkzeuge

  • analytics_auth_start / analytics_auth_status — lokaler OAuth-Ablauf + Statusprüfung

  • analytics_list_sources — listet GA4-Properties und GSC-Sites auf, die für das autorisierte Konto verfügbar sind

  • ga_run_report — führt einen GA4-Bericht aus

  • gsc_query_search_analytics — fragt Search Console-Daten ab

  • analytics_presentation_snapshot — kombinierter GA4- und GSC-Snapshot für die Berichterstattung

Related MCP server: GSC MCP

Einrichtung (pro Benutzer)

Jeder Benutzer autorisiert mit seinem eigenen Google-Konto und behält sein eigenes lokales Token – teilen Sie niemals client_secret.json-Geheimnisse oder tokens.json zwischen Maschinen.

  1. Google Cloud OAuth-Client: Erstellen Sie (oder verwenden Sie einen vorhandenen) OAuth 2.0-Desktop-Client in der Google Cloud Console und laden Sie dessen client_secret.json herunter. Wenn der Zustimmungsbildschirm den Veröffentlichungsstatus „Testen“ hat, fügen Sie zuerst das Google-Konto jedes neuen Benutzers als Testbenutzer hinzu, andernfalls schlägt die Authentifizierung mit Zugriffsverweigerung fehl.

  2. Platzieren Sie die Anmeldedaten unter ~/.config/ga-gsc-analytics/client_secret.json (oder zeigen Sie mit GA_GSC_CLIENT_SECRET auf einen benutzerdefinierten Pfad).

  3. Datenzugriff gewähren: Das autorisierende Google-Konto benötigt echte Berechtigungen für die Ziel-GA4-Property (Analytics Admin → Property Access Management) und die GSC-Site (Search Console → Einstellungen → Benutzer und Berechtigungen).

  4. Erstellen Sie den Server (nur erforderlich, wenn Sie mcp/server.mjs ändern; das Repository enthält ein vorgebautes mcp/server.bundle.cjs):

pnpm install
pnpm run build   # bundles mcp/server.mjs -> mcp/server.bundle.cjs
  1. Registrieren Sie den MCP-Server. Entweder:

    • Claude Code, benutzerbezogen: claude mcp add ga-gsc-analytics -- node /path/to/ga-gsc-analytics/mcp/server.bundle.cjs

    • Claude Code / Codex, projektspezifisch: Dieses Repository enthält bereits eine relative .mcp.json ({"mcpServers": {"ga_gsc_analytics": {"command": "node", "args": ["./mcp/server.bundle.cjs"]}}}) – kopieren Sie sie in ein Projekt oder verlinken/vendoren Sie diesen gesamten Ordner, und sie wird automatisch erkannt, wenn dieses Projekt geöffnet wird.

  2. Autorisieren: Rufen Sie das Tool analytics_auth_start aus Ihrem KI-Tool auf – es öffnet einen lokalen Browser-OAuth-Ablauf und schreibt ~/.config/ga-gsc-analytics/tokens.json.

  3. Verifizieren: Rufen Sie analytics_auth_status auf (sollte authorized: true melden), dann analytics_list_sources, um zu bestätigen, dass die erwarteten GA4-Properties / GSC-Sites angezeigt werden.

Konfigurationsüberschreibungen

Umgebungsvariable

Standard

GA_GSC_CONFIG_DIR

~/.config/ga-gsc-analytics

GA_GSC_CLIENT_SECRET

$GA_GSC_CONFIG_DIR/client_secret.json

GA_GSC_TOKEN_PATH

$GA_GSC_CONFIG_DIR/tokens.json

Entwicklung

pnpm run check   # syntax check
pnpm test        # node --test tests/*.test.mjs

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Read-only access to Google Analytics 4 reporting data, including traffic overview, top pages, traffic sources, and conversion events, supporting custom report queries via MCP.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables read-only access to Google Search Console data, including property discovery, search analytics queries, and URL inspection, through a security-focused interface.
      3
      2,636 PyPI
      2
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables read-only access to Google Analytics 4, Google Search Console, BigQuery saved queries, GitHub repository data, and Metricool status for SEO/SEM monitoring and analysis.
      -
    • A
      license
      A
      quality
      B
      maintenance
      Enables read-only access to Google Search Console data, including search analytics, sitemap status, URL inspection, and property listing.
      4
      25 npm
      MIT