Como conectar o Claude ao GA4?

Resposta rápida: você pode conectar o Claude ao GA4 configurando um servidor MCP (Model Context Protocol) do Google Analytics. Isso dá ao Claude acesso direto e em tempo real aos dados da sua propriedade do GA4, para que você consulte tráfego, conversões e comportamento dos usuários em linguagem natural. A configuração leva cerca de 20 a 30 minutos e exige uma conta de serviço do Google Cloud.

Equipes de B2B SaaS gastam horas extraindo relatórios do GA4 que respondem às perguntas erradas. Conectar o Claude ao GA4 muda isso. Em vez de exportar CSVs de dashboards, você pergunta ao Claude o que realmente quer saber e recebe uma resposta direta com base em dados em tempo real.

Este tutorial cobre a configuração completa: autenticação no Google Cloud, configuração do servidor MCP, conexão com o Claude e os prompts semanais de insights que tornam tudo isso realmente útil para o trabalho de crescimento em SaaS.

O que é um servidor MCP e por que ele importa para o GA4?

MCP (Model Context Protocol) é um padrão aberto que permite que modelos de AI como o Claude se conectem a fontes de dados externas em tempo real. Em vez de colar dados em uma janela de chat, o Claude consulta a fonte diretamente por meio de uma conexão estruturada com o servidor.

No caso específico do GA4, um servidor MCP funciona como uma ponte entre o Claude e a Google Analytics Data API. O Claude envia uma consulta, o servidor MCP se autentica no Google, recupera os dados e os devolve ao Claude em um formato que ele consegue analisar.

Por que isso importa para B2B SaaS: seus dados do GA4 trazem sinais sobre cadastros em trials, funis de adoção de funcionalidades e desempenho dos canais de aquisição. Consultar esses dados de forma conversacional, sem precisar montar cada relatório antes, muda a velocidade com que você consegue agir. Isso se torna ainda mais valioso quando combinado com marketing operations para B2B SaaS sólidas, porque uma infraestrutura de relatórios melhor torna a experimentação e a tomada de decisão muito mais rápidas.

O que você precisa antes de começar

Antes de mexer em qualquer configuração, certifique-se de ter:

Claude Desktop instalado (disponível em claude.ai/download)
Uma propriedade do GA4 com dados já sendo coletados
Uma conta Google com acesso de administrador a essa propriedade do GA4
Node.js instalado na sua máquina (versão 18 ou superior)
Familiaridade básica com comandos de terminal (você vai executar alguns comandos, nada complexo)

Se você usa o Claude via API em vez do Claude Desktop, as etapas de configuração do MCP são um pouco diferentes. Este tutorial cobre a configuração do Claude Desktop.

Etapa 1: crie um projeto no Google Cloud

O Google Cloud é onde você gera as credenciais que permitem ao Claude se autenticar na Analytics Data API.

Acesse console.cloud.google.com
Clique em Select a project no topo da tela e depois em New Project
Dê ao projeto um nome fácil de reconhecer, por exemplo "Claude GA4 MCP"
Clique em Create e aguarde a inicialização do projeto
Confirme que o novo projeto está selecionado na barra de navegação superior

Esse projeto funciona como um contêiner para as suas credenciais de API. Você não vai implantar nada aqui, apenas criar uma camada de autenticação.

Etapa 2: ative a Google Analytics Data API

Com o projeto criado, você precisa ativar a API específica que o Claude vai usar.

No Google Cloud Console, acesse APIs and Services > Library
Pesquise por "Google Analytics Data API"
Clique no resultado e depois em Enable
Aguarde a ativação da API (geralmente menos de 30 segundos)

Não confunda com a antiga API do Universal Analytics nem com a Google Analytics Reporting API. A Analytics Data API é a versão específica do GA4 e é a que o servidor MCP exige.

Etapa 3: crie uma conta de serviço

Uma conta de serviço é uma conta Google não humana que o seu servidor MCP usa para autenticar as requisições de API. Essa é a abordagem correta para acesso entre servidores.

No Google Cloud Console, acesse APIs and Services > Credentials
Clique em Create Credentials e selecione Service Account
Dê um nome como "claude-ga4-mcp" e clique em Create and Continue
Em função, selecione Viewer (acesso somente leitura é tudo de que o Claude precisa)
Clique em Done

Depois que a conta de serviço for criada:

Clique no nome da conta de serviço na lista de credenciais
Acesse a aba Keys
Clique em Add Key > Create New Key
Selecione JSON e clique em Create
Um arquivo JSON será baixado para a sua máquina. Guarde-o em um lugar de que você vá se lembrar, por exemplo ~/keys/claude-ga4.json

