Google Tag Manager MCP

English | Русский

A1 Google Tag Manager MCP ermöglicht einer KI-Anwendung, Google‑Tag‑Manager‑Container in normaler Sprache zu inspizieren und zu verwalten. Sie sehen, welche Tags auf einer Seite ausgelöst werden, arbeiten in einem Entwurfs‑Workspace mit Tags, Triggern und Variablen und bringen erst dann bewusst eine Version heraus, wenn Sie bereit sind.

Es verbindet sich über Ihr Google-Konto mit der Google Tag Manager API v2. Der Unterschied zum Ansatz, eine KI einfach eine GTM-Konfiguration erraten zu lassen, ist offensichtlich: Der Server arbeitet mit dem tatsächlich ausgewählten Container, Workspace und der tatsächlich ausgewählten Version.

• 19 Tools. 10 Operationen erhalten nur GTM‑Daten; 4 erstellen Entwürfe oder ändern integrierte Variablen; 5 können Live‑Konfigurationen ändern, löschen, kompilieren oder veröffentlichen.

• Entwurf zuerst. Tags, Trigger und Variablen werden in einem Workspace angelegt. Das Veröffentlichen ist ein eigener, ausdrücklich destruktiver Schritt.

• Quota-bewusst. GTM erlaubt nur 0,25 Abrufe pro Sekunde und Projekt; der Server wartet daher mindestens 4,2 Sekunden zwischen zwei Ansprachen, anstatt die API zu überlasten.

• Ihr Google-Zugang. Der Server verarbeitet Ihre OAuth‑Daten und verlangt von Ihnen nur die notwendigen Tag‑Manager‑Berechtigungen zum Lesen, Bearbeiten, Versionieren und Veröffentlichen.

Beginnen Sie mit einer reinen Lesefrage:

Welche Tags in meinen Containern werden beim page‑view‑Trigger ausgelöst?

Server verbinden · Anwendungsfälle zeigen · Technische Doku öffnen

Das Ganze in einer Minute ausprobieren

Sie: Listen meiner GTM‑Container und zeigen Sie, welche Tags beim Seitenaufruf feuern.

Assistent: Zeigt die Container, zugehörigen Arbeitsbereiche, Workgroups-Trigger und die daran hängen Tags. Es ändert sich nichts.

Sie: Im Standard‑Workspace von GTM-ABC123 ein GA4‑Konfigurations‑Tag für die Mess‑ID G-XXXXXXX auf allen Seiten vorbereiten.

Assistent: Zeigt Augenfällig den Workspace, das konkrete Tag sowie die Trigger‑Konfiguration und fragt um Bestätigung, ehe der Entwurf erstellt wird.

Sie: Ich bestätige den Entwurf.

Assistent: Legt das Tag in den Workspace an. Es veröffentlicht den Container noch nicht; das Kompilieren und Verabschieden einer Version ist ein eigenlastiger Schritt.

Related MCP server: unboundai-gtm-mcp-server

Inhaltsverzeichnis

• Schnellstart

• Was Sie dieses MCP tun setzen können

• Wie hängen die GTM-Schritte zusammen?

• Was sich im Container ändern kann

• Zugriff erhalten

• Konfiguration

• Daten und Telemetrie

• Grenzen und Hintergrundaufgaben

• Technische Dokumentation

• Support

Schnellstart

Sie benötigen Node.js 20+, ein Google-Konto mit Zugriff auf einen GTM‑Container und OAuth‑Legitimationsdaten aus einem Google‑Cloud‑Projekt, in dem die Tag‑Manager‑API aktiviert ist.

1. Starten Sie den Google‑OAuth‑Zugriff.

2. Fügen Sie den Server enthalten Ihrer KI‑App ein.

3. Schaltung von demleseren frag oben.

In der App:

1. Öffnen Sie die Einstellungen → Plugins → MCP server.

2. Wählen Sie Server hinzufügen.

3. Fügen Sie npx -y mcp-google-tagmanager@latest sowie die drei folgenden Umweltvariablen an.

Befehlszeile:

codex mcp add google-tagmanager \
  --env GOOGLE_TAGMANAGER_CLIENT_ID=your_client_id \
  --env GOOGLE_TAGMANAGER_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_TAGMANAGER_REFRESH_TOKEN=your_refresh_token \
  -- npx -y mcp-google-tagmanager@latest

codex mcp list

Codex MCP-Dokumentation

