GA4 Analytics MCP

Persönlicher Google Analytics 4 Connector für Claude.ai Custom Connectors. Ein Google-Konto, ein MCP-Server, bereitgestellt auf Vercel.

Claude.ai Custom Connector
  → https://<VERCEL_PROJECT_NAME>.vercel.app/ga4mcp
  → Vercel Streamable HTTP MCP
  → Google Analytics Data API
  → your GA4 properties

Es gibt keinen lokalen stdio-Server, keine npx-Anforderung und keine claude_desktop_config.json.

Zwei Authentifizierungsschichten bleiben getrennt:

1. Claude → MCP: MCP OAuth (CIMD / DCR / optionaler Advanced Settings-Client)

2. MCP → Google: Google OAuth-Refresh-Token gespeichert in GOOGLE_REFRESH_TOKEN

MCP-Tools

Lokale Entwicklung

npm install
copy .env.example .env.local

Füllen Sie .env.local aus, dann:

npm run dev

• App: http://localhost:3000

• MCP: http://localhost:3000/ga4mcp

• Google OAuth: http://localhost:3000/oauth/google

• Health: http://localhost:3000/health

npm test
npm run build

Claude.ai kann localhost nicht erreichen. Stellen Sie auf Vercel bereit, bevor Sie den Custom Connector hinzufügen.

Google Cloud-Einrichtung

Dies dient nur dazu, dass der MCP-Server Ihre GA4-Daten lesen kann. Es ist nicht der OAuth-Client des Claude.ai-Connectors.

1. Erstellen oder wählen Sie ein Google Cloud-Projekt aus.

2. Aktivieren Sie die Google Analytics Data API.

3. Aktivieren Sie die Google Analytics Admin API.

4. Konfigurieren Sie den OAuth-Zustimmungsbildschirm (Extern für persönliches Gmail). Veröffentlichen Sie ihn als Produktion, damit Refresh-Token nicht nach 7 Tagen ablaufen.

5. Erstellen Sie einen Webanwendungs-OAuth-Client.

6. Authorisierte Weiterleitungs-URIs:

   • http://localhost:3000/oauth/google/callback

   • https://<VERCEL_PROJECT_NAME>.vercel.app/oauth/google/callback

7. Von dieser App verwendeter Bereich:

   https://www.googleapis.com/auth/analytics.readonly

8. Kopieren Sie die Client-ID und das Geheimnis in die Umgebungsvariablen.

Besuchen Sie dann /oauth/google, geben Sie MCP_AUTH_TOKEN ein und melden Sie sich mit dem Google-Konto an, das Ihre GA4-Properties besitzt.

• Lokal wird das Refresh-Token in .env.local geschrieben.

• Fügen Sie auf Vercel GOOGLE_REFRESH_TOKEN in die Projekt-Umgebungsvariablen ein und stellen Sie erneut bereit.

Umgebungsvariablen

Vercel

npm i -g vercel
vercel
vercel --prod

Fügen Sie die Umgebungsvariablen im Vercel-Projekt hinzu. Setzen Sie nach dem ersten Google OAuth in der Produktion GOOGLE_REFRESH_TOKEN und stellen Sie erneut bereit.

Deaktivieren Sie Deployment Protection / Vercel Authentication in der Produktion. Claude.ai verbindet sich aus dem Netzwerk von Anthropic (160.79.104.0/21). Wenn Vercel SSO vor /ga4mcp sitzt, kann der Connector keine Verbindung herstellen.

Produktions-URLs:

https://<VERCEL_PROJECT_NAME>.vercel.app/ga4mcp
https://<VERCEL_PROJECT_NAME>.vercel.app/oauth/google/callback
https://<VERCEL_PROJECT_NAME>.vercel.app/health

Eine benutzerdefinierte Domain ist später optional. Verwenden Sie weiterhin APP_BASE_URL, damit keine Codeänderung erforderlich ist.

Claude.ai Custom Connector

1. Stellen Sie auf Vercel bereit und bestätigen Sie, dass https://<VERCEL_PROJECT_NAME>.vercel.app/health {"status":"ok"} zurückgibt.

2. Verbinden Sie Google unter https://<VERCEL_PROJECT_NAME>.vercel.app/oauth/google.

3. Setzen Sie GOOGLE_REFRESH_TOKEN in die Vercel-Umgebungsvariablen und stellen Sie erneut bereit.

4. Öffnen Sie in Claude.ai Customize → Connectors → Add custom connector.

5. Name: GA4 Analytics

6. URL:

   https://<VERCEL_PROJECT_NAME>.vercel.app/ga4mcp

7. Lassen Sie Advanced OAuth Client ID / Secret leer. Claude verwendet CIMD gegen die Autorisierungsendpunkte dieses Servers.

8. Klicken Sie auf Add.

9. Aktivieren Sie den Connector im Chat-Menü + → Connectors.

10. Der erste GA4-Toolaufruf zeigt eine Connect-Karte. Geben Sie MCP_AUTH_TOKEN auf der Zustimmungsseite dieser App ein (nicht Ihr Google-Passwort).

11. Fragen Sie: Wie viele Nutzer hatte ich gestern?

initialize und tools/list sind öffentlich, damit Claude Tools entdecken kann. tools/call gibt HTTP 401 mit WWW-Authenticate zurück, bis MCP OAuth abgeschlossen ist.

Sicherheit

• Protokollieren Sie niemals Google-Tokens, Autorisierungscodes, Client-Geheimnisse oder MCP-JWTs.

• MCP-Tools geben niemals Geheimnisse zurück.

• Google-Zugriffstokens werden nicht gespeichert; nur GOOGLE_REFRESH_TOKEN bleibt in Umgebungsvariablen erhalten.

• Fügen Sie keine Geheimnisse in Git ein.

Daten

Unverändert an GA4 übergeben: today, yesterday, 7daysAgo, 30daysAgo, 90daysAgo oder YYYY-MM-DD. Die Dimension date wird als YYYYMMDD zurückgegeben.

Bekannte Einschränkungen

• Ein Google-Konto und ein Refresh-Token.

• Vercel kann zur Laufzeit keine Umgebungsvariablen schreiben; fügen Sie GOOGLE_REFRESH_TOKEN ein und stellen Sie erneut bereit.

• Google-Refresh-Tokens im Testmodus laufen nach etwa 7 Tagen ab.

• Echtzeitdaten umfassen etwa die letzten 30 Minuten.

• Die Berichtsgröße ist auf 10.000 Zeilen begrenzt.

• Ich kann den Live-Claude.ai-Klickvorgang aus diesem Repository nicht abschließen; das erfordert Ihre Claude- und Vercel-Konten.