Claude Code pode usar uma conexão GTM MCP para construir uma proposta de mudança de rastreamento baseada em evidências. O fluxo de trabalho útil começa com o contêiner atual e um espaço de trabalho nomeado, em vez de uma solicitação não qualificada para corrigir o rastreamento. Este guia cobre conexão, verificação e uma proposta revisável antes de qualquer publicação.
O que você precisa antes de se conectar?
Use Claude Code instalado no computador onde você executará esses comandos. Seu CLI suporta servidores remotos HTTP MCP e navegador OAuth. Esta rota registra um servidor explícito com escopo de usuário para uso em seus projetos; a configuração da equipe no escopo do projeto é uma escolha separada. Você não precisa executar um servidor Google API local.
- Um login Google que pode ler o contêiner Tag Manager pretendido.
- Uma conta LoomaScale com Google Tag Manager conectada separadamente do Analytics ou Google Ads.
- O contêiner que você deseja inspecionar, além de um espaço de trabalho nomeado, caso você solicite posteriormente uma alteração de rascunho. A edição, criação de versões e publicação requerem as permissões Google correspondentes.
Como você conecta Claude Code a GTM?
1. Conecte GTM em LoomaScale
Crie ou faça login em sua conta LoomaScale e abra Conexões. Escolha Google Tag Manager, faça login com o e-mail Google que tem acesso aos dados necessários e revise as permissões solicitadas. Fazer login em LoomaScale com Google não substitui a conexão desta fonte de dados. Você pode ativar este serviço sem conectar uma conta de publicidade.
2. Registre o servidor MCP remoto em Claude Code
Execute este comando no terminal do sistema, fora de uma conversa Claude Code. O escopo do usuário disponibiliza a conexão em seus projetos. A URL seleciona as ferramentas deste serviço Google.
claude mcp add --transport http --scope user loomascale-gtm https://api.loomascale.com/mcp/gtmSe você já usa o plugin de agente LoomaScale completo, verifique suas ferramentas antes de adicionar uma segunda conexão. A rota do plugin está documentada no guia de configuração Claude Code; este artigo usa configuração direta de MCP.
3. Autenticar no menu Claude Code do MCP
Abra Claude Code e insira /mcp. Selecione loomascale-gtm e conclua seu fluxo de autenticação no navegador. Use a conta LoomaScale com sua fonte Google conectada. Retorne para Claude Code e confirme se o servidor está conectado. Você pode inspecionar o servidor salvo no terminal do sistema com claude mcp get loomascale-gtm ou claude mcp list. Um comando add bem-sucedido salva a configuração; isso não prova que a pesquisa da conta Google foi bem-sucedida.
4. Verifique o acesso com uma pesquisa de conta real
Use LoomaScale para chamar gtm_list_containers. Mostre o nome de cada contêiner, ID GTM público e conta. Pergunte-me qual deles inspecionar. Leia sua versão publicada e liste seus espaços de trabalho. Não edite, crie uma versão ou publique nada.
Verifique se a resposta identifica seu contêiner real, incluindo seu ID público GTM. Distinga a versão publicada de cada espaço de trabalho de rascunho antes de discutir um problema de rastreamento. A conta API e os IDs do contêiner do contêiner são identificadores diferentes de seu GTM-ID público; deixe as ferramentas descobrirem os valores necessários. Um inventário bem-sucedido confirma o acesso à configuração, e não que um evento do navegador seja acionado corretamente.
Como você prepara uma proposta de alteração GTM em Claude Code?
Identifique um problema de rastreamento e inspecione suas dependências. Se o código do repositório emitir o evento relevante, leia também esse contrato. Peça a menor tag proposta, gatilho ou alteração de variável e um plano de teste. Antes de solicitar uma gravação, escolha o espaço de trabalho e revise as alterações existentes para que a versão final tenha um escopo claro.
Use LoomaScale para o contêiner GTM selecionado. Leia a configuração de rastreamento publicada e liste os espaços de trabalho disponíveis. Para o evento principal que descrevo, compare a instrumentação do repositório relevante com tags e gatilhos GTM. Produza uma proposta contendo a configuração atual, os campos propostos exatos, as dependências afetadas e um plano de teste Tag Assistant. Peça-me para escolher um espaço de trabalho antes de qualquer edição futura. Por enquanto, não mude nada e não publique.
Uma proposta deve ser concreta o suficiente para ser revisada sem conceder instruções amplas para consertar tudo. Onde ferramentas de gravação estão disponíveis, a edição do rascunho permanece separada da criação e publicação da versão. Verifique o comportamento na Visualização e inspecione a versão específica antes da aprovação. A inspeção do contêiner por si só não pode certificar que o site lida com todos os estados de consentimento ou navegação.
Qual endpoint MCP este guia usa?
https://api.loomascale.com/mcp/gtmO endpoint específico do serviço expõe ferramentas GTM e auxiliares de conta LoomaScale. O plug-in ou conector de diretório completo usa https://api.loomascale.com/mcp e pode alcançar todas as fontes que você conectar separadamente. Escolha a conexão completa para trabalhar entre serviços; use o endpoint específico quando desejar o conjunto de ferramentas desta fonte. Uma escolha de endpoint limita as ferramentas expostas, não as funções Google que seu login possui.
O que Claude Code pode ler ou alterar em GTM?
LoomaScale lê contêineres, tags, gatilhos, variáveis, espaços de trabalho, versões e descobertas de auditoria de rastreamento. Quando ativadas e autorizadas, as alterações vão para o espaço de trabalho selecionado; criar uma versão e publicá-la são operações separadas. Revise a versão exata antes de aprovar a publicação. A inspeção de configuração não pode observar o navegador de um visitante ou provar que o consentimento e as tags se comportam corretamente no site. Valide as alterações propostas no Tag Manager Preview e Tag Assistant antes de um lançamento ao vivo.
Por que a conexão ou os dados estão faltando?
Se o servidor precisar de autenticação, abra /mcp e faça login novamente. Se faltarem ferramentas, verifique claude mcp list, o terminal de origem e se uma política da organização restringe o servidor. Reinicie a sessão após uma alteração na configuração, se necessário. Um conector da web Claude e um servidor CLI explícito podem se sobrepor; verifique as ferramentas ativas antes de adicionar conexões duplicadas.
Um contêiner ausente geralmente exige a verificação do login Google, do acesso ao contêiner e da conexão Tag Manager. Se a descoberta indicar que as contas ainda estão sendo carregadas, tente novamente após o término da descoberta. Se uma auditoria descrever tags diferentes do site ativo, verifique se você solicitou a versão publicada ou um rascunho do espaço de trabalho. Um erro de permissão de gravação é separado do acesso de leitura: verifique a permissão de edição, versão ou publicação relevante e a disponibilidade do recurso antes de reconectar.
Guias de conexão relacionados e referências oficiais
Use GTM em outro assistente
- Como conectar ChatGPT a GTM
- Como conectar Claude a GTM
- Como conectar Codex a GTM
- Como conectar Grok Build a GTM
Conecte outra fonte Google ao Claude Code
Referências oficiais de configuração
- Claude Code MCP da Anthropic, escopos e guia de autenticação
- Guia de visualização e depuração do Google Tag Manager
Referências de configuração verificadas em 12 de novembro de 2026. Os rótulos de menu e as políticas do espaço de trabalho podem mudar; use as orientações do fornecedor vinculado para sua conta. Para fluxos de trabalho suportados pelo LoomaScale, consulte o hub de documentação.
