Como conectar o Claude ao GA4 via MCP?

Resposta rápida: você pode conectar o Claude ao GA4 configurando um servidor MCP do Google Analytics que dá ao Claude acesso direto aos dados da sua propriedade. O processo leva de 20 a 30 minutos e exige uma conta de serviço do Google Cloud, a GA4 Data API ativada e um arquivo de configuração local do MCP. Depois de conectado, o Claude pode executar consultas, destacar tendências e gerar relatórios semanais de insights a partir dos seus dados de analytics em tempo real.

Extrair insights do GA4 geralmente significa fazer login, navegar pelos relatórios, exportar CSVs e depois tentar entender os números. Esse processo é lento e fácil de pular.

Conectar o Claude ao GA4 via MCP (Model Context Protocol) muda isso. Você dá ao Claude acesso direto aos seus dados de analytics e faz perguntas em linguagem natural. Este guia cobre toda a configuração: autenticação, as primeiras consultas e um conjunto de prompts semanais de insights criados para equipes de B2B SaaS.

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

O MCP (Model Context Protocol) é um padrão aberto que permite a modelos de AI como o Claude se conectarem a fontes de dados e ferramentas externas. Em vez de copiar dados para uma janela de chat, o Claude os lê diretamente da fonte.

No caso do GA4, o MCP significa que o Claude pode consultar a sua propriedade de analytics em tempo real. Você pode perguntar "quais canais de aquisição geraram mais cadastros de teste no mês passado?" e receber uma resposta extraída dos seus dados reais, não de um modelo genérico.

Por que isso importa para equipes de B2B SaaS:

Chega de exportar relatórios manualmente
Analistas e não analistas conseguem respostas rápidas
O Claude identifica padrões em várias dimensões ao mesmo tempo
O relatório semanal vira um prompt, não um projeto

O que você precisa antes de começar

Antes de mexer em qualquer arquivo de configuração, confirme que você tem o seguinte:

Uma propriedade do Google Analytics 4 já recebendo dados
Uma conta do Google Cloud (o plano gratuito funciona)
O Claude Desktop instalado na sua máquina
Node.js instalado (versão 18 ou superior)
Familiaridade básica com comandos de terminal e edição de arquivos JSON

Se você usa o Claude via API em vez do Claude Desktop, a configuração do servidor MCP é diferente. Este guia cobre o caminho pelo Claude Desktop.

Etapa 1: crie um projeto no Google Cloud

Acesse console.cloud.google.com
Clique em Select a project no topo e depois em New Project
Dê um nome fácil de reconhecer, por exemplo "Claude GA4 MCP"
Clique em Create e aguarde o projeto ser provisionado

Se você já tem um projeto do Google Cloud conectado à sua propriedade do GA4, pode usá-lo. Criar um projeto separado mantém as permissões organizadas.

Etapa 2: ative a Google Analytics Data API

Dentro do novo projeto, acesse APIs & Services > Library
Pesquise por "Google Analytics Data API"
Clique no resultado e em Enable

Essa é a API que permite o acesso programático aos dados de relatórios do GA4. Sem ela, o servidor MCP não consegue ler a sua propriedade.

Etapa 3: crie uma conta de serviço

Uma conta de serviço é uma identidade Google não humana que o servidor MCP usa para se autenticar no GA4. É a abordagem certa para ferramentas locais, porque você não precisa se autenticar de novo via OAuth a cada sessão.

Acesse APIs & Services > Credentials
Clique em Create Credentials > Service Account
Dê um nome como "claude-ga4-reader"
Clique em Create and Continue
Na etapa de função, pule a adição de uma função (você vai conceder o acesso no nível do GA4)
Clique em Done

Em seguida, gere uma chave para essa conta de serviço:

Clique na sua nova conta de serviço na lista
Acesse a aba Keys
Clique em Add Key > Create New Key
Escolha JSON e clique em Create
Um arquivo JSON será baixado para a sua máquina. Guarde esse arquivo com segurança. Ele é a sua credencial de autenticação.

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ária dentro do GA4.

Abra analytics.google.com
Acesse Admin > Property Access Management
Clique no botão + e selecione Add users
Insira o endereço de e-mail da conta de serviço (ele tem este formato: claude-ga4-reader@your-project.iam.gserviceaccount.com)
Defina a função como Viewer
Clique em Add

