Conecte o GA4 a Claude Code com um comando
Claude Code
Conecte o GA4 ao Claude Code: rode claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp, digite /mcp e entre com seu login do PaidSync.ai.
O Claude Code acessa suas propriedades do Google Analytics 4 por 26 ferramentas: relatórios, tempo real, eventos-chave, dimensões, públicos e vínculos com o Google Ads. Ele pergunta antes de cada ferramenta, e as gravações no GA4 valem 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
Claude Code conversa com servidores MCP remotos via Streamable HTTP. O PaidSync é um deles. Adicione uma vez e o mesmo terminal que edita seu código poderá consultar e configurar suas propriedades do GA4.
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.
Configuração 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 GA4 no painel do PaidSync
Clique em Conectar no Google Analytics 4. O GA4 autoriza via Google OAuth, com a conta Google que tem acesso às suas propriedades. Ele usa o mesmo login do Google que o Google Ads e pede os escopos de análise, analytics.edit e analytics.readonly.
Já está dentro de Claude Code? Peça para executar connect_ga4. A ferramenta retorna um link OAuth para abrir no navegador.
3Escolha a propriedade em que Claude Code deve trabalhar
Dentro de uma sessão, list_ga4_accounts e list_ga4_properties mostram todas as propriedades que seu login alcança. Indique a propriedade no prompt ou fixe-a no CLAUDE.md do seu projeto para que toda sessão a use.
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 de Claude Code, peça: “Show me sessions and key events by source and medium for the last 28 days”
Claude Code executa um relatório do GA4 na propriedade e retorna a tabela. 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 de GA4 para testar em Claude Code
Cada prompt abaixo corresponde a ferramentas do grupo GA4 do PaidSync. Claude Code escolhe a ferramenta. A última coluna diz se a chamada pode alterar algo na propriedade.
| Pedido | Ferramentas que chama | Altera sua conta? |
|---|---|---|
| “List my GA4 properties and their data streams” | list_ga4_properties, list_ga4_data_streams | Não |
| “Sessions and conversions by source and medium, last 28 days” | run_ga4_report | Não |
| “Is the purchase event firing right now?” | run_ga4_realtime_report | Não |
| “Which key events are set up, and is Google Ads linked?” | list_ga4_conversion_events, list_ga4_google_ads_links | Não |
| “Which enhanced measurement events are on for the web stream?” | get_ga4_enhanced_measurement | Não |
| “Mark generate_lead as a key event” | create_ga4_conversion_event | Sim, depois que você confirma |
| “Add a custom dimension for the plan_tier event parameter” | create_ga4_custom_dimension | Sim, depois que você confirma |
| “Link Google Ads account 123-456-7890 to this property” | create_ga4_google_ads_link | 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 "Run a GA4 report for the last 7 days of sessions and key events by source and medium, and flag any source whose key events dropped against the week before." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/ga4-$(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 26 ferramentas de GA4, 11 só leem e 13 podem gravar.
Ler mais
Leituras e relatórios cobrem propriedades, fluxos de dados, eventos-chave, dimensões e métricas personalizadas, públicos, vínculos com o Google Ads, medição aprimorada, relatórios personalizados por run_ga4_report e os últimos 30 minutos por run_ga4_realtime_report.
As gravações alteram a configuração da propriedade: propriedades, fluxos de dados, eventos-chave, dimensões e métricas personalizadas, públicos, medição aprimorada e vínculos com o Google Ads. Nenhuma das gravações no GA4 tem simulação. Cada uma é aplicada na primeira chamada, então leia os argumentos no aviso de Claude Code antes de permitir. Exclusões exigem confirm_destructive.
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
- Um evento já precisa estar disparando no seu fluxo de dados antes que
create_ga4_conversion_eventpossa marcá-lo como evento-chave. - As ferramentas de GA4 não colocam tags no seu site. As tags ficam no Google Tag Manager, que tem sua própria configuração para Claude Code.
setup_ga4_eventcria uma tag de evento do GA4 em um workspace do GTM, então o GTM também precisa estar conectado. - Remover um evento-chave com
delete_ga4_conversion_eventfaz com que ele deixe de contar como evento-chave. O GA4 continua coletando o próprio evento. - O relatório em tempo real cobre apenas os últimos 30 minutos. Use
run_ga4_reportpara qualquer período anterior.
Perguntas frequentes
Como conectar o GA4 a Claude Code?
Crie sua conta em paidsync.ai, conecte o Google Analytics 4 no painel com seu login do Google, depois execute claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp no seu terminal. Digite /mcp dentro de uma sessão, escolha paidsync e entre com seu login do PaidSync.
Claude Code pode alterar minha configuração do GA4?
Sim. Claude Code pode marcar eventos-chave, adicionar dimensões e métricas personalizadas, criar públicos, alterar a medição aprimorada e vincular o Google Ads. As gravações no GA4 não têm simulação e são aplicadas na primeira chamada, então o aviso de Claude Code é a sua verificação. Exclusões exigem uma confirmação explícita.
Claude Code consegue verificar se o rastreamento funciona?
Sim. run_ga4_realtime_report mostra os últimos 30 minutos, então você pode disparar um evento de teste no seu site e perguntar a Claude Code se ele chegou.
Funciona em modo headless com claude -p?
Sim. Depois de entrar por /mcp, o claude -p reutiliza o token OAuth guardado. As leituras rodam direto. As escritas exigem cuidado. Ninguém está lá para responder ao prompt do Claude Code, então qualquer ferramenta de escrita que você permitiu com --allowedTools roda direto. Em uma tarefa sem supervisão, permita 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.
26 ferramentas de GA4. Um comando em Claude Code.