Meta Pixel
Voltar ao blog
Guia de conexão5 minutos de leitura12 de nov. de 2026Por Andrii Pasika· Fundador, LoomaScale

Como conectar Claude Code a GTM (Google Tag Manager)

Resposta curta

Para conectar Claude Code a GTM, autorize Google Tag Manager em LoomaScale e adicione seu terminal GTM com claude mcp add. Autentique-se de /mcp dentro de Claude Code e, em seguida, descubra e selecione um contêiner. Leia a versão publicada e o status do espaço de trabalho antes de preparar uma alteração de rastreamento ou solicitar uma edição de rascunho.

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/gtm

Se 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/gtm

O 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

Conecte outra fonte Google ao Claude Code

Referências oficiais de configuração

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.

Perguntas frequentes

Adicionar o servidor GTM MCP autoriza Claude Code a publicar?

Adicionar e autenticar o servidor estabelece o acesso à ferramenta sob as permissões da sua conta. Não é uma instrução para publicar. Comece com inspeção somente leitura; edições no espaço de trabalho, criação de versões e publicação exigem o acesso apropriado e uma solicitação deliberada para a ação específica.

A conexão do GTM publica automaticamente as alterações de rastreamento?

Não. Ler um contêiner e executar uma auditoria não publica nada. As edições autorizadas são alterações no espaço de trabalho; uma versão deve ser criada e a versão específica aprovada antes da publicação. Teste o comportamento da tag no Tag Manager Preview e Tag Assistant antes de um lançamento ao vivo.

Onde executo claude mcp add e /mcp?

Execute claude mcp add no terminal do sistema. Em seguida, abra Claude Code e digite /mcp dentro de sua interface de conversação para inspecionar o servidor e autenticar. O comando com escopo do usuário neste guia disponibiliza o servidor em todos os seus projetos nesse computador.

Quem escreveu isso

Andrii Pasika, fundador da LoomaScale

Andrii Pasika

Fundador, LoomaScale

Andrii fundou o LoomaScale e escreveu o servidor Google Ads MCP por trás dele. Ele executa suas próprias campanhas por meio dele, e um e-mail para team@loomascale.com chega até ele.

Conecte GTM a Claude Code

Crie sua conta LoomaScale, conecte a fonte Google e use o prompt de verificação acima para recuperar os dados de sua própria conta.

Comece com LoomaScale

Conecte seu assistente à sua plataforma de anúncios

A LoomaScale funciona no assistente que você já usa. Escolha sua combinação: cada guia leva cerca de cinco minutos.

ChatGPT
Google Ads

Conecte ChatGPT ao Google Ads. Analise campanhas, termos de pesquisa e orçamentos e prepare mudanças dentro do limite de gastos definido.

Ler o guia
Claude
Google Ads

Conecte Claude ao Google Ads. Analise campanhas, termos de pesquisa e orçamentos e prepare mudanças dentro do limite de gastos definido.

Ler o guia
Claude Code
Google Ads

Conecte Claude Code ao Google Ads. Analise campanhas, termos de pesquisa e orçamentos e prepare mudanças dentro do limite de gastos definido.

Ler o guia
Codex
Google Ads

Conecte Codex ao Google Ads. Analise campanhas, termos de pesquisa e orçamentos e prepare mudanças dentro do limite de gastos definido.

Ler o guia
ChatGPT
Meta Ads

Conecte ChatGPT ao Meta Ads. Analise campanhas do Facebook e Instagram, conjuntos de anúncios, criativos e posicionamentos.

Ler o guia
Claude
Meta Ads

Conecte Claude ao Meta Ads. Analise campanhas do Facebook e Instagram, conjuntos de anúncios, criativos e posicionamentos.

Ler o guia
Claude Code
Meta Ads

Conecte Claude Code ao Meta Ads. Analise campanhas do Facebook e Instagram, conjuntos de anúncios, criativos e posicionamentos.

Ler o guia
Codex
Meta Ads

Conecte Codex ao Meta Ads. Analise campanhas do Facebook e Instagram, conjuntos de anúncios, criativos e posicionamentos.

Ler o guia
ChatGPT
TikTok Ads

Gerencie campanhas do TikTok pelo ChatGPT: relatórios, retenção dos vídeos, detalhamentos de público e, quando você pedir, pausas, orçamentos e lances. A mesma instalação com um clique.

Ler o guia
Claude
TikTok Ads

Gerencie campanhas do TikTok pelo Claude: auditorias, relatórios de vídeos e de público, além de pausas, orçamentos e lances dentro do limite de gastos que você define.

Ler o guia
Manus
Google Ads

Conecte Manus ao Google Ads. Analise campanhas, termos de pesquisa e orçamentos e prepare mudanças dentro do limite de gastos definido.

Ler o guia
Slack
Google Ads

Pergunte ao Slackbot sobre o Google Ads em uma mensagem direta: auditorias, termos de pesquisa e ritmo de gastos com dados em tempo real. Uma instalação por espaço de trabalho.

Ler o guia
Manus
Meta Ads

Conecte Manus ao Meta Ads. Analise campanhas do Facebook e Instagram, conjuntos de anúncios, criativos e posicionamentos.

Ler o guia
Slack
Meta Ads

Pergunte ao Slackbot sobre Facebook e Instagram em uma mensagem direta: veiculação, ritmo de gastos e despesas por conjunto de anúncios, diretamente do Meta Ads.

Ler o guia