Quattr

npx add-mcp 'https://mcp.quattr.com/mcp'

Visão Geral

O que é o MCP da Quattr?

O MCP (Model Context Protocol) é um padrão aberto que permite que assistentes de IA usem ferramentas externas com segurança. O servidor MCP da Quattr dá ao seu assistente um conjunto de análises Quattr prontas e confiáveis que ele pode executar para você. Quando você pergunta "Como minhas tendências de cliques no mês passado se comparam ao mês anterior?", o assistente escolhe a análise Quattr correta, executa-a com base nos dados da sua organização (protegidos por login OAuth com sua conta Quattr) e responde com números reais, geralmente como um card de resultado rico e interativo com um link de volta ao aplicativo Quattr.

Somente leitura por design

O MCP da Quattr só pode ler e analisar seus dados. Ele não pode modificar sua configuração, segmentos ou site no Quattr. Toda conexão é limitada a acesso somente leitura.

Início rápido

1. Tenha uma conta Quattr

   Use o mesmo e-mail de trabalho que você usa em www.quattr.com e certifique-se de ter feito login no aplicativo Quattr pelo menos uma vez.

2. Adicione o conector

   No seu cliente de IA, adicione a URL do servidor MCP da Quattr https://mcp.quattr.com/mcp e faça login quando solicitado. Passo a passo por cliente →

3. Comece a perguntar

   Experimente: "Quais foram meus cliques e impressões orgânicos totais no mês passado?" ou navegue pela biblioteca de prompts.

Sobre o que você pode perguntar

A Quattr dá ao seu assistente 58 ferramentas de análise em nove áreas. Sua pergunta é roteada automaticamente para a ferramenta certa, então você nunca precisa saber os nomes das ferramentas.

Desempenho em busca (GSC)

Cliques, impressões, CTR e rankings: totais, detalhamentos, tendências, movimentações, curvas de CTR e oportunidades de distância mínima.

• "Top 10 palavras-chave por cliques em junho."
• "Quais palavras-chave mais se moveram em relação a maio?"

Visibilidade em IA

Com que frequência ChatGPT, Perplexity, Gemini e Google AI Mode citam suas páginas: tendências, concorrentes, prompts e lacunas de cobertura.

• "Nossa visibilidade em IA está subindo ou caindo ao longo de 3 meses?"

Busca paga

Gastos com Google Ads, CPC, custo por conversão, participação de impressões e sobreposição de palavras-chave pagas/orgânicas.

• "Estamos pagando por palavras-chave pelas quais já rankeamos?"

Web analytics e conversões

Sessões, usuários, engajamento, conversões por meta, funis e significância estatística de mudanças (GA4 / Adobe).

• "Quantas conversões tivemos, detalhadas por meta?"

Saúde do site (Core Web Vitals)

LCP, INP, CLS e notas do Lighthouse: páginas mais fracas, divisão por dispositivo e visualizações ponderadas por tráfego.

• "Algum problema de Core Web Vitals? Quais páginas são as mais fracas?"

Crawlers e estrutura do site

Atividade de crawlers de IA (GPTBot, ClaudeBot…), verificação do Googlebot, desperdício de orçamento de rastreamento, páginas órfãs, lacunas de indexação.

• "Os crawlers de IA estão alcançando nosso conteúdo?"

Estatísticas e verificações de sanidade

Uma mudança é real ou é ruído? Duas métricas se movem juntas? Testes rigorosos de significância e correlação entre domínios.

• "Os cliques caíram 20%. Isso é real ou é ruído?"

Dashboards e relatórios

Encontre e execute seus dashboards e relatórios salvos existentes no Quattr diretamente do chat.

• "Pré-visualize meu dashboard executivo de SEO."

Veja a referência completa de ferramentas →

Como os resultados aparecem

Em clientes que suportam resultados interativos (como ChatGPT e Claude), as respostas são renderizadas como cards nativos da Quattr. Cada card é honesto sobre de onde vieram seus números:

Desempenho em buscagoogle/organic · site

Cliques

Total do período

79,54K

Média diária

2,65K

Último dia

3,39K

30 de jun

Dia de pico

3,65K

19 de jun

3,7K1,8K0

1 de jun7 de jun13 de jun18 de jun24 de jun30 de jun

observacionalem 30/06/2026GSC tem atraso de 1–2 diasfonte: google/organic

Elemento do card	O que ele informa
Resumo principal	Um resumo de uma linha da descoberta principal, com código de cores neutro / positivo / atenção.
Faixa de escopo	Chips que refletem exatamente o que produziu os números: intervalo de datas, período de comparação, orgânico vs pago, filtro de marca, dispositivo, segmento e quaisquer filtros. Se os números parecerem surpreendentes, verifique o escopo primeiro.
observacional	Os dados são observacionais: mostram o que aconteceu, não o que causou. Correlações não são prova de causalidade.
Nota de atualização	"em <date>" mais qualquer atraso conhecido (ex.: dados do Search Console têm atraso de 1–2 dias).
Ressalvas	Quaisquer notas de honestidade, ex.: um filtro que não pôde ser aplicado em um deep-link, ou uma estimativa modelada.
Abrir no Quattr	Deep-links para o aplicativo Quattr com a mesma visualização, datas, segmento e filtros já aplicados, para que você possa continuar explorando.
Abrir em Análise Ad Hoc	Abre os dados exatos por trás do card na visualização de Análise Ad Hoc do Quattr: a tabela subjacente precisa, que você pode ajustar, salvar e adicionar a qualquer um dos seus dashboards do Quattr.

Clientes somente texto

Alguns clientes (ex.: Claude Code no terminal) não renderizam cards interativos, então você receberá os mesmos números como texto limpo. Nada é perdido, exceto os visuais.

