Google Tag Manager MCP

English | Русский

A1 Google Tag Manager MCP permite a una aplicación de IA inspeccionar y gestionar contenedores de Google Tag Manager en lenguaje natural. Ve qué se activa en una página, trabaja con etiquetas, disparadores y variables en un espacio de trabajo de borrador y, cuando estés listo, compila y publica una versión de forma deliberada.

Se conecta a la API de Google Tag Manager v2 mediante tu cuenta de Google. La diferencia frente a pedirle a una IA que adivine una configuración de GTM es que trabaja con el contenedor, el espacio de trabajo y la versión reales que elijas.

• 19 herramientas. 10 operaciones solo leen datos de GTM; 4 crean borradores o modifican variables integradas; 5 pueden alterar, eliminar, compilar o publicar la configuración activa.

• Borrador primero. Las etiquetas, los disparadores y las variables se crean en un espacio de trabajo. Publicar es una operación separada y explícitamente destructiva.

• Consciente de las cuotas. GTM permite 0,25 solicitudes por segundo por proyecto; el servidor espacia las solicitudes al menos 4,2 segundos en lugar de saturar la API.

• Tu acceso a Google. El servidor usa tus credenciales OAuth y solicita únicamente los ámbitos de Tag Manager necesarios para leer, editar, crear versiones y publicar.

Empieza con una pregunta de solo lectura:

¿Qué etiquetas de mis contenedores se activan con el disparador de vista de página?

Conectar el servidor · Explorar casos de uso · Abrir documentación técnica

Compruébalo en un minuto

Tú: Enumera mis contenedores de GTM y muestra qué etiquetas se activan en la vista de página.

Asistente: Enumera los contenedores, sus espacios de trabajo, los disparadores relevantes y las etiquetas asociadas. No cambia nada.

Tú: En el espacio de trabajo predeterminado de GTM-ABC123, prepara una etiqueta de configuración de GA4 para el ID de medición G-XXXXXXX en todas las páginas.

Asistente: Muestra el espacio de trabajo, la configuración propuesta de la etiqueta y el disparador, y luego pide confirmación antes de crear el borrador.

Tú: Confirma el borrador.

Asistente: Crea la etiqueta en el espacio de trabajo. No publica el contenedor; compilar y publicar una versión sigue siendo un paso aparte.

Related MCP server: unboundai-gtm-mcp-server

Contenido

• Inicio rápido

• Qué puedes pedirle que haga

• Cómo se conectan los cambios de GTM

• Qué puede cambiar

• Obtener acceso

• Configuración

• Datos y telemetría

• Límites y trabajo en segundo plano

• Documentación técnica

• Soporte

Inicio rápido

Necesitas Node.js 20+, una cuenta de Google con acceso a un contenedor de GTM y credenciales OAuth de un proyecto de Google Cloud donde la API de Tag Manager esté habilitada.

1. Prepara el acceso OAuth de Google.

2. Añade el servidor a tu aplicación de IA.

3. Empieza con la pregunta de solo lectura anterior.

En la aplicación:

1. Abre Settings → Plugins → MCP servers.

2. Selecciona Add server.

3. Añade npx -y mcp-google-tagmanager@latest y las tres variables de entorno siguientes.

Desde la línea de comandos:

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

Documentación de Codex MCP

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

Documentación de Claude Code MCP

1. Abre Settings → Developer → Edit Config.

2. Añade esta entrada a mcpServers:

{
  "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"
      }
    }
  }
}

Si Edit Config no está disponible, edita ~/Library/Application Support/Claude/claude_desktop_config.json en macOS o %APPDATA%\Claude\claude_desktop_config.json en Windows.

Documentación de Claude Desktop MCP

Añade un servidor a nivel de usuario en ~/.cursor/mcp.json en macOS/Linux o %USERPROFILE%\.cursor\mcp.json en Windows:

{
  "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"
      }
    }
  }
}

Documentación de Cursor MCP

Ejecuta MCP: Open User Configuration desde la paleta de comandos y añade:

{
  "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 }
  ]
}

Compruébalo con MCP: List Servers.

Documentación de VS Code MCP

Qué puedes pedirle que haga

Entender la configuración actual

• Enumerar las cuentas y contenedores de GTM a los que tengo acceso.

• ¿Qué etiquetas se activan en la vista de página en este espacio de trabajo?

• Mostrar la configuración de disparadores y variables de esta etiqueta.

• ¿Qué variables integradas están habilitadas?

Preparar cambios de seguimiento en un borrador

• Crear un espacio de trabajo para el cambio de seguimiento del proceso de pago.

• Preparar una etiqueta de GA4 y un disparador para un evento específico.

• Habilitar las variables de clic necesarias para este disparador.

• Actualizar esta etiqueta después de mostrarme la configuración de reemplazo completa.

Publicar una versión de forma deliberada

• Compilar este espacio de trabajo en una versión llamada April release.

• Mostrar los errores del compilador, si los hay.

• Publicar la versión 42 después de que confirme la versión y sus cambios.

