O que é o MCP Server para GTM?
O MCP Server para Google Tag Manager é uma integração que permite gerenciar recursos do GTM usando linguagem natural através de modelos de IA como o Claude. Em vez de navegar pelo interface do GTM ou escrever chamadas de API, você usa comandos simples em texto.
A Stape desenvolveu esse MCP Server para simplificar o gerenciamento e a execução de comandos no GTM em uma única interface — eliminando a necessidade de escrever requisições de API manualmente.
O que você pode gerenciar com o MCP Server
- Contas, workspaces, containers e environments do GTM
- Criar, atualizar e remover clients, tags, triggers, variáveis e templates
- Verificar status de publicação e histórico de versões
- Executar ações administrativas sem acessar o painel do GTM
O MCP Server para GTM é especialmente útil para implementações repetitivas: criar múltiplas tags com configurações similares, fazer auditorias de containers ou replicar setups entre workspaces.
Pré-requisitos
- Node.js versão 18 ou superior instalado
- Claude Desktop (ou outro cliente MCP compatível)
Configuração passo a passo
- Verifique se o Node.js v18+ está instalado e baixe o Claude Desktop se ainda não tiver
- Abra o Claude Desktop > Settings > Developer > Edit Config
- Substitua o conteúdo do arquivo de configuração pelo JSON do MCP Server do GTM
- Salve as mudanças e reinicie o Claude Desktop
- Uma janela do navegador abrirá para autenticação OAuth com sua conta Google
- Conceda as permissões necessárias para o GTM
- Verifique se as ferramentas GTM aparecem disponíveis no Claude
Se o OAuth falhar ou você precisar reautenticar, execute `rm -rf ~/.mcp-auth` no terminal para limpar as credenciais armazenadas localmente e tente novamente.
Resolução de problemas comuns
- MCP Server não aparece na lista: verifique se o arquivo JSON está corretamente formatado e salvo. Reinicie o Claude Desktop.
- Erro de autenticação OAuth: execute `rm -rf ~/.mcp-auth` e reinicie o cliente MCP para forçar nova autenticação.
- Ferramentas GTM não respondem: verifique se a conta Google usada no OAuth tem acesso ao container GTM desejado.
Perguntas frequentes
Preciso de acesso avançado ao GTM para usar o MCP Server?
O acesso necessário depende das ações que você quer realizar. Para apenas ler configurações, acesso de leitura é suficiente. Para criar e editar tags, você precisa de acesso de publicação no container.
O MCP Server funciona com containers server-side e web?
Sim, o MCP Server para GTM funciona com ambos os tipos de container — web (client-side) e server-side. Você pode gerenciar os dois pela mesma interface de IA.
Há risco de alterar configurações por acidente usando comandos de IA?
Sim, é um risco real. Recomenda-se usar o MCP Server em workspaces de desenvolvimento/staging primeiro, e revisar as mudanças antes de publicar em produção. Trate os comandos de IA como você trataria edições manuais.
Este artigo é uma adaptação em português de conteúdo originalmente publicado em inglês pela equipe da Stape. Ver artigo original.
