Google Tag Manager

Google Tag Manager MCP Server

Um servidor Model Context Protocol (MCP) que integra o Google Tag Manager com o Claude, permitindo configuração automatizada do GTM e criação de componentes por meio de prompts em linguagem natural.

Recursos

• Integração com a API do GTM: Integração completa com a API do Google Tag Manager para criar e gerenciar tags, gatilhos e variáveis
• Modelos de Componentes: Modelos pré-construídos para cenários comuns de rastreamento (GA4, Facebook Pixel, rastreamento de conversões)
• Automação de Fluxos de Trabalho: Criação completa de fluxos de trabalho para diferentes tipos de site (ecommerce, geração de leads, sites de conteúdo)
• Integração com Claude: Interface em linguagem natural para configuração do GTM por meio do Claude

Configuração

1. Instalar Dependências

Opção A: Usando uv (Recomendado)

# Install uv if not already installed
curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env

# Install dependencies
uv sync

Opção B: Usando pip

pip install -r requirements.txt

2. Configuração no Google Cloud Console

1. Acesse o Google Cloud Console
2. Crie um novo projeto ou selecione um existente
3. Ative a API do Tag Manager:
   • Vá em "APIs e Serviços" > "Biblioteca"
   • Pesquise por "Tag Manager API"
   • Clique em "Ativar"

3. Criar Credenciais de Conta de Serviço

1. Vá em "APIs e Serviços" > "Credenciais"
2. Clique em "Criar Credenciais" > "IDs de Cliente OAuth 2.0"
3. Escolha "Aplicativo para desktop"
4. Baixe o arquivo JSON e salve-o como credentials.json neste diretório

4. Configurar o Claude

Adicione a configuração do servidor MCP ao seu arquivo de configuração do Claude:

{
  "mcpServers": {
    "gtm": {
      "command": "python",
      "args": ["/path/to/mcp-for-gtm/server.py"],
      "env": {
        "GTM_CREDENTIALS_FILE": "/path/to/mcp-for-gtm/credentials.json",
        "GTM_TOKEN_FILE": "/path/to/mcp-for-gtm/token.json"
      }
    }
  }
}

Ferramentas Disponíveis

Operações Básicas do GTM

• create_gtm_tag: Criar tags individuais do GTM
• create_gtm_trigger: Criar gatilhos do GTM
• create_gtm_variable: Criar variáveis do GTM
• list_gtm_containers: Listar todos os contêineres de uma conta
• get_gtm_container: Obter detalhes do contêiner
• publish_gtm_version: Publicar uma versão do contêiner

Ferramentas de Fluxo de Trabalho

• create_ga4_setup: Configuração completa do Google Analytics 4 com tag de configuração e eventos comuns
• create_facebook_pixel_setup: Configuração de rastreamento do Facebook Pixel
• create_form_tracking: Configuração de rastreamento de envio de formulários
• generate_gtm_workflow: Gerar fluxos de trabalho completos para diferentes tipos de site

Exemplos de Uso

1. Configurar rastreamento do Google Analytics 4

Create a complete GA4 setup for my website with measurement ID G-XXXXXXXXXX in GTM account 123456 and container 7890123

2. Gerar fluxo de trabalho de rastreamento para ecommerce

Generate a complete ecommerce tracking workflow with GA4 measurement ID G-XXXXXXXXXX and Facebook Pixel ID 123456789

3. Criar rastreamento de formulários

Set up form tracking for the contact form with selector #contact-form in my GTM container

4. Criar componentes personalizados

Create a custom GTM tag for tracking video plays with the following parameters: event_name = "video_play", video_title = "{{Video Title}}", video_duration = "{{Video Duration}}"

Tipos de Fluxo de Trabalho

A ferramenta generate_gtm_workflow suporta três tipos principais de fluxo de trabalho:

• ecommerce: Rastreamento aprimorado de ecommerce com eventos de compra, carrinho e interação com produto
• lead_generation: Envios de formulários, cliques em CTA e rastreamento de conversões
• content_site: Engajamento com conteúdo, inscrições em newsletters e compartilhamento social

Autenticação

Na primeira execução, o servidor abrirá uma janela do navegador para autenticação OAuth. Conceda as permissões necessárias para acessar sua conta do GTM. O token de autenticação será salvo para uso futuro.

Estrutura de Arquivos

mcp-for-gtm/
├── server.py              # Main MCP server
├── gtm_client.py          # GTM API client
├── gtm_components.py      # Component templates and workflow builder
├── requirements.txt       # Python dependencies
├── config.json           # MCP server configuration
├── credentials.json      # Google OAuth credentials (you provide)
├── token.json           # Generated auth token (auto-created)
└── README.md           # This file

Solução de Problemas

Problemas de Autenticação

• Certifique-se de que credentials.json está configurado corretamente no Google Cloud Console
• Verifique se a API do Tag Manager está ativada no seu projeto do Google Cloud
• Confirme que você tem as permissões necessárias na sua conta do GTM

Erros de Permissão

• Garanta que sua conta do Google tenha permissões de edição para o contêiner do GTM
• Verifique se os IDs da conta e do contêiner do GTM estão corretos

Erros de API

• Verifique os IDs da conta e do contêiner do GTM
• Confirme que o espaço de trabalho existe (o ID do espaço de trabalho padrão é usado)
• Verifique os limites de taxa se você estiver fazendo muitas solicitações

Desenvolvimento

Executando Testes

# Using uv
uv run python test_server.py

# Or directly with python
python test_server.py

Executando o Servidor

# Using the convenience script
./run_server.sh

# Or manually with uv
uv run python server.py

# Or with system python
python server.py

Dependências de Desenvolvimento

O projeto inclui dependências de desenvolvimento para qualidade de código:

# Format code with black
uv run black .

# Check with flake8
uv run flake8 .

# Type checking with mypy
uv run mypy .

# Run tests with pytest
uv run pytest

Contribuindo

Sinta-se à vontade para enviar problemas e solicitações de melhorias!