Informações úteis

Somente seus dados

O login vincula sua sessão à sua organização. Cada resultado é carimbado com um rótulo company_name, e o assistente é instruído a parar se ele não corresponder à empresa em discussão.

Atualização dos dados

As fontes são atualizadas em cadências diferentes: Search Console tem atraso de 1–2 dias, web analytics é carregado diariamente, participação de mercado e visibilidade em IA ~diariamente, Core Web Vitals aproximadamente quinzenalmente. Pergunte "Quão atualizados estão meus dados?" a qualquer momento.

Limites de uso justo

Até 60 solicitações/minuto por usuário e um orçamento diário de análise por conta (reinicia à meia-noite UTC). O uso normal em conversas nunca atinge esses limites.

Recusas honestas

Se uma fonte de dados não fizer parte da sua assinatura, ou se uma pergunta não puder ser respondida fielmente (ex.: uma tendência de métrica não suportada), você recebe um claro "não disponível", nunca um número inventado.

Próximos passos

→ Conecte seu cliente de IA (Claude, ChatGPT, Cursor, Claude Code, VS Code…)
→ Copie e cole exemplos de prompts para ver o que é possível
→ Explore todas as 58 ferramentas de análise
→ Solução de problemas, segurança e FAQ

Conexão e Configurações

Conecte o servidor MCP da Quattr ao seu assistente de IA em cerca de dois minutos. A configuração é a mesma em todos os lugares: adicione a URL do servidor, faça login com sua conta Quattr e comece a fazer perguntas.

Endpoint do servidor

HTTPS https://mcp.quattr.com/mcp Transporte: Streamable HTTP (remoto) · Autenticação: OAuth 2.1 com sua conta Quattr · Acesso: somente leitura

Antes de conectar

Requisito	Detalhes
Uma conta Quattr	Faça login com o mesmo e-mail de trabalho que você usa em www.quattr.com. Você deve ter feito login no aplicativo Quattr pelo menos uma vez antes de conectar. Um e-mail totalmente novo que nunca fez login será rejeitado no login.
Acesso MCP para sua organização	O acesso MCP é habilitado por organização pela Quattr. Se o login for recusado para toda a sua equipe, entre em contato com seu gerente de sucesso do cliente Quattr.
Um cliente de IA suportado	A Quattr aprova cada cliente de IA explicitamente por segurança. Atualmente aprovados: Claude (claude.ai web e desktop), Claude Code, ChatGPT, Cursor e VS Code. Usando outro? Veja Outros clientes MCP.

Conecte seu cliente de IA

Clique no seu cliente para configuração passo a passo.

Claude (claude.ai web e Claude Desktop) Abrir Conectores ↗

1. Abra claude.ai ou o aplicativo desktop do Claude.
2. Vá para Configurações → Conectores → Adicionar conector personalizado.
3. Configure o conector:
   Nome: Quattr Analytics
   URL: https://mcp.quattr.com/mcp
4. Clique em Adicionar e depois em Conectar. Uma janela de login da Quattr é aberta. Faça login com suas credenciais da Quattr (www.quattr.com).
5. Em um novo chat, certifique-se de que o conector Quattr esteja habilitado no menu de ferramentas e comece a fazer perguntas sobre seus dados.
6. Verifique se funciona: pergunte "Quais fontes de dados estão conectadas para meu site?". Uma resposta real sobre seu site confirma que você está conectado e vendo os dados da sua empresa.

Observação: conectores personalizados exigem um plano do Claude que os suporte; em planos Team/Enterprise, um administrador pode precisar habilitar o conector para o workspace.

Claude Code (CLI)

Configuração: execute o comando abaixo no seu terminal e depois autentique dentro do Claude Code.

1. Adicione o servidor MCP da Quattr (escopo de usuário o disponibiliza em todos os projetos):

   claude mcp add --transport http --scope user quattr https://mcp.quattr.com/mcp
   

2. Inicie o Claude Code:

   claude
   

3. Autentique com a Quattr:

   /mcp
   

   Selecione quattr e siga o fluxo de login no navegador.
4. Verifique se funciona: pergunte "Quais fontes de dados estão conectadas para meu site?"

Observação: o Claude Code mostra resultados como texto limpo em vez de cards interativos; os números são idênticos.

ChatGPT Abrir ChatGPT ↗

Conectores MCP no ChatGPT são adicionados via modo desenvolvedor (a disponibilidade depende do seu plano do ChatGPT e das configurações do workspace).

1. Abra chatgpt.com ou o aplicativo desktop do ChatGPT.
2. Vá para Configurações → Apps e Conectores → Configurações avançadas e habilite o Modo desenvolvedor.
3. De volta em Apps e Conectores, escolha Criar (novo conector) e insira:
   Nome: Quattr Analytics
   URL do servidor MCP: https://mcp.quattr.com/mcp
   Autenticação: OAuth
4. Clique em Conectar e complete o login da Quattr quando solicitado.
5. Em um chat, adicione o conector Quattr no menu de ferramentas (modo desenvolvedor) e comece a perguntar.

Dica: para melhores resultados, crie um projeto dedicado no ChatGPT para análises da Quattr e adicione instruções como:

When using the Quattr MCP: always state the date range you analyzed; use
the tools to discover segments, trackers and filter values rather than
asking me; prefer the analysis the find_relevant_analysis tool routes to;
check the company_name on results matches my company; and include the
Open in Quattr link when a result card provides one.

Cursor Adicionar ao Cursor

Instalação rápida: clique em Adicionar ao Cursor nesta linha (requer o Cursor instalado) e depois autentique. Ou configure manualmente:

