Pular para o conteúdo
Agents
Como conectar o Google Analytics (GA4) ao Claude (MCP)

Como conectar o Google Analytics (GA4) ao Claude (MCP)

O passo a passo para ligar o Google Analytics 4 ao Claude por um servidor MCP, sem Python nem gcloud, o que dá para perguntar e a diferença para o servidor oficial do Google.

Ciro Cesar Maciel5 min de leituraFeito com ajuda de IA

Nesta página · 9 seções
  1. O que dá para perguntar ao Claude
  2. Passo a passo no Claude
  3. No Claude Code e no Cursor
  4. O MCP oficial do Google Analytics e este conector
  5. O que fica guardado
  6. Perguntas frequentes
  7. Para continuar lendo
  8. O seu site numa pergunta
  9. Fontes

Quem procura "google analytics mcp" quer perguntar ao Claude como o site está indo, sem abrir o GA4 e sem montar exploração. O caminho é um servidor MCP: você cola o endereço https://google-analytics.mcp.myagents.click/mcp no Claude, entra com a conta Google que tem acesso às propriedades do GA4 e pergunta. O acesso é só de leitura, e não há Python, gcloud nem projeto no Google Cloud para configurar.

O que dá para perguntar ao Claude

O conector Google Analytics dá ao seu assistente de IA 7 ferramentas, todas de leitura:

FerramentaO que responde
list_propertiesAs contas e propriedades do GA4 a que a sua conta tem acesso
run_reportQualquer combinação de dimensões e métricas, com período, filtro e ordem
compare_periodsO período atual contra o anterior, com a variação de cada métrica
top_pagesAs páginas mais vistas, com usuários, tempo de engajamento e eventos-chave
traffic_sourcesCanais e origem/mídia, com sessões, engajamento e eventos-chave
realtimeQuantas pessoas estão no site nos últimos 30 minutos, e onde
list_metricsOs nomes válidos na propriedade, incluindo os personalizados

Pergunte com as suas palavras:

  • "De onde veio o tráfego nesta semana e o que mudou em relação à anterior?"

  • "Quais páginas mais levam a eventos-chave?"

  • "Quantas pessoas estão no site agora, e de onde?"

  • "Quantas sessões vieram do Instagram neste mês?"

Se você usa métricas ou dimensões personalizadas, o Claude descobre os nomes certos com list_metrics antes de montar o relatório.

Passo a passo no Claude

  1. No Claude (claude.ai ou o app), abra Configurações, depois Conectores, e clique em Adicionar conector personalizado.

  2. Dê um nome, por exemplo "Google Analytics", cole https://google-analytics.mcp.myagents.click/mcp e clique em Conectar.

  3. O navegador abre o login. Primeiro você entra na conta Agents, uma vez só; ela é a dona do seu plano no Connectors.

  4. Depois, escolha a conta Google que tem acesso às suas propriedades do GA4 e autorize a leitura.

  5. Volte à conversa e comece por "quais propriedades você enxerga?", para conferir que a conta certa entrou.

O aviso de app não verificado

No passo 4, o Google mostra o aviso de app não verificado. O Google ainda está verificando o projeto do Agents para o acesso ao Analytics, que é um escopo sensível. Até lá, quem entra vê o aviso e escolhe continuar, e o projeto tem um teto de 100 pessoas. É esperado e não impede a conexão. Se o seu time não aceita app não verificado, espere a verificação ou use o servidor oficial, descrito abaixo.

No Claude Code e no Cursor

No Claude Code, adicione o servidor pelo terminal e depois rode /mcp dentro do Claude Code para entrar:

claude mcp add --transport http google-analytics https://google-analytics.mcp.myagents.click/mcp

No Cursor, acrescente o servidor ao arquivo .cursor/mcp.json, no projeto ou na sua pasta pessoal. O Cursor abre o login na primeira vez:

{
  "mcpServers": {
    "google-analytics": { "url": "https://google-analytics.mcp.myagents.click/mcp" }
  }
}

O MCP oficial do Google Analytics e este conector

Quem busca "google analytics mcp" também encontra o servidor oficial. Segundo a documentação do Google, ele é mantido pelo Google, em Python, e roda no seu computador com pipx ou uv. Pede um projeto no Google Cloud com as APIs Admin e Data do Analytics ligadas e o login pelo gcloud. Também é só de leitura.

O oficial é do Google e tem um relatório de funil pronto, que este conector não tem. Se você já trabalha com gcloud e quer o funil, ele resolve.

O conector Google Analytics do Agents serve a quem não quer instalar nada:

  • Sem Python, gcloud nem projeto no Google Cloud. Você cola o endereço e entra com o Google.

  • Funciona onde você conversa: no Claude, no Claude Code, no Cursor e no Assistant, pelo mesmo endereço.

  • Os dois só leem. Nada muda no seu Analytics, em nenhum dos caminhos.

Os conectores feitos no Agents não são oficiais dos serviços: usam a API pública do Analytics com o seu login.

O que fica guardado

Os dados do Analytics só passam: vão do Google para o seu assistente e não são guardados, vendidos nem usados para treinar modelos. O conector guarda os tokens de acesso do Google, criptografados, enquanto a conexão existir, o identificador da sua conta Agents e contadores de uso para os limites, apagados em até dois dias (os do mês, em até 40 dias).

Perguntas frequentes

Serve para o Universal Analytics?

Não. O conector lê propriedades do GA4.

O Claude consegue mudar alguma configuração do Analytics?

Não. As 7 ferramentas só leem.

Funciona no ChatGPT?

O ChatGPT aceita servidores MCP remotos como conector personalizado, no modo de desenvolvedor, e o conector usa o protocolo que ele pede. Mas o uso no ChatGPT ainda não foi conferido aqui. Onde os conectores já são usados: o Assistant, o Claude e o Claude Code.

Quanto custa?

O Connectors conta chamadas por mês, somando todos os conectores feitos no Agents. Dá para começar sem pagar, com 300 chamadas por mês, só de leitura, e o Google Analytics é inteiro de leitura. Os planos pagos aumentam as chamadas; os valores estão na página de preços do Connectors.

Para continuar lendo

O seu site numa pergunta

O conector Google Analytics está em google-analytics.mcp.myagents.click, com o endereço pronto para copiar e um exemplo de resposta. Ele faz parte do Connectors, o diretório de servidores MCP remotos com login OAuth do Agents, em mcp.myagents.click, onde estão também os conectores de Search Console, Google Ads e Meta Ads. Conhecer o Connectors

Fontes

XLinkedInWhatsAppE-mail

Quem escreveu

Ciro Cesar Maciel

Sou marido, pai e trabalho com tecnologia há mais de duas décadas, construindo sistemas para grandes empresas e liderando times técnicos. Desde 2024 desenvolvo ferramentas digitais e aplico Inteligência Artificial para viver e trabalhar com mais clareza, e escrevo aqui sobre isso.

Todos os textos

Continue lendo

Comentários

Seu e-mail fica com Agents para moderar e responder. O comentário aparece depois de aprovado.