Mantenha este arquivo em segurança. Qualquer pessoa com acesso a ele pode ler os seus dados do GA4.

Etapa 4: dê à conta de serviço acesso à sua propriedade do GA4

A conta de serviço existe no Google Cloud, mas o GA4 ainda não a conhece. Você precisa adicioná-la como usuário dentro da sua propriedade do GA4.

Acesse analytics.google.com
Selecione a sua propriedade do GA4
Clique na engrenagem Admin no canto inferior esquerdo
Na coluna Property, clique em Property Access Management
Clique no botão + e selecione Add Users
Cole o endereço de e-mail da conta de serviço (ele tem este formato claude-ga4-mcp@your-project-id.iam.gserviceaccount.com)
Defina a função como Viewer
Clique em Add

Agora a conta de serviço consegue ler os dados desta propriedade do GA4. Se você gerencia várias propriedades, repita esta etapa para cada uma que quiser que o Claude acesse.

Etapa 5: anote o ID da sua propriedade do GA4

O Claude vai precisar do ID da propriedade do GA4 para saber qual propriedade consultar.

No GA4, acesse Admin > Property Settings
O seu Property ID é uma sequência numérica, por exemplo 123456789
Copie e salve

Ele é diferente do Measurement ID (que começa com "G-"). Confirme que você está copiando o Property ID numérico.

Etapa 6: instale e configure o servidor MCP do GA4

Existem vários servidores MCP de GA4 de código aberto. Uma opção bem mantida é o pacote @thadius856/ga4-mcp-server , mas você também pode usar pacotes da comunidade como insightfulpipe-ga4-mcp. O padrão de configuração é o mesmo entre eles.

Abra o terminal e execute:

npm install -g @modelcontextprotocol/server-google-analytics

Se preferir usar um servidor específico da comunidade, consulte o repositório dele no GitHub para ver o nome exato do pacote e eventuais etapas adicionais de configuração.

Etapa 7: configure o Claude Desktop para usar o servidor MCP

É aqui que você conecta tudo. O Claude Desktop lê as configurações dos servidores MCP em um arquivo de configuração JSON.

Encontre o arquivo de configuração do Claude Desktop:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Abra o arquivo em qualquer editor de texto. Se ele ainda não existir, crie-o.

Adicione a configuração a seguir dentro do objeto mcpServers :

{
  "mcpServers": {
    "google-analytics": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-google-analytics"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/your/claude-ga4.json",
        "GA4_PROPERTY_ID": "123456789"
      }
    }
  }
}

Substitua /absolute/path/to/your/claude-ga4.json pelo caminho real do arquivo de credenciais que você baixou. Substitua 123456789 pelo seu Property ID real do GA4.

Salve o arquivo e reinicie o Claude Desktop por completo (feche o aplicativo e abra de novo, não basta fechar a janela).

Etapa 8: verifique a conexão

Depois de reiniciar o Claude Desktop, procure o indicador de conexão do MCP. Na interface do Claude Desktop, você deve ver um pequeno ícone de ferramentas ou um status de conexão mostrando que o seu servidor do GA4 está ativo.

Para testar, inicie uma nova conversa e digite:

"How many sessions did my website get in the last 7 days?"

Se a conexão estiver funcionando, o Claude vai consultar a sua propriedade do GA4 e devolver uma resposta direta com o número real. Se ele retornar um erro, as causas mais comuns são:

Caminho de arquivo incorreto na configuração (deve ser absoluto, não relativo)
Conta de serviço não adicionada à propriedade do GA4
Property ID incorreto (numérico, não o Measurement ID que começa com G-)
Versão do Node.js abaixo de 18

Prompts semanais de insights para equipes de B2B SaaS

Com a conexão ativa, o valor real vem das perguntas que você faz com consistência. Estes prompts foram pensados para equipes de B2B SaaS que acompanham cadastros em trials, ativação e aquisição.

Aquisição e tráfego

"Mostre as sessões por canal dos últimos 30 dias e destaque os canais em que o tráfego caiu mais de 15% de uma semana para outra."
"Quais landing pages estão gerando mais conversões de cadastro em trial neste mês?"
"Compare o tráfego de busca orgânica deste mês com o do mesmo período do mês passado."

Se a busca orgânica é uma alavanca de crescimento importante para a sua equipe, também pode ser útil comparar o foco das agências de SEO para B2B SaaS especializadas ao transformar insights de analytics em crescimento de pipeline.

Trial e funil de conversão