1. Abra Cursor → Configurações… → Configurações do Cursor → Ferramentas e Integrações → Novo Servidor MCP.
2. Adicione isto ao seu mcp.json:

   {
     "mcpServers": {
       "quattr": {
         "url": "https://mcp.quattr.com/mcp",
         "transport": "streamable-http"
       }
     }
   }
   

3. Volte para Ferramentas e Integrações e clique no prompt de autenticação ao lado de quattr; faça login com suas credenciais da Quattr.
4. Faça perguntas no chat; o Cursor chamará as ferramentas da Quattr automaticamente. Verifique: "Quais fontes de dados estão conectadas para meu site?"

Se as chamadas de ferramenta começarem a falhar depois, execute "Limpar Todos os Tokens MCP" na Paleta de Comandos e reautentique.

VS Code (GitHub Copilot) Adicionar ao VS Code

Instalação rápida: clique em Adicionar ao VS Code nesta linha, aprove o prompt "Abrir Visual Studio Code" do navegador e depois autentique. Ou configure manualmente:

1. Execute o comando MCP: Adicionar Servidor… na Paleta de Comandos (ou edite mcp.json) e escolha HTTP.
2. Use esta configuração:

   {
     "servers": {
       "quattr": {
         "type": "http",
         "url": "https://mcp.quattr.com/mcp"
       }
     }
   }
   

3. Quando o VS Code solicitar autenticação, complete o login da Quattr no seu navegador.
4. Use o Copilot Chat no modo Agente; as ferramentas da Quattr aparecem no seletor de ferramentas.

+ Outros clientes MCP

Qualquer cliente compatível com MCP que suporte servidores remotos Streamable HTTP com OAuth pode tecnicamente falar com a Quattr, mas por segurança, a Quattr só admite clientes que foram explicitamente aprovados (allowlist) para o serviço. Se o seu cliente mostrar um erro de autorização como "este cliente não é permitido", ele ainda não está na lista de aprovados.

Para solicitar aprovação de um novo cliente, entre em contato com seu gerente de sucesso do cliente Quattr com o nome do cliente e sua URL de metadados do cliente OAuth (CIMD), se houver.

Como funciona o login

OAuth 2.1, sem chaves de API

Você nunca cola chaves ou senhas no cliente de IA. O cliente redireciona você para o login seguro da Quattr; após sua aprovação, ele recebe tokens de acesso assinados de curta duração que são renovados automaticamente.

Escopo somente leitura

Os tokens carregam apenas o escopo quattr:read. O MCP pode analisar seus dados, mas nunca pode alterar sua configuração no Quattr ou escrever qualquer coisa.

Suas permissões, nada além disso

O MCP herda o acesso existente da sua conta Quattr: seu e-mail de login verificado é mapeado para seu usuário Quattr, que determina a organização e os dados de onde cada resposta vem. Conectar não concede acesso adicional além do que sua conta já tem.

Sessões

As conexões permanecem válidas por períodos prolongados e sobrevivem a implantações da Quattr. Uma sessão ociosa expira após 7 dias, após os quais o cliente reconecta de forma transparente ou pede que você reautentique.

De qual empresa são os dados que estou vendo?

Cada conversa está vinculada a exatamente uma organização: aquela à qual sua conta Quattr está associada no momento.

• Cada resultado, incluindo erros, traz um rótulo company_name identificando o cliente a quem os dados pertencem. O assistente é instruído a parar e avisar você se o rótulo não corresponder à empresa sobre a qual você está perguntando.
• Se você tiver acesso a vários clientes Quattr e alternar entre eles no aplicativo Quattr, inicie uma nova conversa (ou desconecte/reconecte o conector). Conversas existentes permanecem vinculadas ao cliente com o qual foram iniciadas, e você verá uma mensagem de "tenant alterado" se uma sessão desatualizada for usada.

Configurações que moldam suas respostas

O MCP resolve os objetos de negócio que sua equipe configurou no Quattr, por nome, para que você possa simplesmente mencioná-los no chat. Gerencie-os no aplicativo Quattr; o MCP capta as alterações automaticamente (em até ~24 horas, ou imediatamente em uma nova sessão).

Objeto	O que faz no chat	Exemplo
Segmentos	Escopam análises de participação de mercado e rankings a um conjunto de palavras-chave monitoradas. O segmento primário "Mercado Geral" (padrão) cobre todo o seu domínio.	"participação de mercado no meu segmento Hospedagem"
Rastreadores de visibilidade em IA	Escopam métricas de citação em respostas de IA (ChatGPT, Perplexity, Gemini, AI Mode) a um conjunto de prompts monitorados.	"visibilidade em IA no meu rastreador de marca"
Metas	As análises de conversão usam os nomes das suas próprias metas do GA.	"conversões por meta: quantas Compras?"
Conjuntos de concorrentes	Comparações competitivas são feitas contra os concorrentes monitorados por segmento.	"compare-nos com Hostinger e GoDaddy"
Intenções (grupos de palavras-chave) e categorias	Filtram ou detalham quase qualquer análise pelos seus grupos de palavras-chave e categorias de conteúdo configurados.	"cliques para minha intenção Informacional"

Fontes de dados e o que elas desbloqueiam

A disponibilidade das ferramentas segue sua assinatura Quattr e os feeds de dados conectados. Se uma fonte não estiver conectada, perguntas relacionadas recebem um honesto "não disponível" em vez de um número errado. Pergunte "Quais fontes de dados estão conectadas para o meu site e qual a atualização de cada uma?" a qualquer momento.