O acesso de Viewer é suficiente para consultas somente leitura. Não conceda Editor ou Admin sem um motivo específico.

Etapa 5: anote o ID da sua propriedade do GA4

Você precisa do ID da propriedade do GA4 para dizer ao servidor MCP a qual propriedade se conectar.

No GA4, acesse Admin > Property Settings
Copie o Property ID (um valor numérico, por exemplo 123456789)

Deixe esse valor à mão para a próxima etapa.

Etapa 6: instale o servidor MCP do Google Analytics

Abra o terminal e execute:

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

Se esse pacote não estiver disponível no seu registro npm, a opção mantida pela comunidade e usada pela maioria das equipes é a do insightfulpipe.com. Consulte esse recurso para saber o nome exato do pacote e as atualizações de versão, já que o ecossistema MCP evolui rápido.

Como alternativa, você pode clonar e executar um servidor MCP local diretamente:

git clone https://github.com/[repo-name]/ga4-mcp-server
cd ga4-mcp-server
npm install

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

O Claude Desktop usa um arquivo de configuração para saber quais servidores MCP carregar. Você precisa editar esse arquivo para adicionar o seu servidor do GA4.

Encontre o arquivo de configuração:

macOS: ~/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 não existir, crie-o.

Adicione a configuração do seu servidor MCP do GA4:

{
  "mcpServers": {
    "google-analytics": {
      "command": "node",
      "args": ["/path/to/your/ga4-mcp-server/index.js"],
      "env": {
        "GA4_PROPERTY_ID": "123456789",
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/service-account-key.json"
      }
    }
  }
}

Substitua os marcadores:

/path/to/your/ga4-mcp-server/index.js pelo caminho real do arquivo do servidor
123456789 pelo ID real da sua propriedade do GA4
/path/to/your/service-account-key.json pelo caminho da chave JSON que você baixou na Etapa 3

Salve o arquivo.

Etapa 8: reinicie o Claude Desktop e teste a conexão

Feche o Claude Desktop por completo (não basta fechar a janela)
Abra-o novamente
Procure um indicador de ferramentas ou de MCP na interface (isso confirma que o servidor foi carregado)

Teste a conexão com um prompt simples:

"Using the GA4 MCP tool, show me sessions and users for the last 7 days."

Se o Claude retornar números reais da sua propriedade, a conexão está funcionando. Se aparecer um erro, verifique se:

Os caminhos de arquivo na sua configuração são absolutos, não relativos
O e-mail da conta de serviço foi adicionado ao GA4 com acesso de Viewer
A Google Analytics Data API está ativada no seu projeto do Cloud
O Node.js está acessível a partir do caminho que o Claude usa para executar comandos

Executando suas primeiras consultas do GA4 com o Claude

Depois de conectado, você pode pedir ao Claude para executar consultas do GA4 em linguagem natural. O Claude traduz o seu pedido para o formato da GA4 Data API, busca os dados e retorna uma resposta estruturada.

Consultas básicas para começar:

"Quais foram as 10 principais landing pages por sessões no mês passado?"
"Mostre a taxa de conversão por fonte de tráfego nos últimos 30 dias"
"Quais países enviaram mais usuários no 2º trimestre?"
"Qual é a duração média da sessão por categoria de dispositivo?"

Para B2B SaaS em particular:

"Quantos usuários concluíram o evento de cadastro de teste nos últimos 14 dias, por canal de aquisição?"
"Qual é a taxa de abandono entre a página de preços e a página de cadastro?"
"Mostre as sessões de usuários recorrentes versus novos usuários, semana a semana, nas últimas 8 semanas"

O Claude também pode combinar dimensões e métricas de maneiras que a interface padrão do GA4 dificulta. Peça para ele cruzar a fonte de aquisição com a taxa de engajamento ou comparar dois períodos lado a lado. Se a busca orgânica é um canal de crescimento importante para a sua equipe, também pode ser útil comparar seus fluxos de relatório com a forma como as principais equipes de SaaS trabalham com agências de SEO para B2B SaaS especializadas.

Prompts semanais de insights para equipes de B2B SaaS

Um dos usos de maior valor dessa integração é substituir a sua revisão semanal manual de analytics por uma rotina estruturada de prompts. Execute-os toda segunda-feira de manhã.

Prompt 1: resumo de tráfego e aquisição

"Pull last week's sessions, new users, and returning users. Break sessions down by channel group. Compare to the previous week and flag any channel that changed by more than 15% in either direction."

