Airefs

Peça ao Claude para ver como sua taxa de menções mudou no último mês, quais concorrentes apareceram em respostas em que sua marca não estava, quais fontes continuam sendo citadas na sua categoria e quais discussões valem a pena participar esta semana. As respostas vêm da sua própria conta Airefs, e não da memória geral do modelo sobre a internet, e você as obtém sem abrir o painel ou exportar nada.

O servidor MCP da Airefs é o que conecta os dois lados. O Model Context Protocol (MCP) é um padrão compartilhado para conectar aplicativos de IA a serviços externos, da mesma forma que USB-C é um formato de plugue que serve em vários dispositivos. Você adiciona uma URL ao seu assistente, faz login uma vez, e ele pode ler seus dados da Airefs a partir daí.

O que ele cobre

Seu assistente pode ler a taxa de menções, a taxa de citações e a posição média de menções ao longo do tempo, divididas por prompt, por concorrente e por fonte de resposta. Toda a camada de Sources vem junto: os domínios e URLs que acumulam citações e as respostas exatas de IA por trás de cada uma. Se um número está na sua visão geral, uma ferramenta consegue acessá-lo.

As oportunidades para mover esses números também são cobertas. Recomendações de artigos chegam com o backlog e o pipeline que alimentam, discussions cobre os tópicos que as respostas de IA já estão citando, e backlinks é a lista de divulgação mais a evidência de citação por trás de cada domínio.

Duas coisas que o servidor não expõe: Impressions, as visitas que os rastreadores de IA fazem às suas páginas, e Clicks, os visitantes que chegam a partir de uma resposta de IA. Ambos ficam no painel.

Conectar

A URL do servidor é https://mcp.getairefs.com/mcp. É a única coisa que você precisa copiar.

Adicione-a no seu cliente e faça login com sua conta Airefs na aba do navegador que abrir. Não há chave de API para copiar em lugar nenhum: o login entrega ao seu cliente tokens de curta duração, que ele armazena e que você pode revogar. Depois do login, a conexão lê o que sua conta pode ler: os dados dos seus sites mais o básico do seu perfil. Nada além disso.

Funciona igual no Claude na web e no Claude Desktop.

1. Abra Settings → Connectors.
2. Clique em + e depois em Add custom connector.
3. Dê o nome de Airefs e cole https://mcp.getairefs.com/mcp como URL do servidor MCP remoto.
4. Clique em Add e depois em Connect.
5. Faça login com sua conta Airefs na janela que abrir e aprove o acesso.
6. Inicie um chat e mencione Airefs na sua pergunta. Se as ferramentas não aparecerem, abra o menu de ferramentas na caixa de chat e ative o conector da Airefs.

Conectores personalizados funcionam em todos os planos do Claude, mas uma conta gratuita só pode manter um por vez, então remova outro antes de adicionar a Airefs. Nos planos Team e Enterprise, apenas um proprietário pode adicionar o conector para a organização, em Organization settings → Connectors; os membros então se conectam individualmente.

Servidores MCP personalizados ficam atrás do modo de desenvolvedor do ChatGPT, que roda apenas no aplicativo web e cobre Pro, Business, Enterprise e Edu. O plano Plus não suporta servidores MCP personalizados. Contas Pro são limitadas a servidores com ferramentas de leitura e busca, que é tudo o que a Airefs tem.

No Pro, você adiciona por conta própria:

1. Abra Settings → Apps → Advanced settings e ative o Developer mode.
2. Volte para Apps e clique em Create.
3. Dê o nome de Airefs, cole https://mcp.getairefs.com/mcp incluindo o caminho /mcp e escolha OAuth como método de autenticação.
4. Clique em Scan Tools, faça login com sua conta Airefs na janela que abrir e clique em Create.
5. Inicie um novo chat e escolha Airefs no menu de ferramentas.