Fonte de dados	Desbloqueia	Atualização típica
Google Search Console	Desempenho de busca: cliques, impressões, CTR, posição, movimentações, curva de CTR, distância do topo	Atraso de 1–2 dias
GSC via BigQuery (opcional)	Dados por consulta muito mais granulares; usados apenas quando você pede explicitamente a fonte BigQuery e sua conta tem o feed	Atraso de 1–2 dias
Participação de mercado	Participação vs concorrentes, rankings competitivos, lacunas de palavras-chave, snippets em destaque, inclusão no Google AI Overviews, atribuição de prompts AEO	~Diária
Visibilidade em IA	Métricas de citação do ChatGPT / Perplexity / Gemini / AI Mode, tendências, participação de voz dos concorrentes	~Diária
Web analytics (GA4 / Adobe)	Sessões, usuários, engajamento, conversões, funis, testes de significância	Noturna
Google Ads	Gasto, CPC, custo por conversão, participação de impressões, sobreposição pago/orgânico	~Diária
Lighthouse / experiência de página	Notas de Core Web Vitals, páginas mais fracas, junções tráfego × LCP	~Quinzenal (varia por conta)
Feed de rastreamento do site	Páginas órfãs, fluxo de links internos, lacunas de indexação, desperdício de orçamento de rastreamento	Por cronograma de rastreamento
Logs de servidor web	Atividade de crawlers de IA, verificação do Googlebot	Horas – noturna

Limites de uso

Os limites mantêm o Quattr analytics rápido para todos. O uso conversacional normal não os atinge.

Limite	Valor	Quando excedido
Solicitações por usuário	60 / minuto	"Muitas solicitações; tente novamente em N segundos"
Orçamento diário de análise por conta	500 consultas de análise ou 60 minutos de tempo de consulta / dia	"Orçamento esgotado; redefine à meia-noite UTC"
Consultas pesadas simultâneas por usuário	2	Breve "sobrecarga" de backpressure; o assistente tenta novamente
Consulta única mais longa	Até ~10 minutos	Perguntas muito pesadas podem demorar; a conexão permanece ativa

Para administradores

Controle de acesso

O acesso ao MCP é habilitado por organização pela Quattr, e cada cliente de IA é aprovado individualmente antes de concluir o login. Entre em contato com a Quattr para habilitar o acesso para sua equipe ou aprovar um cliente adicional.

Proteção de dados

OAuth 2.1 com PKCE; tokens de acesso assinados de curta duração com tokens de atualização rotativos; isolamento estrito por organização aplicado na camada de dados em cada consulta; escopo somente leitura.

Auditabilidade

As chamadas de ferramentas são registradas em log de auditoria no servidor (enviadas de forma durável para armazenamento seguro), para que o uso seja rastreável por usuário e organização.

Processamento pelo cliente de IA

O assistente de IA que você conecta (ex.: Claude ou ChatGPT) processa os resultados das consultas para escrever suas respostas. Revise as políticas da sua organização sobre análise de dados assistida por IA antes de uma implementação ampla.

Após uma atualização do lado da Quattr

Se as ferramentas parecerem ausentes ou se comportarem de forma estranha logo após um novo lançamento da Quattr, atualize/reconecte o conector e inicie uma nova conversa. Os clientes armazenam em cache as definições de ferramentas por sessão.

Referência de Ferramentas

O Quattr MCP expõe 58 ferramentas. Você nunca as chama pelo nome. Basta fazer uma pergunta e o assistente escolhe a ferramenta certa automaticamente. Esta referência ajuda você a entender o que é possível e por que uma resposta foi escopada daquela forma.

Somente leitura · apenas sua organização

Todas as análises são somente leitura e escopadas à sua organização. Ferramentas que precisam de uma fonte de dados que você não possui (ex.: Google Ads, rastreamento do site) retornam um honesto "não disponível" em vez de um número. Quer experimentar? Pegue uma pergunta pronta na seção Exemplos de Prompts.

Perguntar e descobrir — 5 ferramentas

Como o assistente encontra a análise, as entidades e os valores de filtro certos.

Ferramenta	O que faz	Observações
find_relevant_analysis	Roteia qualquer pergunta de análise para a análise Quattr autoritativa.	Chamada primeiro para cada pergunta.
resolve_entity	Resolve os nomes que você usa (segmentos, rastreadores de IA, metas, conjuntos de concorrentes, plataformas de IA) para o objeto exato.	Diga "meu segmento Hospedagem" e ele resolve automaticamente.
list_filter_values	Lista os valores válidos (e operadores) para um filtro: país, intenção, categoria, dispositivo, marca, faixa de posição, página, consulta…	Evita valores de filtro adivinhados.
describe_data_sources	Quais fontes de dados sua conta possui, cada uma com sua data de dados mais recente e cadência de carregamento.	Ótima primeira pergunta após conectar.
get_data_freshness	Data de dados mais recente disponível por domínio (busca, analytics, participação de mercado, visibilidade em IA, anúncios, experiência de página).	Use quando os números parecerem desatualizados.

Desempenho de busca (Google Search Console) — 8 ferramentas

Seus cliques, impressões, CTR e posição média. Padrão para orgânico.

Ferramenta	O que responde	Observações
search_performance	Totais ou principais palavras-chave/páginas para um período: cliques, impressões, CTR, posição, contagens únicas de palavras-chave/páginas; tendência opcional ou comparação de períodos.	"Total de cliques no mês passado", "top 10 palavras-chave".
gsc_breakdown	Um período detalhado por página, país, dispositivo, categoria, intenção, consulta, faixa de posição, fonte de tráfego, idioma ou geografia.	Apenas instantâneo (sem série temporal).
gsc_dimensional_trend	Uma série diária/semanal/mensal/trimestral por um desses campos de detalhamento, ex.: cliques semanais por página.	Série multi-métrica (qualquer combinação de cliques, impressões e CTR em uma única chamada).
seo_ranking_movement_report	Maiores ganhadores e perdedores em cliques, impressões ou posição entre dois períodos.	"O que mudou em relação ao mês passado?"
ctr_curve_model	A curva de CTR por posição do seu site, além de consultas com desempenho acima/abaixo do CTR esperado.	Segmentado por marca vs não-marca.
striking_distance	Palavras-chave logo fora da página 1 (posições 8–20) classificadas pelo upside de cliques modelado se impulsionadas.	Estimativa modelada com ajuste de AI Overview, não uma promessa.
compare_periods	Deltas período a período de todo o site para um resultado resumido.	Para comparações em nível de site.
run_looker_query	Saída avançada: consultar um conjunto de dados por campos/filtros/ordenações explícitos.	Usada apenas quando nenhuma análise padrão se encaixa.