Cómo se conectan los cambios de GTM

GTM tiene una ruta de publicación clara:

1. Una cuenta contiene uno o más contenedores.

2. Un contenedor tiene espacios de trabajo para cambios en borrador.

3. Las etiquetas, los disparadores y las variables pertenecen a un espacio de trabajo.

4. Compilar un espacio de trabajo crea una versión de contenedor y elimina el espacio de trabajo de origen. GTM proporciona un espacio de trabajo de reemplazo.

5. La publicación hace que una versión de contenedor seleccionada esté activa.

Este servidor puede inspeccionar cada paso. No trata un borrador como una publicación: la creación de versiones y la publicación son operaciones separadas.

Qué puede cambiar

El cliente de IA decide cómo pide confirmación. El servidor marca las operaciones de solo lectura, escritura y destructivas para que el cliente pueda distinguir entre una inspección y un cambio real.

Obtener acceso

El servidor usa Google OAuth 2.0. Google Tag Manager no proporciona claves de API para estos datos de usuario.

1. Crea o selecciona un proyecto de Google Cloud y habilita la API de Tag Manager. Un proyecto sin esa API habilitada no recibe cuota.

2. Configura la pantalla de consentimiento de OAuth y crea un cliente OAuth. Un cliente de aplicación de escritorio es adecuado para uso local.

3. Autoriza tu cuenta de Google y obtén un token de actualización. El OAuth 2.0 Playground puede hacerlo si habilitas Use your own OAuth credentials.

4. Solicita estos ámbitos juntos:

   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

Los ámbitos son independientes: leer, editar, compilar versiones y publicar requieren cada uno su permiso correspondiente. Trata el secreto de cliente y el token de actualización como contraseñas.

Configuración

* Proporciona el trío OAuth o un token de acceso. Los tokens de acceso caducan en aproximadamente una hora y no se actualizan automáticamente.

Datos y telemetría

El servidor se ejecuta localmente y envía solicitudes a la API de GTM y solicitudes de actualización de OAuth a Google. Su telemetría anónima contiene un ID de instalación aleatorio, la versión del paquete, el cliente de IA y las versiones de Node.js/sistema operativo, y los nombres de las herramientas. No envía tokens de OAuth, datos de GTM, argumentos de herramientas ni prompts.

Desactiva la telemetría para los servidores MCP de A1 con:

ASKADS_TELEMETRY=0

Límites y trabajo en segundo plano

• GTM tiene límite de tasa. La API permite 0,25 solicitudes por segundo por proyecto, por lo que el servidor espacia las llamadas al menos 4,2 segundos. Las auditorías amplias pueden, por tanto, llevar tiempo.

• Los límites temporales se reintentan con cuidado. Las respuestas 429 y las de cuota de Google 403 usan retroceso exponencial y Retry-After. Las lecturas se reintentan tras fallos de red y 5xx; las escrituras no se repiten tras un fallo incierto.

• No hay supervisión en segundo plano. El servidor solo se ejecuta cuando tu aplicación de IA lo llama. Si la aplicación admite tareas programadas, puede inspeccionar periódicamente un contenedor o su versión activa.

• Un espacio de trabajo desaparece al compilarse. Antes de llamar a create_version, guarda todo lo que necesites del espacio de trabajo e inspecciona la ruta devuelta del espacio de trabajo de reemplazo.

Documentación técnica

Now, let's translate to Spanish (Spain). We need be careful with exact raw markdown. Let's produce.

Potential issue: alt text attribute should remain exactly. We'll preserve all attributes. The text inside attributes not translated.

Let's also preserve the em-dash "—" in "pages — páginas." Actually source uses "—". Spanish also.

Translate "Found a bug or need a scenario?" as "¿Encontraste un error o necesitas un escenario?" Wait "scenario" could be "caso de uso" but "escenario" okay.

"Create an issue" "Write to Telegram": "Crea un issue" maybe "Telegram" product.

Need use "escribe a" or "escríbenos". Let's output.

Final translation:

• Catálogo de capacidades de MCP — páginas orientadas a tareas para cada herramienta.

• Todas las herramientas y entradas

• Documentación de desarrollo

• Documentación de publicación

• Referencia de la API v1 de Google Tag Manager

Soporte

¿Encontraste un error o necesitas un escenario? Crea un issue o escribe en Telegram.

Need maybe "¡Llegaste hasta el final!" More natural: "¡Lo lograste!" The original "You made it to the end!" Meaning enough. Use "¡Lo lograste!" on its own perhaps. Let's in final.

We should include <br> exactly as original line.

Also need preserve the space between </p> and <p? No exactly as original line.

We'll produce in final output* Catálogo de capacidades MCP: páginas orientadas a tareas para cada herramienta.

• Todas las herramientas y entradas

• Documentación de desarrollo

• Documentación de publicación

• Referencia de la API v1 de Google Tag Manager

Soporte

¿Encontraste un error o necesitas un escenario? Crea un issue o escribe en Telegram.