No Business, apenas administradores e proprietários podem usar o modo de desenvolvedor, e cada um o ativa para a própria conta. Um administrador cria o aplicativo em Workspace settings → Apps → Create e depois o publica em Drafts; membros comuns não têm a opção de modo de desenvolvedor e recebem a Airefs quando ela é publicada. No Enterprise e no Edu, um administrador concede acesso de desenvolvedor primeiro, em Permissions & Roles → Connected Data, e depois os membros autorizados ativam o modo de desenvolvedor nas próprias configurações, mas apenas administradores e proprietários podem publicar para o workspace.

Registre o servidor uma vez a partir do seu terminal.

claude mcp add --transport http airefs https://mcp.getairefs.com/mcp

1. Execute /mcp dentro do Claude Code e escolha Authenticate para airefs. Uma janela do navegador abre para o login.
2. Execute claude mcp list para confirmar que o servidor está conectado.

Para compartilhar o servidor com todos que trabalham em um repositório, adicione a flag de escopo entre o nome do servidor e a URL:

claude mcp add --transport http airefs --scope project https://mcp.getairefs.com/mcp

Cada pessoa ainda faz login com a própria conta Airefs.

Adicione o servidor ao .cursor/mcp.json no seu projeto, ou ao ~/.cursor/mcp.json para usá-lo em todos os lugares.

{
  "mcpServers": {
    "airefs": {
      "url": "https://mcp.getairefs.com/mcp"
    }
  }
}

1. Salve o arquivo e abra Cursor Settings → MCP.
2. Clique em Login ao lado do servidor Airefs e faça login com sua conta Airefs.
3. Pergunte sobre seus dados da Airefs no painel de chat assim que o servidor aparecer como conectado.

Adicione o servidor ao .vscode/mcp.json no seu workspace.

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

1. Salve o arquivo e clique em Start acima da entrada do servidor.
2. Faça login com sua conta Airefs na janela do navegador que abrir.
3. Abra o Copilot Chat no modo agente e escolha as ferramentas da Airefs no seletor de ferramentas.

Faça commit do arquivo para que todo o time adote o servidor. O login continua sendo individual, então ninguém herda o acesso de outra pessoa.

Qualquer cliente que fale streamable HTTP e suporte OAuth pode usar o servidor diretamente. Dê a ele a URL https://mcp.getairefs.com/mcp e complete o login no navegador quando o cliente pedir. Não há mais nada para configurar.

Para clientes que só executam servidores locais, faça a ponte da conexão com mcp-remote, que precisa do Node.js instalado:

{
  "mcpServers": {
    "airefs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.getairefs.com/mcp"]
    }
  }
}

Na primeira execução, o mcp-remote abre uma janela do navegador para login e lembra do resultado, então execuções posteriores começam sem pedir nada.

O que seu assistente pode ver e fazer

Toda ferramenta no servidor MCP da Airefs é somente leitura, sem exceção. Um assistente pode ler seus dados da Airefs e nunca pode mudar nada na sua conta. Ele não pode adicionar ou remover prompts, dispensar uma oportunidade, agendar um artigo, editar sua lista de concorrentes ou mexer em cobrança. Então o pior que uma pergunta ruim pode fazer é ler algo que você preferia não ter compartilhado, porque tudo o que uma ferramenta retorna vai para o provedor do seu assistente e fica sujeito aos termos desse provedor.

O login acontece via OAuth no seu navegador, usando a conta Airefs que você já tem. Você nunca lida com uma chave de longa duração. O cliente armazena os tokens que recebe, mas eles são de curta duração e você pode revogá-los na Airefs quando quiser.

O que a conexão alcança é o que sua conta alcança. Isso começa com o básico do seu perfil: nome, endereço de e-mail e associações de organização. Cobre a análise de visibilidade dos seus sites e prompts, e os textos de respostas de IA armazenados por trás deles.

Também inclui listas de concorrentes e fontes, e recomendações de artigos e backlinks. Qualquer contexto de marca, público ou escrita que você tenha configurado também é legível.

Se você pertence a uma organização, isso significa os sites da organização; se você tem um site, significa um site. Conectar um cliente não amplia seu próprio acesso e não expõe os sites de outras pessoas para você. A política de privacidade diz o mesmo com outras palavras.