Participação de mercado e competitivo — 9 ferramentas

Você vs seus concorrentes monitorados. Os valores de participação são porcentagens em uma escala de 0–100; as análises usam como padrão seu segmento primário "Mercado Geral", a menos que você nomeie um.

Ferramenta	O que responde	Observações
market_share_overview	Sua participação vs concorrentes, o líder do segmento e a lacuna, fatiável por intenção, categoria, página ou presença de marca.	Apenas participação; combine com cliques via growth_vs_market_share.
growth_vs_market_share	Participação de mercado lado a lado com uma de suas próprias métricas (cliques, impressões, CTR, posição).	"Estamos crescendo mais rápido que nossa participação?"
market_share_breakdown	Participação classificada entre intenções, palavras-chave, páginas, categorias, presença de marca, faixas de posição ou países, incl. maiores ganhos/perdas.	A visão de participação de mercado multi-linha.
market_share_query	Participação para você e vários concorrentes nomeados em uma única tabela.	"Nós vs Hostinger vs GoDaddy."
competitive_keyword_ranking	Posição média por palavra-chave para você e concorrentes.	Ranking (1 = topo), não participação.
competitive_overview	Instantâneo de uma métrica competitiva vs rivais: snippets em destaque, inclusão no Google AI Overviews, menções à marca, palavras-chave/páginas classificadas.	AI Overviews no SERP do Google, não citações do ChatGPT.
competitive_trends	As mesmas métricas competitivas como série temporal (mais participação de mercado e posição média).	Em nível de segmento.
total_search_share	Participação orgânica + participação de impressões pagas combinadas em uma única participação total do SERP.	Uma estimativa rotulada; a geometria do SERP é aproximada.
seo_keyword_gap_analysis	Palavras-chave onde os concorrentes vencem você: faixas de perdendo / vencendo / não classificado com tamanhos de lacuna.	Por segmento.

Visibilidade em IA (ChatGPT · Perplexity · Gemini · AI Mode) — 8 ferramentas

Como os mecanismos de resposta por IA citam você. Distinto dos AI Overviews no SERP do Google (veja ferramentas competitivas acima). A maioria das visões é escopada a um rastreador de visibilidade em IA.

Ferramenta	O que responde	Observações
ai_visibility_overview	Seu scorecard de respostas de IA: taxa de citação, participação de voz, menções, sentimento por plataforma.	Conta inteira ou por rastreador.
ai_visibility_trend	Citações / participação de voz / sentimento ao longo do tempo.	"Subindo ou descendo?"
ai_visibility_competitors	Quais concorrentes lideram sobre você em visibilidade de IA, classificados.	Por rastreador.
ai_visibility_citation_audit	Contagens atuais de citações e taxa para um período.	"Nossas citações estão caindo?"
ai_visibility_drilldown	Detalhamento completo por aba: concorrentes, prompts, URLs citadas, intenção, geografia, marca.	Espelha a visão do aplicativo Quattr.
ai_citation_attribution	Quais prompts citam suas páginas com mais frequência.	Onde você vence respostas de IA.
ai_page_citations	Quais de suas páginas (ou de um concorrente) são citadas, com que frequência e em que posição.	Categorias de blog vs comparação vs documentação.
ai_prompt_coverage_gap	Prompts onde você está ausente ou sub-citado: suas lacunas de cobertura.	Útil para planejamento de conteúdo.

Busca paga (Google Ads) — 3 ferramentas

Ferramenta	O que responde	Observações
paid_search_overview	Gasto, CPC, custo por conversão, conversões: total, tendência ou classificadas por palavra-chave/campanha/grupo de anúncios/página.	Domínio inteiro.
paid_impression_share	Participação de impressões de busca / topo / topo absoluto e participação perdida por posição.	Cobertura do leilão, por segmento.
paid_organic_overlap	Palavras-chave pelas quais você paga enquanto já classifica organicamente (top-3 sinalizado).	Observacional, não prova de canibalização.

Web analytics e conversões (GA4 / Adobe) — 4 ferramentas

Ferramenta	O que ela responde	Observações
web_analytics_overview	Sessões, usuários, conversões, taxa de conversão, rejeição, engajamento, filtrados ou segmentados por país, dispositivo, página, origem, categoria, intenção.	A visão comportamental, no site.
conversions_overview	Contagens de conversão pelos seus próprios nomes de meta (Compra, Cadastro…), além de transações, receita e taxa de conversão.	Usa as metas do GA que você configurou.
funnel_dropoff	Onde os usuários desistem entre as etapas do funil (ex.: sessões → conversões → transações) e o maior vazamento.	Macro-funil sobre métricas de contagem.
pop_significance	Se uma mudança na taxa de conversão ou no tráfego é estatisticamente real ou apenas ruído.	Teste z / teste t adequado, com veredito.

Saúde do site (Core Web Vitals) — 2 ferramentas

Ferramenta	O que ela responde	Observações
site_health_cwv_check	LCP / INP / CLS / notas de desempenho, distribuições, páginas mais fracas, divisão por dispositivo, tendências, pontuações do Lighthouse.	Os dados de CWV normalmente são atualizados aproximadamente a cada duas semanas.
page_traffic_cwv	Suas páginas de maior tráfego combinadas com o LCP delas: quais páginas movimentadas estão lentas.	Junção observacional, top N páginas.