Prompt 2: verificação do funil de conversão

"Show me the completion rate for [your key conversion event] last week versus the week before. Then show me the top 3 pages users visited before completing that event."

Prompt 3: desempenho de conteúdo

"Which 5 pages had the highest engaged sessions last week? Which 5 had the lowest engagement rate with more than 100 sessions? Summarise what that pattern suggests."

Prompt 4: comparação entre pago e orgânico

"Compare sessions and conversion events from organic search versus paid search over the last 4 weeks. Show week-by-week. Identify the trend direction for each."

Prompt 5: detecção de anomalias

"Look at daily sessions for the last 30 days. Identify any days where sessions were more than 20% above or below the 30-day average. List the dates and the percentage deviation."

Salve esses prompts em um arquivo de texto ou como prompt de um Claude Project. Executar os cinco leva menos de 5 minutos e dá a você um panorama semanal completo sem abrir o GA4 nenhuma vez. Se quiser transformar esses insights em um plano mais amplo de demand gen, também pode ser útil comparar abordagens entre agências de performance marketing para B2B SaaS, agências de PPC para B2B SaaS ou agências de content marketing para B2B SaaS.

Erros comuns de configuração e como corrigi-los

Erro: "MCP server failed to start"
Verifique se o caminho do arquivo no seu claude_desktop_config.json está correto e é absoluto. Caminhos relativos não funcionam.

Erro: "Permission denied on GA4 property"
O e-mail da conta de serviço não foi adicionado ao GA4 ou foi adicionado à propriedade errada. Confira se o endereço de e-mail é exatamente o mesmo.

Erro: "Google Analytics Data API not enabled"
Volte ao Google Cloud Console e confirme que a API está ativada no projeto correto. A conta de serviço e a API precisam estar no mesmo projeto.

Erro: "Invalid property ID"
Confirme que você está usando o Property ID numérico do GA4 Admin, e não o Measurement ID (que começa com G-).

Perguntas frequentes

O que é o servidor MCP do Google Analytics para o Claude?
O servidor MCP do Google Analytics é um processo local que conecta o Claude Desktop à sua propriedade do GA4 por meio da Google Analytics Data API. Ele usa o padrão Model Context Protocol para que o Claude leia seus dados de analytics diretamente e responda a perguntas sobre eles sem nenhuma exportação manual de dados.

Preciso saber programar para conectar o Claude ao GA4?
Você precisa ter um mínimo de familiaridade com comandos de terminal e com a edição de um arquivo JSON. O processo não exige escrever código, mas você precisa executar comandos npm, criar uma conta de serviço no Google Cloud e editar um arquivo de configuração. A maioria dos profissionais de operações de B2B SaaS com alguma bagagem técnica consegue concluir tudo em menos de 30 minutos.

É seguro conectar o Claude aos meus dados do GA4?
Sim, desde que a configuração esteja correta. A conta de serviço usa acesso somente leitura de Visualizador, então o Claude não consegue modificar sua propriedade nem seus dados do GA4. As credenciais ficam na sua máquina local, dentro do arquivo de configuração. Não faça commit da chave JSON da conta de serviço em nenhum repositório público.

Posso usar isso com o Claude via API em vez do Claude Desktop?
A abordagem de servidor MCP descrita aqui foi pensada para o Claude Desktop. Se você usa a API do Claude diretamente, pode passar os dados do GA4 como resultados de chamadas de ferramenta na sua própria aplicação, mas isso exige desenvolvimento personalizado, e não a abordagem com arquivo de configuração acima.

Qual é a diferença entre isso e usar o Windsor.ai para conectar o GA4 ao Claude?
O Windsor.ai é um conector no-code que sincroniza os dados do GA4 com o Claude sem nenhuma configuração local. A abordagem MCP descrita aqui roda localmente, dá a você mais controle sobre quais dados o Claude acessa e não exige um serviço pago de terceiros. Em contrapartida, a configuração do MCP leva mais tempo no início.

Quais dados do GA4 o Claude consegue acessar via MCP?
O Claude consegue acessar qualquer dado disponível pela GA4 Data API, incluindo sessões, usuários, eventos, conversões, métricas de engajamento, fontes de tráfego, dados por página e dimensões ou eventos personalizados configurados na sua propriedade. Por esse método, ele não consegue acessar dados brutos em nível de evento das exportações do BigQuery.