Para cortar o acesso de um cliente, revogue-o na Airefs. Abra Settings → Account, encontre o cartão do servidor MCP da Airefs e clique em Disconnect ao lado do cliente em Connected clients. Isso exclui os tokens dele, então ele não pode pedir novos, e o servidor para de responder em menos de um minuto.

Depois, organize o lado do cliente para a entrada morta parar de aparecer:

• Claude: Settings → Connectors e remova o conector da Airefs.
• Claude Code: claude mcp remove airefs.
• Cursor e VS Code: exclua a entrada airefs de mcp.json.

Fazer apenas esse segundo passo não é suficiente. Ele impede que aquela cópia daquele cliente faça perguntas, mas o acesso concedido continua ativo até você revogá-lo.

Planos e limites

O acesso via MCP está incluído no teste gratuito, então você pode conectar um cliente antes de pagar por qualquer coisa. Contas de teste têm limites de taxa mais rígidos que contas pagas, o que importa principalmente para análises longas que percorrem muitas linhas.

Alguns dados seguem seu plano da mesma forma que no aplicativo. O Google AI Overview está disponível como fonte de resposta quando seu site o tem habilitado, e o histórico de análise vai até onde seu plano permite. Quando uma pergunta fica fora do que seu plano cobre, a ferramenta retorna um erro claro dizendo isso, em vez de responder silenciosamente com menos.

Receitas

O servidor vem com seis prompts prontos. No Claude, eles ficam no menu de adição ao lado da caixa de mensagem quando o conector da Airefs está ativo. Escolha um e o assistente executa um procedimento completo com seus dados, em vez de uma única consulta.

Os dois campos que um prompt pede são opcionais. Deixe o campo de site vazio se sua conta tem um site, ou digite o domínio para escolher. O campo de foco restringe a execução com suas próprias palavras: “últimos 14 dias”, “somente Google AI Overview”, “apenas a tag de preço”. Sem foco, os prompts usam o ChatGPT como fonte de resposta e uma janela recente.

Clientes que não exibem prompts MCP ainda podem pedir a mesma análise. Cada prompt abaixo termina com uma versão em linguagem simples para colar em um chat.

Pulso semanal

airefs_weekly_pulse compara esta semana com a anterior: como sua taxa de menções e taxa de citações mudaram, onde você está em relação aos concorrentes monitorados agora, quais domínios estão acumulando mais citações e quais recomendações de artigos estão ativas. Ele funciona como um resumo de segunda-feira de manhã que você pode colar em um canal de equipe. Quando uma semana não tem dados concluídos, ele diz isso em vez de reportar zero.

“Use a Airefs para me dar um pulso semanal de acme.com: como minha taxa de menções e taxa de citações mudaram em relação à semana passada, quais domínios de fonte são mais citados e quais recomendações de artigos estão ativas?”

Radar de concorrentes

airefs_competitor_radar verifica cada concorrente monitorado ativo para movimentação real na taxa de menções ou taxa de citações entre dois períodos consecutivos, depois separa os que mudaram dos que ficaram estáveis e coloca o ranking atual embaixo. Execute mensalmente, ou na semana seguinte a perceber que um concorrente lançou algo. A movimentação volta em pontos percentuais e nunca afirma saber a causa.

“Use a Airefs para comparar cada concorrente monitorado de acme.com neste mês contra o mês passado e sinalize qualquer um cuja taxa de menções ou taxa de citações mudou em cinco pontos ou mais.”

Investigação de queda de visibilidade

airefs_visibility_drop_investigation decompõe um declínio: a mudança na taxa em si, os prompts que mais pioraram com as respostas por trás deles, quais concorrentes foram na direção oposta e como os domínios de fonte citados mudaram. As explicações voltam organizadas em suportadas, possíveis e não testáveis, para você distinguir evidência de palpite. É o prompt para usar no dia em que alguém perguntar por que o número caiu.

“Use a Airefs para investigar por que a taxa de menções de acme.com caiu nas últimas duas semanas: quais prompts perderam menções, quais concorrentes ganharam e o que mudou nas fontes citadas?”

Revisão de autoridade de fontes

