MCP von Google Tag Manager

MCP-Connector, der speziell für Tag Manager entwickelt wurde und nach dem gleichen Prinzip aufgebaut ist wie "Gustavo google ads- mcp": Jede Aktion fragt explizit nach Konto / Container / Workspace (oder Version) – nichts implizit – und Aktionen, die die Produktion beeinflussen (Tag pausieren, Version veröffentlichen), erfordern confirm=true. Dies ersetzt den früheren Ansatz "Chrome öffnen und den Bildschirm lesen", der der fragilste Tab des Panels war, weil er von der Weboberfläche abhing statt von einer typisierten API.

Kosten: Die Tag Manager API ist kostenlos (keine Google-Gebühren bei normaler Nutzung). Sie wird als zweiter kostenloser Web Service auf Render bereitgestellt, genau wie "Gustavo google ads- mcp" – gleicher Plan, gleiche Kosten (null), die du heute schon hast.

Wie die Anmeldedaten organisiert sind (standardisiertes Muster)

Dieser Server verwendet in der Produktion KEINE token.json-Datei – er verwendet Umgebungsvariablen, genau wie deine anderen Connectors auf Render:

• GOOGLE_ADS_CLIENT_ID / GOOGLE_ADS_CLIENT_SECRET – werden wiederverwendet, es ist derselbe OAuth-Client, den "Gustavo google ads- mcp" bereits verwendet. Es ist nicht nötig, pro Tool einen neuen Client zu erstellen.

• GTM_REFRESH_TOKEN – der einzige neue Wert, spezifisch für Tag Manager.

Falls du eines Tages einen separaten OAuth-Client nur für Tag Manager bevorzugst, kannst du GTM_CLIENT_ID / GTM_CLIENT_SECRET definieren, die Vorrang vor den Google Ads haben.

Related MCP server: Samarth GTM MCP Server

1. Code auf GitHub hochladen

1. Repo bereits erstellt: github.com/gustavomkt/mcp-tagmanager (öffentlich).

2. Lade alle Dateien aus diesem Ordner hoch, außer client_secret.json, token.json und .flow_state.json (diese sind nur für lokale Tests; sie dürfen niemals hochgeladen werden – die .gitignore schließt sie bereits aus).

2. Auf Render bereitstellen

1. Render → New → Web Service → verbinde das Repo mcp-tagmanager.

2. Runtime: Docker (erkennt das Dockerfile automatisch).

3. Plan: Free.

4. Environment Variables (füge sie selbst im Render-Dashboard hinzu – es sind Anmeldedaten, daher werde ich sie dir nicht ausfüllen):

   • GOOGLE_ADS_CLIENT_ID = derselbe Wert, den du bereits im Google Ads-Dienst hast.

   • GOOGLE_ADS_CLIENT_SECRET = derselbe Wert, den du bereits im Google Ads-Dienst hast.

   • GTM_REFRESH_TOKEN = das Refresh-Token, das wir bereits für Tag Manager generiert haben (ich habe es dir separat im Chat mitgeteilt).

5. Create Web Service. Wenn der Build abgeschlossen ist, kopiere die öffentliche URL (etwa https://mcp-tagmanager.onrender.com).

3. In Claude verbinden

Füge es als neuen Remote-MCP-Connector hinzu, der auf die Render-URL aus dem vorherigen Schritt zeigt (mit /mcp am Ende, z. B. https://mcp-tagmanager.onrender.com/mcp – das ist der Standard-Endpunkt für streamable-http). Sobald es verbunden ist, lass es mich wissen und ich aktualisiere den Tag Manager-Tab des Kontrollpanels, damit er diese echten Tools verwendet statt der browserbasierten Anweisungen.

Alternative: Lokal mit einer Datei ausführen (ohne Render)

Falls du es jemals auf deinem Laptop statt auf Render ausführen möchtest:

pip install -r requirements.txt
python auth_setup.py   # una vez, abre tu navegador
python server.py       # sin PORT definido, corre por stdio

server.py sucht zuerst nach GTM_REFRESH_TOKEN + client_id/secret in Umgebungsvariablen; wenn es sie nicht findet, fällt es auf token.json zurück.

Verfügbare Tools

Lesen (ändern nichts):

• list_accounts()

• list_containers(account_id)

• list_workspaces(account_id, container_id)

• list_tags(account_id, container_id, workspace_id)

• get_tag(account_id, container_id, workspace_id, tag_id)

• list_triggers(account_id, container_id, workspace_id)

• list_variables(account_id, container_id, workspace_id)

• audit_workspace(account_id, container_id, workspace_id) – Tags ohne Trigger, Trigger ohne Tags, mögliche Duplikate und ob Consent Mode konfiguriert ist. Es ist die zuverlässige Version dessen, was wir früher Claude in Chrome baten, "vom Bildschirm zu lesen und zu raten".

• list_versions(account_id, container_id)

Schreiben (erfordern confirm=true):

• pause_tag(...) / resume_tag(...) – pausiert oder setzt einen Tag im Workspace fort. Veröffentlicht den Container nicht.

• create_version(...) – erstellt eine Version aus dem Workspace. Veröffentlicht nicht.

• publish_version(account_id, container_id, version_id, confirm=true) – veröffentlicht eine Version (geht in Produktion). Verwende es auch für Rollback: Übergib die version_id einer früheren Version aus list_versions.

Stabilitätshinweise

• Jeder Aufruf der Google-API ist in eine Fehlerbehandlung eingebettet, die eine klare Meldung zurückgibt ({"ok": false, "error": "..."}), anstatt die MCP-Verbindung ohne Erklärung abzubrechen – diese Art von stillem Fehler war ein Grund, warum die anderen Connectors "ohne Vorwarnung ausfielen".

• Das Token wird bei jedem Aufruf automatisch mit dem Refresh-Token erneuert; falls es eines Tages widerrufen wird (Passwortänderung, manueller Widerruf unter myaccount.google.com), wird dir der Fehler explizit angezeigt und es genügt, ein neues GTM_REFRESH_TOKEN zu generieren.

• Da es sich um einen kostenlosen Web Service von Render handelt, "schläft" er nach einer Weile ohne Nutzung ein und der erste Aufruf danach dauert ~50 Sekunden – genau wie "Gustavo google ads- mcp" heute. Das ist die wahrscheinlichste Ursache dafür, dass Connectors scheinbar "ausfallen": Es ist kein Fehler, sondern der Cold Start des kostenlosen Plans. Falls du diese Verzögerung irgendwann beseitigen möchtest, ist der einzige Weg ein kostenpflichtiger Plan auf Render – deine Entscheidung, nicht etwas, das ich ohne deine Aufforderung ändere.