claude mcp add \
  --env GOOGLE_TAGMANAGER_CLIENT_ID=your_client_id \
  --env GOOGLE_TAGMANAGER_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_TAGMANAGER_REFRESH_TOKEN=your_refresh_token \
  --transport stdio \
  --scope user \
  google-tagmanager \
  -- npx -y mcp-google-tagmanager@latest

claude mcp list

Claude Code MCP-Dokumentation

1. Öffnen Sie Einstellungen → Entwickler → Konfiguration öffnen.

2. Fügen Sie diesen Eintrag zu mcpServers hinzu:

{
  "mcpServers": {
    "google-tagmanager": {
      "command": "npx",
      "args": ["-y", "mcp-google-tagmanager@latest"],
      "env": {
        "GOOGLE_TAGMANAGER_CLIENT_ID": "your_client_id",
        "GOOGLE_TAGMANAGER_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_TAGMANAGER_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Wenn Konfiguration öffnen nicht zur Verfügung steht, ändern Sie unter macOS die Datei ~/Library/Application Support/Claude/claude_desktop_config.json bzw. unter Windows %APPDATA%\Claude\claude_desktop_config.json.

Claude Desktop MCP-Dokumentation

Fügen Sie auf macOS/Linux eine benutzerweite Server-Konfiguration in ~/.cursor/mcp.json ein; unter Windows stattdessen in %USERPROFILE%\.cursor\mcp.json:

{
  "mcpServers": {
    "google-tagmanager": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-tagmanager@latest"],
      "env": {
        "GOOGLE_TAGMANAGER_CLIENT_ID": "your_client_id",
        "GOOGLE_TAGMANAGER_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_TAGMANAGER_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Cursor MCP-Dokumentation

Wählen Sie in der Befehlspalette MCP: Open User Configuration aus und ergänzen Sie:

{
  "servers": {
    "google-tagmanager": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-tagmanager@latest"],
      "env": {
        "GOOGLE_TAGMANAGER_CLIENT_ID": "${input:gtm_client_id}",
        "GOOGLE_TAGMANAGER_CLIENT_SECRET": "${input:gtm_client_secret}",
        "GOOGLE_TAGMANAGER_REFRESH_TOKEN": "${input:gtm_refresh_token}"
      }
    }
  },
  "inputs": [
    { "type": "promptString", "id": "gtm_client_id", "description": "Google OAuth client ID" },
    { "type": "promptString", "id": "gtm_client_secret", "description": "Google OAuth client secret", "password": true },
    { "type": "promptString", "id": "gtm_refresh_token", "description": "Google OAuth refresh token", "password": true }
  ]
}

Vergewissern Sie sich mit MCP: List Servers.

VS Code MCP-Dokumentation

Was Sie dieses MCP ereihen können

Aktuelle Setup verstehen

• GTM-Konten und Container auflisten, die mir zugänglich sind.

• Welche Tags im aktuellen Workspace auf den page-view-Trigger feuern?

• Trigger- und Variablen-Definition dieses Tags zeigen.

• Welche integrierten Variablen sind aktiv?

Tracking-Änderungen als Entwurf vorbereiten

• Einen Workspace für die Änderung des checkout-Trackings erstellen.

• Ein GA4-Tag und den passenden Trigger one für one bestimmtes Ereignis vorbereiten.

• Die Klick-Variablen aktivieren, die für diesen Trigger nötig sind.

• Dieses Tag aktualisieren – Vorschau der vollständigen Ersetzung gezeigt.

Version gezielt freigeben

• Diesen Workspace zu einer Version namen ? April „Release“ kompilieren.

• Compiler-Fehler anzeigen, falls welche vorhanden sind.

• Version „42“ veröffentlichen, nachdem ich release und alle Änderungen bestätigt habe.

Wie sind welche GTM-Änderungen miteinander verbunden?

GTM hat einen klaren Release-Pfad:

1. Ein Konto enthält einen oder mehrere Container.

2. In einem Container gibt es Arbeitsbereiche für Entwürfe.

3. Tags, Trigger und Variablen gehören zu einem Arbeitsbereich.

4. Beim Kompilieren eines Workspace entsteht eine Container-Version, der ursprüngliche Arbeitsbereich wird entfernt. GTM darauf heraus stellt einen Ersatz-Arbeitsbereich bereit.

5. Durch Publishing wird eine gewählte Container-Version live geschaltet.

Der Server kann jeden dieser Schritte prüfen. Er behandelt einen Entwurf nicht bereits als Release: Version anlegen und Version publizieren sind für ihn explizit getrennte Aktionen.

Was sich an der Datenkonfiguration ändern kann

Welche der jeweiligen Auswirkungen eine Bestätigung erfordern, entscheidet der KI-Client. Der Server kennzeichnet Lesezugriff, Schreibzugriff und destruktive Operationen direkt, sodass der Client eindeutig zwischen bloßem Betrachten und tatsächlicher Änderung unterschiedlich.

Zugriff erhalten

Der Server benutzt den Google‑OAuth‑2.0‑Standard. Für diese Nutzerdaten gibt es bei Google Tag Manager keine API‑Schlüssel.

1. Als Erstes ein Google‑Cloud‑Projekt auswählen (oder neu erstellen) und darin die Tag Manager API einschalten. Ein Projekt ohne diese API erhält nutzer quotas.

2. Für dieses Projekt den Zustimmungsbild Fragen ausfüllen und eine OAuth‑Client‑ID erzeugen. Eine Desktop-App‑Client‑ID genügt für den lokalen Einsatz.

3. Google-Konto autorisieren und ein Aktualisierungs‑/Refresh‑Token erlangen. Dafür gut der OAuth Playground auf einfachem Wege funktioniert, wenn man „Use your own OAuth credentials“ aktiviert.

4. Bevor zum ersten Aufruf genau diese Scopes beantragen:

https://www.googleapis.com/auth/tagmanager.readonly
https://www.googleapis.com/auth/tagmanager.edit.containers
https://www.googleapis.com/auth/tagmanager.edit.containerversions
https://www.googleapis.com/auth/tagmanager.publish

Die Scopes sind voneinander getrennt: Lesen, Bearbeiten, Version kompilieren und Publikation verlangen jeweils das Lichtt . Client‑Secret und Refresh‑Token wie Passwörter aufpassen.

Konfiguration

* Entweder das OAuth‑Trio aus Client-ID, Client‑Secret und Planwert‑Token anlegen oder eine Zugriffstoken. Zugriffstokens verfallen nach etwa einer Stunde und werden nicht automatisch erneuert.

Daten und Telemetrie

Der Server läuft lokal ab und sendet Anfragen an Google nur an (1) die GTM‑API und (2) die auf OAuth‑Refresh. Seine anonymisierte Telemetrie besteht aus einer generierten Installations‑ID, der Paketversion, dem KI‑Client, Node.js‑ und Angaben des Betriebssystems sowie den Namen der Tools. Nicht gesandet werden: OAuth‑Tokens, GTM‑Inhalte, Kind Argumente der Tools oder eingegebene Prompts.

Abschalten Telemetrie sperrt man für alle AI‑MCP‑Server mit:

ASKADS_TELEMETRY=0

Limits und Betriebshinter dem Grund

• GTM nutzt ein API‑Quota. Wie in Dokumentaton nachgelesen, sind pro Sekunde gleichmax. 0,25 Abrufe pro Projekt erlaubt. Deshalb setzt der Server zwischen allen Abrufen mindestens 4,2 Sekunden Abstand. Umfangreiches Prüfen kann folglich etwas dauern.

• Rate‑Limits werden vorsichtig behandelt. Bei HTTP 429 und 403 durch das Google-Quota wartet der Server via Exponential‑Backoff bzw. Retry‑After. Lesende Anfragen wiederholen nach Netzwerk- und 5xx‑Fehlern; schreibende Operationen auf nicht gültigen Zustand werden nicht wiederholt.

• Kein Betrieb im Hintergrund. Der Server läuft ausschließlich, wenn ihn die KI‑App ruft. Flexible Apps können geplante Aufgaben nutzen und so Doktors einen Container bzw. seine Live‑Version in positiven zeitlichenfen prüfen.

• Ein Workspace existiert nach dem Kompilieren nicht mehr. Vor Ausrufe create_version alle benötigten Arbeit erledigen und notfalls Inhalte zerlegen. Ausgabe zeigt anschließ den Pfad des Ersatz-Workspace.

Technische Dokumentation

• MCP-Fähigkeitskatalog — aufgabenorientierte Seiten für jedes Tool.

• Alle Tools und Eingaben

• Entwicklungsdokumentation

• Veröffentlichungsdokumentation

• Google Tag Manager API v2 Referenz

Support

Einen Fehler gefunden oder brauchst du ein Szenario? Erstelle ein Issue oder schreib uns auf Telegram.