airefs_source_authority_review mapeia as fontes por trás das suas respostas. Ele agrupa os domínios e páginas citados entre os seus, os dos seus concorrentes monitorados e os de terceiros, e mostra quais domínios estão ganhando citações e quais apareceram pela primeira vez. Autoridade aqui significa com que frequência e amplitude algo é citado; a Airefs não tem pontuação de qualidade de terceiros e o prompt não vai inventar uma. Vale rodar antes de decidir onde propor um guest post ou quais publicações buscar.

“Use a Airefs para revisar os domínios de fonte citados para acme.com, divida-os entre meus, dos concorrentes e de terceiros, e mostre quais estão ganhando citações.”

Lacunas de visibilidade

airefs_visibility_gaps lista os prompts onde sua marca nunca ou raramente é mencionada em um período recente de execuções, agrupados por país e tag. Seu contexto de marca faz a classificação: prompts fora do que você vende caem em erros esperados, todo o resto cai na lista que vale a pena corrigir, e recomendações de artigos ativas são combinadas com as lacunas que elas abordam. Execute quando estiver planejando o próximo trimestre de conteúdo.

“Use Airefs para listar os prompts onde acme.com nunca ou raramente é mencionado, agrupe-os por tag e me diga quais recomendações de artigos ativas os abordam.”

Plano de ação

airefs_action_plan é o prompt de “o que eu faço sobre isso”. Ele reúne visibilidade atual, prompts de lacuna, recomendações de artigos em relação ao pipeline de conteúdo, discussões citadas junto com threads do Reddit monitoradas e oportunidades de backlink em uma lista priorizada construída em torno de três ações: publicar os artigos apoiados por recomendações, participar das discussões já citadas e ganhar citações nos domínios em que essas respostas já confiam. Comece um sprint com ele e trabalhe a lista.

“Use Airefs para criar um plano de ação para acme.com: o que devo publicar, quais discussões devo participar e quais domínios devo buscar para backlinks?”

Perguntas mais longas para colar

Os prompts acima cobrem os trabalhos usuais. Quando você quiser conduzir a análise você mesmo, ou seu cliente não tiver nenhum menu de prompts, cole um destes e substitua pelo seu próprio domínio.

Investigar uma queda de visibilidade

Uma queda merece evidências antes de virar uma história, então isso pede a decomposição primeiro.

Use Airefs for acme.com. Our mention rate is down and I have to explain it
tomorrow morning.

Compare the last 14 days with the 14 days before that on ChatGPT. Show me
the prompts that lost the most brand mentions, whether any tracked competitor
gained over the same period, and whether the domains cited for those prompts
changed.

Be clear about what the data supports and what it doesn't.

Encontrar discussões que valem a pena participar

Discussões que já aparecem como fontes citadas são as que as respostas de IA estão lendo. Pedir o prompt de citação junto com cada URL diz o que realmente escrever no tópico.

Use Airefs for acme.com. I have about an hour this week to reply in places
that AI answers actually cite.

List the discussion URLs that already show up as cited sources, and separately
the Reddit threads Airefs is monitoring. Drop anything where we're already
mentioned or that's marked done. For each one left, tell me which prompt it
was cited for so I know what angle to write from.

Criar uma lista curta de divulgação de backlinks

Oportunidades de backlink são os domínios de terceiros que suas respostas já citam, com seu próprio site e concorrentes rastreados filtrados. Puxar as páginas citadas na mesma pergunta economiza uma etapa de pesquisa antes de escrever.

Use Airefs for acme.com. I'm building an outreach list for next month.

Show me the backlink opportunities ranked by how often those domains are
cited, and leave out anything already marked emailed or dismissed. For the
top ten, list the pages of theirs that get cited so I can see what they
publish about before I write the email.

Preparar um relatório de concorrentes

Útil na semana anterior a uma revisão de marketing. A última linha importa: sem ela, os assistentes tendem a narrar razões que os dados não suportam.

Use Airefs for acme.com. I need a one-page competitor read for our monthly
marketing review.

For each tracked competitor: current mention rate and citation rate, the
change since the previous month, and where we sit in that ranking. Then show
which of their pages are cited in the answers we track.

