Conecte o Google Tag Manager ao Claude Code
Claude Code
Para conectar o Google Tag Manager ao Claude Code, adicione o PaidSync.ai: rode claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp, digite /mcp e entre com seu login do PaidSync.
O Claude Code acessa seus contêineres do Google Tag Manager por 39 ferramentas: auditorias, workspaces, tags, acionadores, variáveis, prévias, versões e publicação. Ele pergunta antes de cada ferramenta, e a maioria das gravações no GTM vale na primeira chamada, sem simulação.
Um comando. Login OAuth, sem chave. Grátis, 100 tarefas por mês, vale $50, sem cartão.
O comando
O Claude Code fala com servidores MCP remotos por Streamable HTTP. O PaidSync é um deles. Adicione uma vez e o mesmo terminal que edita seu código pode auditar e alterar seus contêineres de rastreamento.
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpPor padrão, isso registra o servidor só para o projeto atual. Adicione --scope user para disponibilizá-lo em todos os projetos da sua máquina.
Execute claude mcp list para confirmar que ele está lá, depois inicie uma sessão e digite /mcp para entrar.
Conecte o Google Tag Manager ao Claude Code em 5 passos
1Cadastre-se em paidsync.ai/signup
Leva 10 segundos. Login com Google ou e-mail. O plano gratuito é de 100 tarefas por mês a $0, sem cartão.
2Conecte o Google Tag Manager no painel do PaidSync
Clique em Conectar no Google Tag Manager. O GTM autoriza via Google OAuth, com a conta do Google que tem acesso aos seus contêineres. Ele usa um cliente OAuth separado do Google Ads, então sua conexão do Google Ads não é afetada.
Já está no Claude Code? Peça para ele executar connect_gtm. A ferramenta devolve um link OAuth para abrir no navegador.
3Escolha o contêiner em que o Claude Code deve trabalhar
Dentro de uma sessão, list_gtm_accounts, list_gtm_containers e list_gtm_workspaces mostram o que o seu login alcança. setup_gtm verifica toda a configuração em uma chamada: conexão, contas, contêineres e tags.
4Adicione o PaidSync ao Claude Code
No seu terminal, rode:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpInicie uma sessão, digite /mcp, escolha paidsync e entre com o seu login do PaidSync na janela do navegador que abrir. O Claude Code guarda o token OAuth para você. Nenhuma chave é colada em lugar nenhum.
Configurando para uma equipe? Faça commit de um .mcp.json na raiz do repositório para que todo engenheiro receba o mesmo conector:
{
"mcpServers": {
"paidsync": { "type": "http", "url": "https://mcp.paidsync.ai/mcp" }
}
}Prefere uma chave de API, por exemplo para execuções sem interface? Envie-a em um cabeçalho, nunca na URL, onde ela iria parar nos logs:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp --header "Authorization: Bearer $PAIDSYNC_API_KEY"Em um .mcp.json commitado, adicione "headers": { "Authorization": "Bearer ${PAIDSYNC_API_KEY}" } para que a chave fique no ambiente de cada engenheiro e nunca entre no git. Aplicar uma alteração no Google Ads ainda exige o login OAuth. Em outras plataformas, uma chave também pode aplicar alterações, então trate-a como uma senha e prefira OAuth.
5Teste a conexão
Em uma sessão do Claude Code, peça: “Audite meu contêiner do GTM e liste tudo o que estiver quebrado”
O Claude Code retorna tags sem acionadores, acionadores não usados, a falta de um conversion linker ou de uma tag de configuração do GA4 e tags pausadas. A conexão está ativa.
O plano gratuito inclui 100 tarefas por mês. Pro a partir de $99 por mês, Team a partir de $249.
Prompts do Google Tag Manager para testar no Claude Code
Cada prompt abaixo corresponde a ferramentas do grupo GTM do PaidSync. O Claude Code escolhe a ferramenta. A última coluna indica se a chamada pode alterar algo no contêiner.
| Pedido | Ferramentas que chama | Altera sua conta? |
|---|---|---|
| “Audite o contêiner e liste as tags sem acionador” | audit_gtm_container | Não |
| “O que está no ar no contêiner agora?” | get_gtm_version_live | Não |
| “Quais alterações estão pendentes neste workspace?” | get_gtm_workspace_status | Não |
| “Crie um workspace chamado claude-code-fixes” | create_gtm_workspace | Sim, depois que você confirma |
| “Adicione uma tag de evento do GA4 para form_submit em um acionador de envio de formulário” | create_gtm_trigger, create_gtm_tag | Sim, depois que você confirma |
| “Envie um link de prévia para eu testar o workspace” | preview_gtm_workspace | Não |
| “Crie uma versão a partir do workspace e publique” | create_gtm_version, publish_gtm_version | Sim, depois que você confirma |
Execute em modo headless com claude -p
A flag -p executa o Claude Code sem a sessão interativa. Entre uma vez por /mcp e o token OAuth guardado continua valendo. Um relatório que cai em um arquivo fica assim:
claude -p "Audit the GTM container and write a list of tags without triggers, unused triggers and paused tags." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/gtm-$(date +%F).jsonAs leituras rodam direto, e as escritas também. --allowedTools "mcp__paidsync" permite todas as ferramentas do PaidSync, escritas incluídas, sem prompt.
Em uma tarefa sem supervisão, permita só as ferramentas de leitura de que ela precisa, cada uma pelo nome como mcp__paidsync__tool_name.
O que lê e o que grava
Das 39 ferramentas do GTM, 18 só leem e 19 podem escrever.
As leituras cobrem contas, contêineres, workspaces, tags, acionadores, variáveis, variáveis integradas, ambientes, versões, a versão no ar e o snippet de instalação.
Ler mais
As escritas cobrem workspaces, tags, acionadores, variáveis, variáveis integradas, versões e publicação. A maioria das escritas no GTM não tem simulação e é aplicada na primeira chamada; só o create_gtm_tag faz prévia com dry_run. Exclusões exigem confirm_destructive, e o publish_gtm_version exige confirm.
Via MCP, a etapa de aprovação é o próprio prompt do Claude Code. Ele pergunta antes de executar uma ferramenta, a menos que você a tenha permitido com --allowedTools ou nas suas configurações. O PaidSync acrescenta verificações do seu lado. Exclusões, pausas e alterações de orçamento exigem confirm_destructive, e uma verificação de regras antes da gravação bloqueia argumentos inseguros. O cartão de aprovação, e o Undo em um cartão aplicado cuja alteração tem inverso seguro, valem apenas no workspace do PaidSync.
Adicionar ao ChatGPT: abra o PaidSync.ai no diretório de plugins do ChatGPT, instale e faça login.
Adicionar ao Claude: abra o PaidSync.ai no diretório de conectores do Claude, clique em Conectar e faça login.
Limites que vale conhecer
- Publicar coloca uma versão no ar no seu site na hora, para usuários reais e rastreamento real. Teste antes com
preview_gtm_workspace. - Uma tag excluída sai do workspace, mas continua no site no ar até você publicar uma nova versão.
- O Default Workspace não pode ser excluído. Um acionador ainda usado por uma tag, ou uma variável ainda referenciada, também não pode ser excluído.
- As ferramentas do GTM não editam o código do seu site. O snippet do contêiner de
get_gtm_container_snippetainda precisa estar nas suas páginas.
Perguntas frequentes
Como conectar o Google Tag Manager ao Claude Code?
Crie sua conta em paidsync.ai, conecte o Google Tag Manager no painel com seu login do Google e depois execute claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp no terminal. Digite /mcp dentro de uma sessão, escolha paidsync e entre com seu login do PaidSync.
O Claude Code pode publicar meu contêiner do GTM?
Sim, com duas verificações. publish_gtm_version exige confirm definido, e o Claude Code pergunta antes de executar a ferramenta. Faça as alterações em um workspace separado e teste com um link de prévia primeiro.
Conectar o GTM afeta minha conexão com o Google Ads?
Não. O GTM usa um cliente OAuth separado do Google Ads, então conectar o GTM deixa sua conexão com o Google Ads como está.
Funciona em modo headless com claude -p?
Sim. Depois de entrar por /mcp, o claude -p reutiliza o token OAuth salvo. Auditorias e leituras rodam direto. Escritas exigem cuidado. Ninguém está lá para responder ao pedido do Claude Code, então qualquer ferramenta de escrita que você liberou com --allowedTools roda direto. Em uma tarefa sem supervisão, libere só as ferramentas de leitura de que ela precisa.
É grátis?
Sim. O plano gratuito custa $0 para 100 tarefas por mês, sem cartão. O Pro começa em $99 por mês e o Team em $249 por mês.
Existe um MCP do Google Tag Manager para o Claude?
Sim. O PaidSync.ai é um servidor MCP hospedado do Google Tag Manager com 39 ferramentas do GTM, 18 que só leem e 19 que podem escrever, para o Claude Code, o app do Claude e outros clientes MCP. No Claude Code, adicione com o comando acima; no app do Claude, adicione o PaidSync.ai pelo diretório de conectores e entre.
O Claude pode editar o Google Tag Manager?
Sim, pelo PaidSync.ai: o Claude cria e atualiza workspaces, tags, acionadores e variáveis e publica versões. A maioria das escritas no GTM é aplicada na primeira chamada, sem simulação; só o create_gtm_tag faz prévia com dry_run, e exclusões exigem confirm_destructive, então mantenha ativo o pedido de aprovação do Claude Code para escritas.
39 ferramentas do GTM. Um comando no Claude Code.