GTM MCP Server

Un servidor de Model Context Protocol (MCP) para Google Tag Manager que utiliza autenticación de cuenta de servicio - sin necesidad de flujo OAuth.

Características

• Sin OAuth - Utiliza una cuenta de servicio de Google para la autenticación

• Cubre el flujo de trabajo principal de GTM - Cuentas, Contenedores, Espacios de trabajo, Etiquetas, Disparadores, Variables, Variables integradas y Versiones (29 herramientas)

• Local y privado - Se ejecuta completamente en tu máquina

• Funciona con Claude Desktop, Cursor y otros clientes MCP

Inicio rápido

1. Crear una cuenta de servicio de Google Cloud

1. Ve a Google Cloud Console

2. Selecciona o crea un proyecto

3. Habilita la API de Tag Manager:

   • Ve a APIs y servicios → Biblioteca

   • Busca "Tag Manager API"

   • Haz clic en Habilitar

4. Crea una cuenta de servicio:

   • Ve a IAM y administración → Cuentas de servicio

   • Haz clic en "Crear cuenta de servicio"

   • Dale un nombre (por ejemplo, "gtm-mcp-server")

   • Haz clic en Crear y continuar (omite los permisos opcionales)

   • Haz clic en Listo

5. Crea una clave:

   • Haz clic en tu nueva cuenta de servicio

   • Ve a la pestaña Claves

   • Agregar clave → Crear clave nueva → JSON

   • Guarda el archivo JSON descargado en un lugar seguro (por ejemplo, ~/.config/gtm-service-account.json)

2. Otorgar acceso a GTM a la cuenta de servicio

1. Ve a Google Tag Manager

2. Haz clic en Administrador (icono de engranaje)

3. En Cuenta, haz clic en "Gestión de usuarios"

4. Haz clic en el botón + para agregar un usuario

5. Ingresa el correo electrónico de la cuenta de servicio (tiene el formato name@project-id.iam.gserviceaccount.com)

6. Establece los permisos adecuados:

   • Lectura - solo para listar/ver

   • Edición - para crear/modificar etiquetas, disparadores, variables

   • Publicación - para publicar versiones

   • Administración - para acceso completo, incluida la gestión de usuarios

3. Configurar tu cliente MCP

Claude Desktop

Agrega a tu configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en Mac, %APPDATA%\Claude\claude_desktop_config.json en Windows):

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

Cursor

Agrega a tu configuración de MCP en Cursor:

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

4. Reiniciar tu cliente

Después de guardar la configuración, reinicia tu cliente MCP. Deberías ver las herramientas de GTM disponibles.

Herramientas disponibles

Gestión de cuentas

• gtm_list_accounts - Lista todas las cuentas de GTM accesibles

Gestión de contenedores

• gtm_list_containers - Lista los contenedores en una cuenta

• gtm_get_container - Obtiene los detalles de un contenedor

Gestión de espacios de trabajo

• gtm_list_workspaces - Lista los espacios de trabajo en un contenedor

• gtm_create_workspace - Crea un nuevo espacio de trabajo

• gtm_get_workspace_status - Muestra los cambios pendientes y los conflictos de fusión en un espacio de trabajo

• gtm_sync_workspace - Sincroniza un espacio de trabajo con la última versión del contenedor

Gestión de etiquetas

• gtm_list_tags - Lista todas las etiquetas en un espacio de trabajo

• gtm_get_tag - Obtiene los detalles completos de una etiqueta con parámetros

• gtm_create_tag - Crea una nueva etiqueta

• gtm_update_tag - Actualiza una etiqueta existente

• gtm_delete_tag - Elimina una etiqueta

Gestión de disparadores

• gtm_list_triggers - Lista todos los disparadores en un espacio de trabajo

• gtm_get_trigger - Obtiene los detalles completos de un disparador

• gtm_create_trigger - Crea un nuevo disparador

• gtm_update_trigger - Actualiza un disparador existente

• gtm_delete_trigger - Elimina un disparador

Gestión de variables

• gtm_list_variables - Lista todas las variables en un espacio de trabajo

• gtm_get_variable - Obtiene los detalles completos de una variable

• gtm_create_variable - Crea una nueva variable

• gtm_update_variable - Actualiza una variable existente

• gtm_delete_variable - Elimina una variable

Gestión de variables integradas

• gtm_list_built_in_variables - Lista las variables integradas habilitadas

• gtm_enable_built_in_variables - Habilita variables integradas (por ejemplo, URL de página, clases de clic)

• gtm_disable_built_in_variables - Deshabilita variables integradas

Gestión de versiones

• gtm_list_versions - Lista las versiones del contenedor

• gtm_get_live_version - Obtiene la versión actualmente en vivo (publicada)

• gtm_create_version - Crea una versión desde un espacio de trabajo

• gtm_publish_version - Publica una versión para ponerla en vivo

Todas las herramientas de listado devuelven resultados de una página a la vez; cuando hay más resultados, la respuesta incluye un page_token para pasar a la siguiente llamada.

Ejemplos de uso

Una vez configurado, puedes pedirle a Claude cosas como:

• "Lista mis cuentas de GTM"

• "Muéstrame todos los contenedores en la cuenta 123456"

• "¿Qué etiquetas hay en mi contenedor de sitio web?"

• "Crea un nuevo disparador de vista de página llamado 'Todas las páginas'"

• "Crea una etiqueta HTML personalizada que se active en todas las páginas"

• "Crea una versión y publícala"

Solución de problemas

"GOOGLE_APPLICATION_CREDENTIALS no establecida"

Asegúrate de que la variable de entorno esté configurada en tu cliente MCP y apunte a un archivo de clave JSON válido.

Errores de "Permiso denegado"

• Verifica que el correo electrónico de la cuenta de servicio se haya agregado a tu cuenta de GTM

• Comprueba que el nivel de permiso sea suficiente para la operación

Errores de "API no habilitada"

Asegúrate de que la API de Tag Manager esté habilitada en tu proyecto de Google Cloud.

El servidor no aparece en Claude Desktop

• Comprueba que las rutas en tu configuración sean correctas

• Revisa los registros de MCP de Claude Desktop para ver errores

• Intenta ejecutar npx gtm-mcp-server directamente para ver los mensajes de error

Desarrollo

# 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

Licencia

MIT