Rastreadores e estrutura do site — 6 ferramentas

A partir dos logs do seu servidor e do rastreamento do site do Quattr. Exige o feed correspondente.

Ferramenta	O que ela responde	Observações
ai_crawler_analysis	Como rastreadores de IA (GPTBot, ChatGPT-User, PerplexityBot, ClaudeBot…) acessam seu site. Google-Extended é um controle de robots, não um rastreador, então nunca aparece nos logs.	Atividade dos logs do servidor, não citações.
bot_verification	Quais "Googlebots" são reais vs. falsificados, via verificação de IP.	Feed de logs da web.
crawl_budget_waste	URLs profundas, parametrizadas ou com status diferente de 200 que consomem o orçamento de rastreamento.	Feed de rastreamento do site.
indexation_gap_diagnosis	Páginas bloqueadas de indexação e o motivo (noindex, canônica, robots, status).	Feed de rastreamento do site.
orphan_pages	Páginas para as quais nenhum link interno aponta.	Feed de rastreamento do site.
internal_link_flow	Contagens de links internos de entrada/saída por página; páginas importantes com poucos links.	Feed de rastreamento do site.

Estatísticas — 2 ferramentas

Ferramenta	O que ela responde	Observações
significance_check	Uma mudança entre períodos é real ou ruído? Delta, valor-p e um veredito simples.	Funciona em busca, participação, analytics, pago e CWV.
correlate_domains	Duas métricas de áreas diferentes se movem juntas? Pearson/Spearman com significância.	Correlação não é causalidade, e a ferramenta diz isso.

Dashboards e relatórios salvos — 5 ferramentas

Ferramenta	O que ela responde	Observações
find_relevant_content	Os dashboards/relatórios salvos mais relevantes para uma pergunta.	Prefere uma análise padrão quando ela responde à pergunta.
list_dashboards	Seus dashboards, dos mais usados primeiro.
run_dashboard	Dashboard nativo de chat: recomendar, visualizar (executa blocos) ou descrever.	Inclui um link direto para o dashboard completo.
run_dashboard_tile	Executa um único bloco, opcionalmente com filtros/datas substituídos.
run_look	Executa um relatório salvo por ID.

Resultados e utilitários — 6 ferramentas

Ferramenta	O que ela responde	Observações
render_analysis	Renderiza uma síntese dos resultados anteriores como um card nativo do Quattr (relatório, tabela, cards de estatísticas, aviso).	É assim que resumos de múltiplas consultas viram cards.
build_chart_spec	Cria uma especificação de gráfico a partir das linhas de resultado.
summarize_results	Estatísticas descritivas seguras: totais apenas para métricas que são realmente aditivas.	Nunca soma participação de mercado, CTR ou rankings.
explain_analysis	Explica o que uma análise nomeada calcularia e seu custo, sem executá-la.	"Como funciona o striking_distance?"
link_to_report	Um link direto para o app do Quattr na página de relatório correspondente.	Alimenta o "Abrir no Quattr".
get_query_history	Suas chamadas de análise recentes com tempo e status.	Útil para "o que executamos?".

As contagens refletem as ferramentas disponíveis para clientes de IA conectados. Algumas ferramentas de diagnóstico adicionais existem apenas para uso interno do Quattr.

Exemplos de prompts

Copie e cole qualquer um destes em um chat com o conector do Quattr habilitado. Nenhuma sintaxe especial é necessária; são apenas perguntas. Troque os intervalos de datas, segmentos e nomes de concorrentes pelos seus.

Como obter respostas melhores

Nomeie o período "mês passado", "junho de 2026", "as últimas 13 semanas". Explícito vence vago. Os intervalos incluem ambos os extremos; as semanas vão de domingo a sábado.

Nomeie o escopo Diga o segmento ("meu segmento de Hospedagem"), tracker, país ou dispositivo se quiser um específico. Caso contrário, você recebe o padrão do domínio inteiro.

Orgânico vs. pago As métricas de busca são orgânicas por padrão. Diga "pago" ou "Google Ads" quando quiser números do lado de gastos.

Pergunte "é real?" Qualquer mudança surpreendente pode ser testada quanto à significância; basta perguntar se é real ou ruído.

Desempenho de busca

Quais foram meus cliques e impressões orgânicos totais no mês passado?

Top 10 palavras-chave por cliques no mês passado.

Quantas palavras-chave e páginas únicas classificamos no mês passado?

Detalhe os cliques do mês passado por país.

Principais páginas por impressões no mês passado no celular.

Como meus cliques e impressões do mês passado se comparam ao mês anterior?

Quais palavras-chave mais mudaram no mês passado em relação ao mês anterior?

Cliques semanais por página nas últimas 8 semanas, top 5 páginas.

Quais são minhas oportunidades de SEO de vitória mais rápida agora?

Quais palavras-chave não relacionadas à marca estão mais próximas da página 1 e quantos cliques poderíamos ganhar?

Qual é nossa posição média para palavras-chave de marca?

Participação de mercado e concorrentes

Como está minha participação de mercado no mês passado? Quem lidera e qual é a diferença?

Qual é minha participação de mercado não relacionada à marca vs. concorrentes no mês passado?

Top 5 intenções por cliques e participação de mercado no mês passado.

Compare minha participação de mercado contra <competitor A> e <competitor B> no mês passado.

Quais páginas tiveram os maiores ganhos de participação de mercado em relação ao mês anterior?

Quantos rich snippets temos vs. concorrentes?

Quem lidera na inclusão do Google AI Overviews neste mês?