"Quantos usuários concluíram o evento de cadastro no trial nos últimos 7 dias, e qual foi a taxa de conversão da visualização da landing page até o cadastro?"
"Quais fontes de tráfego têm a maior taxa de conversão de cadastro em trial?"
"Mostre a queda em cada etapa do meu funil de onboarding nos últimos 14 dias."

Comportamento do usuário

"Quais são as 10 páginas com maior taxa de engajamento nesta semana?"
"Quais funcionalidades (rastreadas como eventos) tiveram o maior uso entre novos usuários nos últimos 30 dias?"
"Mostre a duração média da sessão por categoria de dispositivo nos últimos 28 dias."

Prompt de revisão semanal (use toda segunda-feira)

"Give me a weekly summary of last week's performance. Include: total sessions, new users, top acquisition channels, trial signup conversion rate, and any metric that moved more than 20% compared to the previous week. Flag anything that needs attention."

Este único prompt, executado toda segunda de manhã, substitui um processo manual de relatórios que normalmente leva de 45 a 60 minutos. Para equipes que estão montando uma estrutura de relatórios mais ampla em torno de atribuição, rastreamento de conversões e análise de campanhas, agências de marketing ops para B2B SaaS especializadas podem ajudar a conectar a camada de analytics ao restante da stack de receita.

Solução de problemas comuns

O Claude diz que não consegue encontrar o servidor MCP
Verifique se você reiniciou o Claude Desktop por completo depois de editar o arquivo de configuração. Reinicializações parciais não recarregam a configuração do MCP.

Erros de autenticação do Google
Verifique se o caminho para o seu arquivo de credenciais JSON é absoluto (começa com / no Mac/Linux ou C:\ no Windows). Caminhos relativos não funcionam nesta configuração.

Erros de "Property not found"
Confirme que você está usando o Property ID numérico das configurações de administrador do GA4, e não o Measurement ID, que começa com "G-".

Nenhum dado retornado para os períodos de datas
Verifique se a sua conta de serviço foi adicionada à propriedade correta do GA4 e se a propriedade tem dados para o período solicitado.

Perguntas frequentes

O que é o servidor MCP do GA4 para o Claude?
O servidor MCP do GA4 é um servidor local que conecta o Claude à Google Analytics Data API usando o Model Context Protocol. Depois de configurado, o Claude pode consultar a sua propriedade do GA4 diretamente na conversa, buscando dados ao vivo sobre sessões, eventos, conversões e comportamento dos usuários, sem a necessidade de exportações manuais de dados.

É seguro conectar o Claude ao Google Analytics?
Sim, quando a configuração é feita corretamente. A conta de serviço usa acesso somente leitura (Viewer), então o Claude consegue recuperar dados, mas não pode modificar a sua propriedade do GA4 nem o seu projeto do Google Cloud. O arquivo JSON de credenciais deve ser armazenado com segurança e nunca enviado a um repositório público.

Preciso pagar por algo para conectar o Claude ao GA4?
A Google Analytics Data API tem um plano gratuito generoso, que cobre consultas de relatórios padrão. Para a maioria das equipes de B2B SaaS que fazem análises semanais, você não vai chegar ao plano pago. O Claude Desktop exige uma assinatura do Claude (plano Pro ou superior) para usar servidores MCP. O Google não cobra nada adicional pelo uso padrão da API em volumes de consulta típicos.

Posso conectar o Claude a várias propriedades do GA4?
Sim. Adicione cada propriedade como uma entrada separada no seu claude_desktop_config.json arquivo, com o respectivo Property ID. Você precisará conceder à mesma conta de serviço acesso Viewer a cada propriedade adicional do GA4.

Qual é a diferença entre esta abordagem e usar o Zapier para conectar o GA4 ao Claude?
As integrações baseadas em Zapier disparam fluxos de trabalho automatizados entre o GA4 e o Claude, com base em eventos ou agendamentos. A abordagem com MCP dá ao Claude acesso direto e sob demanda aos seus dados brutos do GA4. Para análises ad hoc e geração semanal de insights, o MCP é mais flexível. Para alertas automáticos ou fluxos de trabalho acionados por gatilhos, integrações no estilo Zapier podem ser mais adequadas.

Qual é a diferença entre isso e simplesmente exportar os dados do GA4 e colá-los no Claude?
Exportações manuais são retratos estáticos. A conexão via MCP dá ao Claude acesso a dados ao vivo, com a possibilidade de consultar qualquer período, dimensão ou combinação de métricas sob demanda. Você também elimina por completo a etapa manual, que é onde a maioria das equipes perde consistência nos hábitos de relatório. Equipes que produzem conteúdo de relatórios em escala também podem querer conhecer como agências especializadas em content marketing para B2B SaaS transformam dados de performance em estratégia de conteúdo.