GTM MCP Server

Ein Model Context Protocol (MCP)-Server für Google Tag Manager mit Service-Account-Authentifizierung – kein OAuth-Tanz erforderlich.

Funktionen

• Kein OAuth erforderlich – Verwendet Google Service Account zur Authentifizierung

• Deckt den gesamten GTM-Workflow ab – Konten, Container, Arbeitsbereiche, Tags, Trigger, Variablen, integrierte Variablen und Versionen (29 Tools)

• Lokal & privat – Läuft vollständig auf Ihrem Rechner

• Funktioniert mit Claude Desktop, Cursor und anderen MCP-Clients

Schnellstart

1. Google Cloud Service Account erstellen

1. Gehen Sie zu Google Cloud Console

2. Wählen Sie ein Projekt aus oder erstellen Sie eines

3. Aktivieren Sie die Tag Manager API:

   • Gehen Sie zu APIs & Dienste → Bibliothek

   • Suchen Sie nach „Tag Manager API"

   • Klicken Sie auf Aktivieren

4. Erstellen Sie einen Service-Account:

   • Gehen Sie zu IAM & Verwaltung → Service-Accounts

   • Klicken Sie auf „Service-Account erstellen"

   • Geben Sie ihm einen Namen (z. B. „gtm-mcp-server")

   • Klicken Sie auf Erstellen und Weiter (überspringen Sie optionale Berechtigungen)

   • Klicken Sie auf Fertig

5. Erstellen Sie einen Schlüssel:

   • Klicken Sie auf Ihren neuen Service-Account

   • Gehen Sie zum Tab Schlüssel

   • Schlüssel hinzufügen → Neuen Schlüssel erstellen → JSON

   • Speichern Sie die heruntergeladene JSON-Datei an einem sicheren Ort (z. B. ~/.config/gtm-service-account.json)

2. GTM-Zugriff für den Service-Account gewähren

1. Gehen Sie zu Google Tag Manager

2. Klicken Sie auf Admin (Zahnrad-Symbol)

3. Unter Konto klicken Sie auf „Benutzerverwaltung"

4. Klicken Sie auf die +-Schaltfläche, um einen Benutzer hinzuzufügen

5. Geben Sie die E-Mail-Adresse des Service-Accounts ein (sieht aus wie name@project-id.iam.gserviceaccount.com)

6. Legen Sie geeignete Berechtigungen fest:

   • Lesen – nur zum Auflisten/Anzeigen

   • Bearbeiten – zum Erstellen/Ändern von Tags, Triggern, Variablen

   • Veröffentlichen – zum Veröffentlichen von Versionen

   • Admin – für vollständigen Zugriff einschließlich Benutzerverwaltung

3. MCP-Client konfigurieren

Claude Desktop

Fügen Sie zu Ihrer Claude-Desktop-Konfiguration hinzu (~/Library/Application Support/Claude/claude_desktop_config.json auf Mac, %APPDATA%\Claude\claude_desktop_config.json auf Windows):

{
  "mcpServers": {
    "gtm": {
      "command": "npx",
      "args": ["-y", "gtm-mcp-server"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/service-account.json"
      }
    }
  }
}

Cursor

Fügen Sie zu Ihren Cursor-MCP-Einstellungen hinzu:

{
  "mcpServers": {
    "gtm": {
      "command": "npx",
      "args": ["-y", "gtm-mcp-server"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/service-account.json"
      }
    }
  }
}

4. Client neu starten

Nach dem Speichern der Konfiguration starten Sie Ihren MCP-Client neu. Sie sollten die GTM-Tools verfügbar sehen.

Verfügbare Tools

Kontoverwaltung

• gtm_list_accounts – Alle zugänglichen GTM-Konten auflisten

Container-Verwaltung

• gtm_list_containers – Container in einem Konto auflisten

• gtm_get_container – Containerdetails abrufen

Arbeitsbereich-Verwaltung

• gtm_list_workspaces – Arbeitsbereiche in einem Container auflisten

• gtm_create_workspace – Neuen Arbeitsbereich erstellen

• gtm_get_workspace_status – Ausstehende Änderungen und Merge-Konflikte in einem Arbeitsbereich anzeigen

• gtm_sync_workspace – Arbeitsbereich mit der neuesten Containerversion synchronisieren

Tag-Verwaltung

• gtm_list_tags – Alle Tags in einem Arbeitsbereich auflisten

• gtm_get_tag – Vollständige Tag-Details mit Parametern abrufen

• gtm_create_tag – Neues Tag erstellen

• gtm_update_tag – Vorhandenes Tag aktualisieren

• gtm_delete_tag – Tag löschen

Trigger-Verwaltung

• gtm_list_triggers – Alle Trigger in einem Arbeitsbereich auflisten

• gtm_get_trigger – Vollständige Trigger-Details abrufen

• gtm_create_trigger – Neuen Trigger erstellen

• gtm_update_trigger – Vorhandenen Trigger aktualisieren

• gtm_delete_trigger – Trigger löschen

Variablen-Verwaltung

• gtm_list_variables – Alle Variablen in einem Arbeitsbereich auflisten

• gtm_get_variable – Vollständige Variablen-Details abrufen

• gtm_create_variable – Neue Variable erstellen

• gtm_update_variable – Vorhandene Variable aktualisieren

• gtm_delete_variable – Variable löschen

Verwaltung integrierter Variablen

• gtm_list_built_in_variables – Aktivierte integrierte Variablen auflisten

• gtm_enable_built_in_variables – Integrierte Variablen aktivieren (z. B. Seiten-URL, Klick-Klassen)

• gtm_disable_built_in_variables – Integrierte Variablen deaktivieren

Versionsverwaltung

• gtm_list_versions – Containerversionen auflisten

• gtm_get_live_version – Die aktuell live (veröffentlichte) Version abrufen

• gtm_create_version – Version aus einem Arbeitsbereich erstellen

• gtm_publish_version – Version veröffentlichen, um sie live zu schalten

Alle Listen-Tools geben Ergebnisse seitenweise zurück; wenn weitere Ergebnisse vorhanden sind, enthält die Antwort einen page_token, der an den nächsten Aufruf übergeben wird.

Verwendungsbeispiele

Nach der Konfiguration können Sie Claude Dinge fragen wie:

• „Liste meine GTM-Konten auf"

• „Zeig mir alle Container in Konto 123456"

• „Welche Tags sind in meinem Website-Container?"

• „Erstelle einen neuen Pageview-Trigger namens 'Alle Seiten'"

• „Erstelle ein benutzerdefiniertes HTML-Tag, das auf allen Seiten ausgelöst wird"

• „Erstelle eine Version und veröffentliche sie"

Fehlerbehebung

„GOOGLE_APPLICATION_CREDENTIALS nicht gesetzt"

Stellen Sie sicher, dass die Umgebungsvariable in Ihrer MCP-Client-Konfiguration gesetzt ist und auf eine gültige JSON-Schlüsseldatei zeigt.

„Permission denied"-Fehler

• Überprüfen Sie, ob die E-Mail-Adresse des Service-Accounts zu Ihrem GTM-Konto hinzugefügt wurde

• Prüfen Sie, ob die Berechtigungsstufe für den Vorgang ausreichend ist

„API nicht aktiviert"-Fehler

Stellen Sie sicher, dass die Tag Manager API in Ihrem Google Cloud-Projekt aktiviert ist.

Server erscheint nicht in Claude Desktop

• Überprüfen Sie, ob die Pfade in Ihrer Konfiguration korrekt sind

• Schauen Sie in den MCP-Protokollen von Claude Desktop nach Fehlern

• Versuchen Sie, npx gtm-mcp-server direkt auszuführen, um Fehlermeldungen zu sehen

Entwicklung

# Clone the repository
git clone https://github.com/alexstansfield/gtm-mcp-server.git
cd gtm-mcp-server

# Install dependencies
npm install

# Build
npm run build

# Watch mode for development
npm run dev

# Test with MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.js

Lizenz

MIT