Keep it factual. No theories about why anything moved.

Primeiras perguntas para experimentar

Três perguntas curtas, para quando você acabou de conectar um cliente e quer ver algo voltar:

• “Use Airefs para resumir minha visibilidade atual de IA e compará-la com concorrentes ativos.”
• “Quais prompts raramente mencionam minha marca e quais recomendações de artigos devo publicar?”
• “Mostre-me as discussões citadas e os domínios de backlink onde minha marca tem a oportunidade mais clara.”

Solução de problemas

Meu assistente não consegue encontrar meu site

Peça para listar os sites do Airefs aos quais você tem acesso. Ele nomeará cada um exatamente como o Airefs o armazena, que geralmente é o domínio. Use esse nome, ou o domínio sozinho, na sua próxima pergunta. Se o seu site não estiver na lista, a conta do Airefs com a qual você entrou não tem acesso a ele. Verifique se você entrou com a conta correta e peça a um administrador da sua equipe para adicioná-lo ao site se você pertencer a uma organização.

Uma pergunta sobre dados do Google AI Overview retornou um erro

O Google AI Overview é uma fonte de respostas separada e é habilitado por site. Quando está desligado, as ferramentas dizem isso em vez de misturar números do ChatGPT. Faça a mesma pergunta sobre o ChatGPT ou consulte Planos e preços para habilitar a fonte de respostas.

Uma solicitação de um longo período de histórico pode falhar da mesma forma, porque a profundidade do histórico de análises segue o seu plano. Peça uma janela mais curta e a mesma pergunta funciona.

A conexão expirou e preciso entrar novamente

O login não dura para sempre. Quando seu assistente relatar que não está autorizado, reconecte-se pelo cliente: no Claude, abra Configurações → Conectores e clique em Conectar no conector do Airefs; no Claude Code, execute /mcp e autentique novamente; no Cursor e no VS Code, use o prompt de login na entrada do servidor. Nada precisa ser redefinido no lado do Airefs.

Meu assistente diz que está com limite de taxa

O servidor limita a velocidade com que uma conta pode chamá-lo. O erro traz um tempo de espera sugerido, e tentar novamente após essa espera geralmente funciona. Perguntas amplas atingem o limite mais cedo porque percorrem mais dados, então restrinja a pergunta: um site, uma fonte de respostas, um intervalo de datas mais curto. Contas de teste têm limites mais rígidos do que as pagas.

Não consigo adicionar o conector no Claude

No plano gratuito do Claude, você pode manter um conector personalizado por vez, então remova o que você tem antes de adicionar o Airefs. Nos planos Team e Enterprise, um proprietário ou proprietário principal precisa adicionar o conector para a organização primeiro; até então, os membros não o verão como uma opção. O Claude se conecta pela nuvem da Anthropic, então o servidor precisa estar acessível pela internet pública, o que https://mcp.getairefs.com/mcp é.

O assistente responde sem usar o Airefs

A maioria dos clientes só usa uma ferramenta quando a pergunta torna isso óbvio. Diga “use Airefs” na pergunta, ou nomeie o que você quer pelo termo do Airefs: taxa de menção, prompts, fontes de respostas, concorrentes, discussões. Verifique também o menu de ferramentas no seu cliente, pois alguns clientes deixam um servidor recém-adicionado desligado em conversas existentes.

Os números não correspondem ao painel

Verifique primeiro a janela de datas e a fonte de respostas. Uma janela diferente ou uma fonte diferente legitima um número diferente, e ambos os lados podem estar certos. Vale a pena verificar também a granularidade: get_visibility_timeseries em granularidade semanal conta um prompt como mencionado se qualquer execução naquela semana mencionou você, o que não é a mesma aritmética de uma taxa por lote.

Se tudo isso se alinhar e a lacuna ainda existir, pergunte ao assistente qual ferramenta ele chamou e quais parâmetros usou. Um assistente que não consegue dizer está adivinhando em vez de lendo.

Quer saber exatamente o que um assistente pode acessar antes de conectar? A referência de ferramentas lista todas as ferramentas no servidor, o que elas retornam e seus principais parâmetros.