QuerySail: Google Analytics MCP

npx add-mcp 'https://mcp.querysail.com/ga4/mcp'

O que você pode perguntar

Perguntas diretas. Seu assistente escolhe as datas, dimensões, métricas e filtros, e cada resposta informa o que ela cobre. Para exemplos práticos e limites de dados, leia como conectar o GA4 ao ChatGPT e ao Claude.

• Quais propriedades do Google Analytics você pode acessar?
• Quantos usuários e sessões meu site teve nos últimos 28 dias?
• Quais canais trouxeram mais sessões no mês passado, e como isso mudou em relação ao mês anterior?
• Quais são minhas principais páginas de destino por eventos-chave?
• Quantas pessoas estão no site agora, e de quais países?
• Compare sessões de pesquisa orgânica com as mesmas semanas do ano passado.

O que ele faz

• Descoberta de propriedades. Lista as propriedades GA4 que suas contas Google conectadas podem ler, agrupadas por conta do Analytics.
• Qualquer relatório. Toda dimensão e métrica da Data API, incluindo suas definições personalizadas e eventos-chave, com filtros e ordenação.
• Comparações e tempo real. O que mudou entre dois períodos e quem está no site agora.
• Cobertura clara. As respostas informam as datas e o fuso horário usados, se há mais linhas disponíveis e quando o Google aplicou limites ou amostragem ao relatório.

O que ele não faz

• Ele nunca grava no Google: não edita propriedades, eventos-chave, públicos ou configurações.
• Ele não consegue ler propriedades que sua conta Google não pode ler, nem propriedades do Universal Analytics.
• Ele não armazena um arquivo de analytics. Os dados são buscados quando você pergunta, com um cache de curta duração.
• Ele não explica por que os números mudaram. Seu assistente interpreta isso.

Cinco ferramentas MCP somente leitura

Todas são marcadas como somente leitura para clientes MCP.

list_properties

As propriedades GA4 que suas contas Google conectadas podem ler, com seus IDs exatos, como properties/123456789.

list_fields

As dimensões e métricas que uma propriedade suporta, incluindo suas definições personalizadas, para que seu assistente use os nomes corretos.

run_report

Quaisquer métricas por quaisquer dimensões em um intervalo de datas, com filtros, ordenação, totais e 20 a 100 linhas por chamada com paginação.

compare_report

Dois períodos lado a lado: o período anterior, os mesmos dias da semana um ano antes ou suas próprias datas, com os principais canais, páginas ou países que ganharam ou perderam.

run_realtime_report

Usuários ativos, visualizações e eventos nos últimos 30 minutos, por país, dispositivo, página ou evento.

Configuração em cerca de cinco minutos

Sem projeto no Google Cloud e nada para instalar. Incluído no mesmo plano do Search Console; veja preços e limites de uso.

Conecte seu app de IA ao servidor MCP

Você precisa de uma conta QuerySail com o Google Analytics conectado. Inicie o teste gratuito, conecte o Google Analytics em Conta → Conexões e adicione este endpoint ao seu app, fazendo login com sua conta QuerySail quando solicitado:

https://mcp.querysail.com/ga4/mcp

1. Abra Configurações → Segurança e login e ative o Modo desenvolvedor. A disponibilidade depende do seu plano e das configurações do workspace.
2. Acesse chatgpt.com/plugins e selecione o botão de adicionar.
3. Dê o nome de QuerySail Analytics, cole o endpoint acima como URL de conexão e crie.
4. Faça login com sua conta QuerySail quando solicitado e adicione QuerySail pelo menu de ferramentas em um novo chat.

Perguntas, respondidas

Outra coisa? Veja suporte.

O que é um servidor MCP do Google Analytics?

MCP (Model Context Protocol) é o padrão pelo qual assistentes de IA chamam ferramentas externas. Um servidor MCP do Google Analytics expõe seus relatórios GA4 como ferramentas, para que ChatGPT, Claude ou Codex possam buscar usuários, sessões, engajamento, eventos-chave e receita quando você fizer uma pergunta, em vez de você criar relatórios na interface do Analytics.

Preciso de um projeto no Google Cloud, conta de serviço ou chave de API?

Não. Você aprova o acesso somente leitura ao Google Analytics uma vez, no site da QuerySail. Seu app de IA então faz login com sua conta QuerySail. Não há nada para instalar nem chave para colar.

Ele pode alterar minhas configurações do Analytics?

Não. A QuerySail só solicita ao Google acesso somente leitura ao Analytics. Ela não pode criar ou editar propriedades, fluxos de dados, eventos-chave, públicos ou qualquer outra configuração.

Quais dados meu assistente pode obter?

Qualquer dimensão e métrica do Google Analytics 4 que a Data API oferece, incluindo suas dimensões personalizadas, métricas personalizadas e eventos-chave: usuários, sessões, visualizações, engajamento, eventos, conversões e receita, segmentados por data, canal, origem e mídia, página de destino, página, país, dispositivo, evento e mais, com filtros. As comparações mostram o que mudou entre dois períodos e quais canais ou páginas ganharam ou perderam. Os relatórios em tempo real cobrem os últimos 30 minutos. Propriedades do Universal Analytics não são suportadas.

A QuerySail armazena meus dados do Analytics?

Os relatórios são buscados do Google quando seu assistente pergunta e mantidos em um cache de curta duração de 15 minutos para evitar chamadas repetidas. Relatórios em tempo real não são armazenados em cache. Não há arquivo de longo prazo.

Quanto custa?

O Google Analytics está incluído no mesmo plano de US$ 8 por mês do Search Console, com propriedades conectadas ilimitadas. O teste gratuito de 7 dias não exige cartão e começa com seu primeiro relatório bem-sucedido em qualquer um dos produtos.

A QuerySail é feita pelo Google?

Não. A QuerySail é um produto independente que usa as APIs públicas de Dados e Administração do Google Analytics. Ela não é afiliada ao Google, à OpenAI ou à Anthropic, nem endossada por eles.