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: BigQuery MCP Server

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

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

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

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

Entwicklung

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