zaDojoGoogle Analytics MCP: dados do GA4 grátis na IA
Conecte o Google Analytics 4 ao Claude, ChatGPT, Cursor ou Codex sem projeto no Google Cloud. Treze ferramentas somente leitura, sem gastar créditos.
Por Denis Veisllari
O servidor MCP do zaDojo permite que o seu agente de IA leia a sua propriedade do Google Analytics 4: visitantes, sessões, visualizações de página, taxa de rejeição, eventos principais e receita, divididos por canal, página, país, cidade, dispositivo ou navegador, além de quem está no site agora. Você conecta o GA4 dentro do zaDojo com um login normal do Google, então não há projeto no Google Cloud, API para ativar nem arquivo de credenciais. Ler o Google Analytics não gasta créditos, e os mesmos dados aparecem como painel no app do zaDojo.
Conecte em três passos
- Crie uma conta no zaDojo e um projeto para o seu site. O cadastro não pede cartão.
- No projeto, abra My Site > Analytics e conecte o Google Analytics. Faça login com uma conta do Google que tenha acesso à propriedade do GA4, aprove o acesso somente leitura e escolha a propriedade.
- Adicione a URL do servidor abaixo ao seu cliente de IA e aprove o login do zaDojo na primeira conexão.
https://app.zadojo.com/mcpClaude Code
claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcpCodex CLI
codex mcp add zadojo --url https://app.zadojo.com/mcpCursor: adicione isto ao mcp.json em Settings > Tools & Integrations > MCP Tools.
{
"mcpServers": {
"zadojo": {
"url": "https://app.zadojo.com/mcp"
}
}
}Claude Desktop: abra Customize > Connectors, escolha Add custom connector e cole a URL.
ChatGPT precisa de uma conexão personalizada; o guia do ChatGPT lista os passos e os planos compatíveis. Outros clientes que aceitam servidores MCP remotos usam a mesma URL, e o guia de configuração do MCP cobre cada cliente.
O que o seu agente consegue ler
Cada ferramenta responde a um tipo de pergunta, então o seu agente escolhe o relatório certo a partir da sua pergunta em vez de montar uma consulta do GA4 do zero.
| Sua pergunta | Ferramenta |
|---|---|
| Como está o site inteiro em comparação com o período anterior? | get_google_analytics_traffic_overview |
| Quais países, regiões, cidades, navegadores ou origens lideram? | get_google_analytics_breakdown |
| Quantas pessoas estão no site agora? | get_google_analytics_realtime_users |
| O tráfego da busca orgânica está crescendo? | get_google_analytics_organic_overview |
| Quais páginas trazem visitantes orgânicos? | get_google_analytics_organic_landing_pages |
| Quais páginas são lidas, e por quanto tempo? | get_google_analytics_page_performance |
| Quais canais, origens ou campanhas trazem sessões? | get_google_analytics_traffic_acquisition |
| Quais eventos principais acontecem, e depois de quais páginas de entrada? | get_google_analytics_key_events |
| Quais produtos e páginas de entrada geram receita? | get_google_analytics_ecommerce_performance |
| O que os visitantes pesquisam dentro do site? | get_google_analytics_site_search |
| Quais dispositivos e países, e quantos visitantes recorrentes? | get_google_analytics_audience_breakdown |
| O rastreamento está configurado corretamente? | get_google_analytics_measurement_health |
| Quais páginas perto da primeira página valem a pena melhorar? | get_search_opportunities |
Visão geral do tráfego e detalhamentos
A visão geral do tráfego cobre todos os canais. Ela retorna visitantes (os usuários ativos do GA4), sessões, visualizações de página, taxa de rejeição, duração média da sessão, eventos principais e receita de compras, cada um comparado com o período anterior de mesma duração, além de uma tendência dia a dia.
A visão geral e o detalhamento aceitam os mesmos filtros: canal, origem, campanha, página de entrada, página, país, região, cidade, dispositivo, navegador e sistema operacional. Os filtros se combinam, então uma pergunta pode restringir os números a "visitantes de celular da Alemanha que vieram do Google". O detalhamento lista os 50 principais valores de uma dessas dimensões, e é assim que um agente desce dos países para as cidades dentro de um país.
Search Console e GA4 juntos
Se o projeto também tem o Search Console conectado, get_search_opportunities junta os dois. Ele pega as páginas nas posições 4 a 20 no Search Console, cruza com as sessões e os eventos principais delas no GA4 e dá uma pontuação por demanda, valor para o negócio e proximidade da primeira página. As páginas sem dados no GA4 ficam na lista, sem pontuação.
Os mesmos dados como painel
Você não precisa de um agente para ver os números. Depois que o GA4 está conectado, My Site > Analytics no app do zaDojo mostra:
- sete números principais (visitantes, sessões, visualizações de página, taxa de rejeição, sessão média, eventos principais e receita), cada um com a variação em relação ao período anterior;
- um gráfico diário do número que você escolher;
- quatro painéis: Sources (canal, origem, campanha), Pages (página de entrada, página), Locations (país, região, cidade) e Devices (dispositivo, navegador, sistema operacional);
- uma contagem ao vivo dos visitantes no site nos últimos 30 minutos, atualizada a cada minuto.
Clique em qualquer linha, um país ou um navegador, por exemplo, e a página inteira se restringe a ela. Os filtros se somam, e você pode escolher os últimos 7, 28 ou 90 dias, os últimos 12 meses ou as suas próprias datas. Ver o painel não gasta créditos.
Perguntas que valem a pena fazer
- "Como o tráfego de celular do Brasil mudou nos últimos 7 dias em comparação com a semana anterior?"
- "Quais cidades dos EUA mandaram mais visitantes este mês?"
- "Quais páginas de entrada trazem visitantes orgânicos que depois se cadastram?"
- "Tem alguém no site agora?"
- "Quais páginas estão na segunda página no Search Console e já convertem no GA4?"
- "O rastreamento da pesquisa no site está ativado, e quais eventos principais estão configurados?"
Quanto custa
As leituras do Google Analytics não gastam créditos, não importa quantas perguntas você faça, e ver o painel é grátis. Você pode conectar o GA4 numa conta nova sem cadastrar cartão.
A mesma conexão MCP também dá acesso às ferramentas de pesquisa pagas do zaDojo, como pesquisa de palavras-chave (cerca de € 0,07 por busca), backlinks e rastreamento de posições. Essas gastam créditos: o plano custa € 10 por mês e inclui € 10 de uso. A descrição de cada ferramenta diz se ela gasta créditos, então o seu agente sabe diferenciar.
Somente leitura por design
O zaDojo pede ao Google o escopo analytics.readonly. O seu agente consegue ler relatórios. Ele não consegue mudar configurações, editar eventos principais, adicionar usuários nem mexer no seu código de rastreamento. Você pode desconectar no zaDojo a qualquer momento ou remover o acesso do zaDojo nas configurações da sua conta do Google.
Comparação com o servidor MCP do próprio Google
O Google publica um servidor MCP de código aberto para o Google Analytics, marcado como experimental. Ele roda no seu computador com Python, e você mesmo faz a configuração:
- Crie ou escolha um projeto no Google Cloud.
- Ative a Google Analytics Admin API e a Data API.
- Configure credenciais com o escopo
analytics.readonly, por um cliente OAuth ou uma conta de serviço. - Aponte o servidor para o arquivo de credenciais e o ID do seu projeto.
| MCP do zaDojo | Servidor MCP do Analytics do Google | |
|---|---|---|
| Onde roda | Hospedado, uma URL | No seu computador (Python) |
| Configuração no Google Cloud | Nenhuma, você faz login com o Google | Projeto, duas APIs e um arquivo de credenciais |
| Ferramentas | 13 ferramentas, cada uma para um tipo de pergunta | Ferramentas genéricas como run_report |
| Tempo real | Visitantes dos últimos 30 minutos | Sim, via run_realtime_report |
| Cruzamento com Search Console | Sim | Não |
| Custo | Leituras do GA4 não gastam créditos | Grátis e de código aberto |
O servidor do Google é a melhor escolha se você quer tudo na sua própria máquina ou precisa de relatórios que o zaDojo não oferece, como funis ou dimensões personalizadas. O zaDojo é para quem quer os dados do GA4 no agente hoje, ao lado das ferramentas de Search Console, palavras-chave e posições, sem instalar nada.
Limites que vale conhecer
- Os relatórios cobrem só dias completos. Os períodos terminam ontem, no fuso horário da sua propriedade.
- O Google retém ou amostra alguns dados por privacidade. Quando isso acontece, as ferramentas marcam o relatório como limitado, e as linhas que faltam são desconhecidas, não zero.
- Os detalhamentos retornam os 50 principais valores. Períodos personalizados podem cobrir até 366 dias.
- Os filtros buscam correspondência exata. Os países usam códigos de duas letras, como BR, e os valores mais seguros para filtrar são os que um detalhamento já retornou.
- A contagem em tempo real cobre o site inteiro e não aceita filtros.
- Não há dados demográficos, dados por usuário nem dimensões personalizadas.
- Só propriedades GA4. A conta do Google que você conecta precisa ter acesso à propriedade.
- O Google limita quantos relatórios cada propriedade pode gerar por hora e por dia. Os relatórios mostram a cota restante quando o Google a informa. Se a cota acabar, as ferramentas retornam um erro em vez de números parciais, com um horário para tentar de novo quando o Google informa.
Perguntas frequentes
Preciso de um projeto no Google Cloud?
Não. Você faz login com o Google dentro do zaDojo e aprova o acesso somente leitura. O zaDojo cuida da conexão com a API.
Ler o Google Analytics gasta créditos?
Não. As leituras do Google Analytics e do Search Console não gastam créditos, no app e pelo seu agente.
O agente consegue mudar alguma coisa no Google Analytics?
Não. O zaDojo pede o escopo analytics.readonly, então o agente consegue ler relatórios, mas não mudar configurações, eventos ou usuários.
Quais clientes de IA podem usar?
Claude Code, Claude Desktop, Cursor, Codex CLI, Codex no app desktop do ChatGPT, ChatGPT com uma conexão personalizada e outros clientes que aceitam servidores MCP remotos.
Funciona com o Universal Analytics?
Não. Só lê propriedades GA4.