Onde os concorrentes estão nos vencendo em palavras-chave?

Qual é nossa participação total na página de busca, orgânica mais paga?

Visibilidade em IA

Qual é nossa visibilidade em assistentes de IA como ChatGPT e Perplexity?

Nossa visibilidade em IA está subindo ou caindo nos últimos 3 meses?

Com que frequência fomos citados em plataformas de IA no mês passado?

Quais concorrentes nos lideram em visibilidade em IA?

Quais prompts citam mais nossas páginas nas respostas de IA?

Quais prompts de IA não nos citam de forma alguma?

Quais de nossas páginas as respostas de IA mais citam?

Busca paga

Quanto gastamos no Google Ads no mês passado e qual foi o custo por conversão?

Quanta das impressões pagas disponíveis estamos conquistando?

Estamos pagando por palavras-chave pelas quais já classificamos organicamente?

Web analytics e conversões

Como está o tráfego do meu site? Sessões, usuários e engajamento no mês passado.

Quantas conversões tivemos no mês passado, detalhadas por meta?

Onde os usuários desistem entre sessões, conversões e transações?

Nossa taxa de conversão realmente mudou em relação ao mês anterior, ou é apenas ruído?

Saúde do site (Core Web Vitals)

Algum problema de Core Web Vitals? Quais páginas são as mais fracas?

Compare nossos Core Web Vitals no celular vs. desktop.

Nossas páginas de maior tráfego têm LCP lento?

Rastreadores e estrutura do site

Rastreadores de IA como GPTBot e ClaudeBot estão alcançando nosso conteúdo?

Googlebots falsos estão atingindo nosso site?

Onde estamos desperdiçando orçamento de rastreamento?

Quais de nossas páginas estão bloqueadas de indexação e por quê?

Encontre páginas no nosso site para as quais nenhum link interno aponta.

Verificações cruzadas e auxiliares

Nossos cliques caíram 20% no mês passado. Isso é real ou ruído?

Páginas com Core Web Vitals piores recebem menos cliques?

Quais fontes de dados estão conectadas ao meu site e qual é a atualização de cada uma?

Visualize meu dashboard mais usado.

Continue explorando

Onde um card mostrar "Abrir no Quattr", clique nele. O app do Quattr abre na página correspondente com o mesmo segmento, filtros e janela de datas já aplicados.

Solução de problemas, segurança e FAQ

A maioria dos problemas se resolve com uma de três ações: reconectar o conector, iniciar uma nova conversa ou entrar no app do Quattr uma vez. Detalhes abaixo.

Problemas de conexão e login

O que você vê	O que significa	Correção
"Nenhuma conta Quattr/Looker para <email>" no login	Seu e-mail nunca entrou no app do Quattr, então não existe conta para vincular.	Entre em www.quattr.com uma vez com o mesmo e-mail e tente o login do conector novamente.
Loops de login ou "não autorizado" após funcionar antes	Seu token expirou ou foi revogado.	Desconecte e reconecte o conector; no Claude Code, execute /mcp e reautentique. No Cursor, "Clear All MCP Tokens" no Command Palette também ajuda.
"Este cliente não é permitido" durante a autorização	Seu cliente de IA não está na lista de clientes aprovados do Quattr.	Use um cliente aprovado (Claude, Claude Code, ChatGPT, Cursor, VS Code) ou peça ao Quattr para aprovar seu cliente. Detalhes →
"Sessão desconhecida ou encerrada"	Sua sessão expirou (7 dias inativa) ou o servidor foi atualizado.	Nada a fazer; o cliente reinicializa automaticamente. Se persistir, inicie uma nova conversa.
"Locatário alterado desde a inicialização da sessão"	Sua conta Quattr mudou para um cliente diferente no meio da conversa.	Inicie uma nova conversa (ou reconecte). As conversas ficam vinculadas ao cliente com o qual começaram.
"Muitas solicitações; tente novamente em N segundos"	Você atingiu o limite de 60 solicitações/minuto por usuário.	Aguarde alguns segundos. Divida solicitações grandes em perguntas menores.
"Orçamento esgotado; redefine à meia-noite UTC"	Sua conta usou o orçamento diário de análise.	Retome após o reset UTC ou contate o Quattr se sua equipe precisar regularmente de mais.
"Sobrecarregado" / 503s breves	Proteção momentânea de capacidade (consultas simultâneas ou deploy em andamento).	Tente novamente em alguns segundos; o assistente geralmente faz isso sozinho.
Ferramentas ausentes logo após um lançamento do Quattr	O cliente armazenou em cache uma lista de ferramentas antiga.	Atualize/reconecte o conector e inicie uma nova conversa.
Resultados aparecem como texto simples, sem card visual	Seu cliente não renderiza cards MCP interativos (ex.: Claude Code), ou o host pulou o visual.	Esperado. Os números são idênticos. Use links do tipo "Abrir no Quattr" quando oferecidos.

Autoteste rápido

Pergunte "Quais fontes de dados estão conectadas ao meu site e qual é a atualização de cada uma?". Se responder com as fontes do seu site, sua conexão, login e escopo da empresa estão funcionando.

Entendendo seus números

Os números não correspondem ao que vejo no app do Quattr

Verifique primeiro a faixa de escopo do card: intervalo de datas, segmento, orgânico vs. pago, filtro de marca, dispositivo. As causas mais comuns: janela de datas diferente (os intervalos incluem ambos os extremos; as semanas vão de domingo a sábado), um segmento diferente (o padrão "Mercado Geral" cobre todo o seu domínio; um segmento rastreado cobre apenas suas palavras-chave) ou comparar um número apenas orgânico com um combinado. Os cards trazem um link "Abrir no Quattr" que abre o app com o mesmo escopo aplicado; use-o para comparar maçãs com maçãs.

