A conexão GA4 do Claude Code ajuda os desenvolvedores a investigar se a instrumentação de eventos corresponde aos dados que chegam ao Analytics. Ele adiciona ferramentas de relatório a uma sessão de codificação sem exigir credenciais Google no repositório. Use-o para verificar um contrato de evento e, em seguida, decida se a próxima tarefa pertence ao código, à configuração Tag Manager ou GA4.
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 com acesso à propriedade GA4 que você deseja analisar.
- Uma conta LoomaScale e uma conexão Google Analytics; conectar Google Ads sozinho não autoriza o Analytics.
- O ID numérico da propriedade ou permissão para descobri-la na lista de contas. Um ID de medição G identifica um fluxo da web e não é o ID da propriedade de relatório.
Como você conecta Claude Code a GA4?
1. Conecte GA4 em LoomaScale
Crie ou faça login em sua conta LoomaScale e abra Conexões. Escolha Google Analytics, 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-ga4 https://api.loomascale.com/mcp/ga4Se você já usa o plugin do 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 do MCP.
3. Autenticar no menu Claude Code do MCP
Abra Claude Code e insira /mcp. Selecione loomascale-ga4 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-ga4 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 ga4_get_account_summaries. Liste minhas propriedades GA4 acessíveis com seus nomes e IDs numéricos de propriedade. Pergunte-me qual propriedade usar. Leia o fuso horário e a moeda do relatório. Não altere nenhuma configuração.
A resposta deve conter propriedades do seu próprio login Google, com um recurso como properties/123456789. Selecione a propriedade por nome e ID e mantenha essa seleção nas solicitações subsequentes. Uma descrição de GA4 ou um painel de amostra não prova que o conector recuperou dados. Uma lista de contas vazia pode ser uma resposta válida de um login sem propriedades acessíveis.
Como você verifica um contrato de evento com Claude Code e GA4?
Comece com um evento que você possa identificar no repositório, como generate_lead. Faça com que Claude Code registre a ortografia e as condições sob as quais o site a emite. Em seguida, compare esse contrato com os nomes dos eventos observados e contagens recentes de GA4. Um evento ausente é uma pista para investigação, e não uma evidência automática de que o código nunca foi executado.
Use LoomaScale com a propriedade GA4 que selecionei. Leia a instrumentação de eventos de formulário principal deste repositório sem editar arquivos. Identifique os nomes dos eventos pretendidos e quando eles são acionados. Reporte eventCount por eventName nos últimos 7 dias completos e verifique os nomes esperados. Se for útil, consulte eventos em tempo real separadamente. Explique o que o relatório verifica e o que precisa de um teste de navegador. Não crie eventos nem altere configurações.
Separe uma incompatibilidade de nome de evento de uma falha de coleta. Um evento recente pode estar ausente de um relatório datado enquanto o processamento ainda estiver em andamento; um resultado em tempo real responde a uma pergunta de janela de tempo diferente. Verifique a propriedade e o fluxo pretendidos antes de editar o código. Caso seja necessário um teste de navegador, execute-o no ambiente de teste apropriado do site e verifique suas reais solicitações emitidas.
Qual endpoint MCP este guia usa?
https://api.loomascale.com/mcp/ga4O endpoint específico do serviço expõe ferramentas GA4 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 GA4?
LoomaScale pode recuperar tráfego, engajamento, eventos importantes, receita, atividade em tempo real e relatórios de funil. Comece com relatórios e especifique datas, dimensões e métricas. As ferramentas de configuração, quando habilitadas para sua conta, precisam da função Google apropriada e da permissão analytics.edit; o acesso ao relatório por si só não permite edição. Conectar um assistente não instala uma tag de site, não cria eventos históricos nem torna a atribuição GA4 idêntica à atribuição de uma plataforma de anúncios.
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.
Se a propriedade estiver faltando, confirme o e-mail Google e o acesso à propriedade e, em seguida, verifique a conexão do Analytics em LoomaScale. Se um relatório estiver vazio, verifique a propriedade, datas, filtros e se o site realmente envia eventos. Compare períodos equivalentes no fuso horário da propriedade. Para uma incompatibilidade de métricas, preserve os nomes exatos das métricas e as definições de atribuição antes de tirar conclusões. Use o ID da propriedade de relatório em vez do identificador do G-stream.
Guias de conexão relacionados e referências oficiais
Use GA4 em outro assistente
- Como conectar ChatGPT a GA4
- Como conectar Claude a GA4
- Como conectar Codex a GA4
- Como conectar Grok Build a GA4
Conecte outra fonte Google ao Claude Code
Referências oficiais de configuração
- Claude Code MCP da Anthropic, escopos e guia de autenticação
- Referência de ID de propriedade GA4 de Google
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.
