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

Como conectar Claude Code a GA4 (Google Analytics 4)

Resposta curta

Para conectar Claude Code a GA4, conecte Google Analytics em LoomaScale e registre o terminal GA4 com claude mcp add usando o transporte HTTP. Abra Claude Code, autentique por meio de /mcp e peça a LoomaScale para listar suas propriedades. Selecione uma propriedade antes de comparar a instrumentação do evento com os dados de eventos relatados.

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

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

O 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

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

Conectar Claude Code a GA4 instala o rastreamento em meu site?

Não. A conexão MCP dá à sessão acesso a ferramentas analíticas autorizadas. Ele não instala uma tag Google nem altera seu repositório. Inspecione a instrumentação existente e verifique primeiro os dados observados; qualquer código ou alteração de rastreamento é uma tarefa separada.

Preciso de um ID de medição GA4 ou de um ID de propriedade?

O relatório usa o ID numérico da propriedade, geralmente retornado como properties/123456789. Um ID de medição G pertence a um fluxo de dados da web. Peça a LoomaScale para listar suas propriedades primeiro e, em seguida, selecione a propriedade correta em vez de adivinhar um ID.

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 GA4 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