Por que minha participação de mercado é um número tão pequeno?

Os valores de participação de mercado já são porcentagens em uma escala de 0–100: 0.03 significa 0,03%, não 3%. Os deltas estão em pontos percentuais. Participações, taxas e rankings nunca são somados em totais; isso seria estatisticamente sem sentido, e as ferramentas se recusam a fazer isso.

Por que os dados parecem estar um ou dois dias atrasados?

As fontes carregam em cadências diferentes: o Search Console tem atraso de 1–2 dias, o web analytics carrega à noite, participação de mercado / visibilidade em IA / Google Ads aproximadamente diariamente, e o Core Web Vitals normalmente atualiza a cada duas semanas. O rodapé de cada card mostra uma data "até". Pergunte "Qual é a atualização dos meus dados?" para ver a imagem ao vivo por fonte.

Por que o assistente recusou parte da minha pergunta? Por design, o MCP Quattr recusa em vez de aproximar. Por exemplo, ações, taxas e classificações nunca são somadas em totais; uma solicitação assim recebe uma recusa clara em vez de um número enganoso. A mensagem de recusa nomeia o que é suportado; geralmente, uma pequena reformulação resolve.

O que significa o selo "observacional"?

Os dados mostram o que aconteceu, não o que causou. Uma correlação entre, digamos, páginas lentas e menos cliques é uma pista que vale investigar, não uma prova. As ferramentas de significância ("isso é real ou ruído?") informam se uma mudança é estatisticamente relevante, o que ainda não é o mesmo que saber sua causa.

Diz que uma fonte de dados "não está disponível". Isso é um bug?

Não. A disponibilidade das ferramentas segue sua assinatura Quattr e os feeds conectados (ex.: Google Ads, rastreamento do site, BigQuery). O honesto "não disponível" evita números errados. Se você acredita que deveria ter essa fonte, entre em contato com seu gerente de sucesso do cliente Quattr.

Segurança e privacidade

Login e tokens

Fluxo de código de autorização OAuth 2.1 com PKCE. Nenhuma chave de API ou senha entra no cliente de IA. Os tokens de acesso são de curta duração e assinados criptograficamente; os tokens de atualização são rotacionados a cada uso e podem ser revogados.

Herança de permissões

O MCP herda as permissões Quattr do usuário que faz login, então você só pode ler dados aos quais sua conta já tem acesso. Conectar não concede acesso adicional.

Isolamento de locatário

Sua identidade é mapeada para sua conta Quattr, e cada consulta é executada dentro do escopo de dados da sua organização, aplicado na camada de dados. Uma conversa está vinculada a exatamente um cliente, e cada resultado é rotulado com seu company_name.

Somente leitura

A conexão é limitada a quattr:read. Nada que o assistente faça por meio do MCP pode modificar sua configuração ou dados Quattr.

Somente clientes aprovados

Somente clientes de IA explicitamente aprovados pela Quattr podem concluir o login; clientes desconhecidos são rejeitados antes de qualquer acesso a dados.

Trilha de auditoria

As chamadas de ferramentas são registradas em log no servidor e enviadas para armazenamento durável, para que o uso seja rastreável por usuário e organização.

Processamento de IA

O assistente de IA que você conecta (Claude, ChatGPT, etc.) processa os resultados das consultas para escrever suas respostas, sob os termos desse provedor. Revise as políticas da sua organização sobre análise de dados com IA e quaisquer requisitos de conformidade (ex.: GDPR, LGPD) antes de uma implantação ampla.

Respostas geradas por IA

A Quattr fornece os dados; a narrativa em torno deles é gerada pelo seu assistente de IA, que pode cometer erros. Verifique números importantes por meio de "Abrir no Quattr" antes de agir com base neles.

FAQ geral

Preciso saber nomes de ferramentas ou escrever SQL?

Não. Faça perguntas em linguagem simples; o assistente descobre e chama as ferramentas certas. A referência de ferramentas existe para você saber o que é possível, não porque você precisa dela.

Quais clientes de IA são suportados?

Claude (claude.ai web e desktop), Claude Code, ChatGPT (modo desenvolvedor), Cursor e VS Code. Outros clientes MCP podem ser aprovados mediante solicitação; veja Conectar e Configurações.

Meus colegas de equipe podem usar?

Sim. Qualquer pessoa com uma conta Quattr para sua organização pode conectar com o próprio e-mail. O acesso é por usuário; não há chaves compartilhadas.

Trabalho com vários clientes Quattr. Como alterno?

Alterne os clientes no aplicativo Quattr como de costume e depois inicie uma nova conversa (ou reconecte o conector). As conversas existentes permanecem vinculadas ao cliente com o qual começaram, e o company_name de cada resultado informa em qual você está olhando.

Como reporto uma resposta errada ou confusa?

Use "Abrir no Quattr" para comparar o cartão com a visualização do aplicativo, anote a pergunta que você fez e a faixa de escopo do cartão, e compartilhe ambos com seu contato de sucesso do cliente Quattr. Essa informação de escopo é exatamente o que a equipe precisa para reproduzir o problema.

O MCP funciona com dados do Search Console no nível do BigQuery?

Se sua conta tiver o feed do BigQuery, diga isso explicitamente, ex.: "usando a fonte BigQuery, principais consultas por cliques…". Ele retorna dados por consulta muito mais granulares (consultas suprimidas por privacidade aparecem como "[anonimizado pelo google]"). Sem a permissão, você receberá um honesto "não habilitado".

Ainda com problemas?

Verifique sua configuração em Conectar e Configurações, execute o autoteste rápido acima e entre em contato com seu gerente de sucesso do cliente Quattr com o texto exato do erro e o nome/versão do seu cliente de IA.