BRONTIR Research

Servidor MCP remoto para pesquisa na web em buscas, Reddit, YouTube, empresas locais, avaliações, bibliotecas de anúncios e mais, com citações numeradas por linha.

Servidor MCP hospedado

npx add-mcp 'https://research.brontir.com/api/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Transforme toda a web pública em uma base de conhecimento estruturada, citável e sempre atualizada para seus agentes de IA.

BRONTIR é um backend de pesquisa que se conecta ao seu assistente de IA via MCP e oferece o que a busca web comum não consegue: acesso profundo ao conteúdo real de sites ao vivo, extração com compreensão de significado e uma memória durável que ele pode pesquisar e citar. Enquanto ferramentas integradas retornam trechos que desaparecem após uma interação, o BRONTIR constrói um corpus permanente ao qual você pode voltar, pesquisar internamente e citar até a linha exata.


O que ele pode fazer

Acessar qualquer página pública

Forneça qualquer link público e receba conteúdo limpo e legível. Artigos de notícias, blogs, documentação, sites de empresas, páginas de destino — qualquer URL pública HTTP(S) é aceita e transformada em texto estruturado pronto para análise.

Extração profunda e específica por plataforma

Para as plataformas mais populares, ele usa extração especializada que entende a estrutura de cada plataforma, não um despejo genérico de página:

  • Vídeo — transcrições e metadados (YouTube e outros), para que seu agente possa analisar um vídeo sem assisti-lo.
  • Redes sociais — posts, comentários e metadados de Reddit, X/Twitter, Facebook, Instagram, TikTok, LinkedIn, Threads, Bluesky, Pinterest, Twitch, Snapchat e Truth Social.
  • Locais — a partir de um link de mapa: o cartão completo do local — endereço, categoria, detalhamento de avaliações, horário de funcionamento, horários de maior movimento, faixa de preço, serviços, atributos e categorias de fotos — junto com as avaliações dos clientes, as respostas do proprietário a elas e os temas que se repetem entre elas. Se solicitado, as atualizações que a empresa publica em seu próprio perfil — anúncios, ofertas, novidades — também retornam; elas ficam desativadas a menos que sejam solicitadas, e muitos locais não publicaram nenhuma.
  • Avaliações — a partir de uma página de empresa no Trustpilot ou de uma listagem no Tripadvisor: o resumo com a pontuação geral, o detalhamento por estrelas quando o site mantém um, e as próprias avaliações com as respostas da empresa. Diga em linguagem simples quantas coletar e quais — as mais recentes ou as de uma classificação específica por estrelas.
  • Lojas de aplicativos — a partir de um link do Google Play ou da App Store: a listagem da loja — editor, categoria, preço, versão atual, data de atualização — junto com as avaliações dos usuários. Cada país tem sua própria loja, e o link decide qual delas é lida.
  • Produtos — a partir de um link da Amazon, Walmart ou Google Shopping: a listagem completa — título, preço e eventuais descontos, disponibilidade, quem vende e quem entrega, a descrição do vendedor, a tabela de especificações, os outros tamanhos, cores e estilos do mesmo produto — junto com os outros vendedores que o oferecem e quanto cada um cobra, e as avaliações que a própria página carrega. Uma loja nacional por link, e seus preços, disponibilidade e idioma são os daquele país. Duas coisas que vale saber: a Amazon exibe sua lista completa de avaliações apenas para visitantes logados, então o que retorna é o punhado que a loja escolheu mostrar, em vez de uma amostra representativa da opinião dos compradores; e uma listagem do Google Shopping só abre enquanto ainda estiver na primeira página daquele site para os mesmos termos — quando sai de lá, é reportada como indisponível, em vez de adivinhada.
  • Imóveis — a partir de um link do Zillow: um imóvel como o site o apresenta — o preço pedido ou de aluguel, ou o último valor de venda, junto com a estimativa do próprio site sobre seu valor e aluguel; quartos, banheiros, área construída, tamanho do terreno, tipo de imóvel e ano de construção; o endereço completo, o valor avaliado para impostos e a alíquota do IPTU, as taxas mensais de condomínio, há quanto tempo está listado e quem está anunciando. Quando a listagem publica, o registro também traz a descrição escrita do vendedor, a especificação de características e construção, o histórico de preços evento por evento, anos de histórico fiscal e as escolas designadas com suas notas e distâncias. Imóveis à venda, para alugar, vendidos recentemente e fora do mercado, nos Estados Unidos e no Canadá, na moeda da listagem. Um imóvel por link: listagens de uma cidade, uma página de busca, uma comunidade de aluguel ou o perfil de um corretor tratam de algo que não é um único imóvel e são lidos como uma página web comum.
  • Hotéis — a partir de um link de propriedade no Google Hotels: endereço e telefone, classificação por estrelas, avaliação dos hóspedes com o detalhamento completo estrela por estrela, comodidades, tipos de quarto que um anunciante lista, todos os sites de reserva que citam o hotel com a tarifa diária e total de cada um, os tópicos que os avaliadores mencionam e os pontos de referência próximos. As tarifas pertencem a um conjunto específico de noites, que a resposta informa — todo o resto do cartão é o mesmo, independentemente das noites precificadas. Sem texto de avaliações e sem fotografias.
  • Mercados — a partir de um link do Google Finance: o preço cotado e os números reportados pela própria empresa — receita, despesa operacional, lucro líquido, margens, lucro por ação, EBITDA, ativos, passivos, patrimônio líquido, fluxo de caixa e mais — cada um comparado ao mesmo período do ano anterior, ao longo de trimestres e anos fiscais recentes, na moeda em que a empresa reporta e em seus próprios períodos fiscais. O símbolo é a única forma de acesso: não há busca por nome da empresa, e o cartão não traz histórico de preços, notícias, estimativas de analistas ou dividendos.
  • Patentes — a partir de um link do Google Patents: o documento inteiro — cada reivindicação palavra por palavra, a descrição técnica, as datas de prioridade, depósito e publicação, o status legal atual e o vencimento ajustado, os códigos de classificação, a família com o status de cada depósito nacional e o estado da técnica citado, junto com os documentos posteriores que a citam. O que retorna varia por escritório, e o documento informa quais partes estão ausentes. O número de publicação é a única forma de acesso; não há opiniões jurídicas, termos de licenciamento ou registros de litígio aqui.
  • Perfis de pesquisadores — a partir de um link de autor no Google Scholar: nome, afiliação e interesses declarados, total de citações, índice h e índice i10 tanto no total geral quanto em uma janela recente, as citações recebidas em cada ano registrado e até duzentos trabalhos com suas próprias contagens de citações — além de coautores, cada um com link para seu próprio perfil. Sem resumos e sem texto completo: siga o link de um trabalho para lê-lo.
  • Anúncios — a partir de um link para um único anúncio na biblioteca de anúncios do Facebook, TikTok, LinkedIn ou Google: o texto de cada versão daquele anúncio, os países em que foi veiculado com as datas de início e fim de cada país, a página para onde ele direciona as pessoas e a conta que o publicou — onde quer que a plataforma os publique. Se solicitado, o criativo também é descrito em palavras: o que a imagem mostra, suas cores e o texto sobreposto a ela. Endereços de imagens e vídeos nessas plataformas expiram, então cada um é carimbado com o momento em que deixa de abrir.
  • Documentos — texto extraído de PDFs por link direto.
  • Imagens — imagens são descritas em texto, para que o conteúdo visual se torne pesquisável, citável e analisável. Funciona tanto para imagens dentro de posts quanto para um link direto para uma imagem.

Buscar e descobrir

Não tem URLs exatas? Faça uma busca e deixe a plataforma encontrar as fontes para você:

  • Web — resultados orgânicos com consultas relacionadas, de dois índices independentes em vez de um. Execute a mesma pergunta em ambos e cerca de três quartos do que o segundo retorna não está no primeiro: ele tende a sites especializados independentes, enquanto o primeiro tende às grandes plataformas de discussão, então vale a pena executá-los juntos em vez de um no lugar do outro.
  • Menções na web — onde uma frase aparece na web, uma página por site: o trecho em que está inserida, a data que a página carrega quando tem uma, quanto da web aponta para o site e, quando o trecho é longo o suficiente para ler, como um leitor automático avaliou sua redação. Ele lê um índice permanente de texto de páginas em vez de um mecanismo de busca, então alcança milhões de páginas de profundidade em vez de parar na primeira página de resultados. É mais forte em assuntos e termos: ao buscar um nome de marca puro, mostra onde essas palavras aparecem, o que é em grande parte catálogos e lojas. Cada resultado é um site diferente, incluindo o do próprio assunto, e a frase é mantida exatamente como fornecida. Pode ser restringido a um tipo de página — notícias, blogs, fóruns, lojas, organizações — ou a páginas cujo próprio título contenha a frase.
  • Notícias — o que está sendo publicado sobre um assunto agora: até cem artigos de uma única consulta, cada um com seu editor, o horário exato de publicação e um link para a página do próprio editor, em vez de um agregador. Apenas manchetes — abra um artigo para ler o conteúdo.
  • Pesquisa e patentes — artigos acadêmicos, preprints e teses com quantas vezes cada um foi citado e, para qualquer um deles, o que o cita e quais outras versões existem. Patentes e pedidos ao lado, filtrados por titular, inventor, data de depósito, escritório ou status legal, cada um com os escritórios onde está em vigor. Nenhum contém texto completo: abra um resultado para ler o artigo ou a patente em si.
  • Produtos e preços — o que uma busca traz em uma loja: o produto, seu preço, sua classificação por estrelas e os selos que a loja coloca nele. A Amazon lê uma loja nacional por vez — vinte e duas, cada uma com seu próprio catálogo, moeda e idioma; o Walmart é a loja dos Estados Unidos; o Google Shopping cobre a vitrine de um país e as lojas que indexa, então preços de dois deles não são comparáveis, e algumas vitrines publicam classificações sem a parte decimal, o que os resultados mostram como um piso e dizem que fizeram isso. Um resultado é uma listagem, não a página do produto, então não traz descrição, vendedor ou texto de avaliação — abra a listagem para isso — e o Walmart responde intermitentemente com todos os preços ausentes, o que os resultados dizem claramente em vez de deixar parecer que é gratuito.
  • Hospedagens e voos — os hotéis e aluguéis de temporada listados para um lugar, com preço por noite e total, classe por estrelas, avaliação dos hóspedes e os tópicos que os avaliadores mencionam; e os voos em uma rota em um dia, com companhia aérea e número do voo, ambos os aeroportos e seus horários, paradas, aeronave, cabine e preço, além do que a rota normalmente custa. Cada preço pertence a noites específicas ou a um único dia de partida, em vez da propriedade ou da rota em geral: nomeie as datas, ou uma estadia de exemplo e uma partida no meio da semana com cerca de um mês de antecedência são precificadas e relatadas com os resultados. As tarifas são somente de ida, então são preços de saída; os voos são pesquisados por aeroporto, e uma cidade é lida como os aeroportos que a atendem, o que os resultados nomeiam. Um hotel pode ser aberto para seu cartão completo; um voo não — ele não tem página em lugar nenhum, então tudo o que se sabe sobre cada opção já está no resultado.
  • Empregos — vagas coletadas de quadros de empregos, agregadores e páginas de carreira dos próprios empregadores, com o empregador, onde o trabalho é baseado, o tipo de emprego e o salário quando declarado. Dois limites que vale saber antes de perguntar: nada retorna em qualquer lugar do Espaço Econômico Europeu, porque a fonte não opera lá, e cerca de três em cada quatro links levam a um quadro de empregos que republica a vaga em vez do empregador.
  • Mapas e locais — lugares, empresas e pontos no mapa, até uma única listagem.
  • Listagens de empresas — todas as empresas de um determinado tipo em um determinado lugar, selecionadas de uma tabela permanente de registros de mapas em vez de classificadas por um mecanismo de busca: nome, endereço, categorias, classificação e sua divisão por estrelas, número de avaliações, telefone, site, horário de funcionamento, faixa de preço, atributos de serviço e acessibilidade e as palavras-chave que os clientes mencionam nas avaliações. Até mil em uma resposta, cada uma com um endereço separado, restritas a uma cidade ou país e a uma classificação mínima, ordenadas por pontuação ou por número de avaliações; empresas permanentemente fechadas são removidas. Isso seleciona por condição e não tem noção de relevância: palavras que não nomeiam nem um tipo de empresa nem uma empresa retornam nada em vez de um melhor esforço. Rússia e Bielorrússia não são cobertas.
  • Vídeo — encontre clipes com filtros de data de upload, qualidade e correspondência exata.
  • Social — pesquise por palavra-chave, comunidade, hashtag ou autor, com filtros de data.
  • Empresas e avaliações — encontre uma empresa no Trustpilot por nome ou ramo de atividade, com sua classificação por estrelas e quantas avaliações ela tem.
  • Viagens e hospitalidade — restaurantes, hotéis, atrações e passeios conforme o Tripadvisor os classifica em uma cidade, distrito, parque ou país nomeado.
  • Aplicativos — pesquise os catálogos do Google Play e da App Store, ou navegue pela lista classificada de uma categoria do Play. Cada país tem sua própria loja, então quais aplicativos existem, como se classificam e quanto custam seguem o mercado que você nomeia.
  • Anúncios — o que uma marca está anunciando agora no Facebook e Instagram, TikTok, LinkedIn ou Google. Pesquise pelas palavras dentro dos anúncios ou liste tudo o que um anunciante nomeado está veiculando e abra qualquer anúncio individual para lê-lo por completo. Nenhuma plataforma publica o que um anunciante gasta; com que frequência um anúncio foi visto e quem o viu são divulgados apenas nos mercados cujas regras exigem isso, e a lista desses mercados de cada plataforma é própria.

Como uma busca é executada também é descrito em palavras simples — um país, um idioma, uma área ou coordenadas, quão recentes os resultados devem ser — então não há sintaxe de filtro por fonte para aprender.

Medir a visibilidade na busca

Além do que uma página diz, seu agente pode perguntar como um site ou um mercado inteiro se sai na busca:

  • Demanda por palavras-chave — com que frequência uma frase é pesquisada em um determinado país e idioma, como isso mudou no último ano, quanto os anunciantes pagam por clique, quão difícil é deslocar os principais resultados e se os pesquisadores querem aprender, comparar, comprar ou navegar. Comece com uma frase, um assunto, um site ou uma lista exata de frases para precificar lado a lado.
  • Classificações — por quais termos um site se classifica e em quais posições, quais de suas páginas e seções geram tráfego, quanto esse tráfego vale, quais sites competem com ele e até onde vai a sobreposição.
  • Backlinks — quem aponta para um site, seção ou página única, com o texto usado, quão forte e confiável parecem as fontes que apontam, quando cada link apareceu e se ainda está ativo.
  • Interesse de busca — quanto as pessoas pesquisam por algo e como isso mudou: um termo, ou até cinco comparados lado a lado, em uma janela da última hora a cada mês desde 2004, ou qual das regiões de um país mais pesquisa por isso — na busca na web, ou em busca de imagens, notícias, compras ou vídeos. Dois limites a saber antes de perguntar: cada relatório é sobre um país e não há número mundial, e os números são relativos — 100 é o ponto mais movimentado dentro da janela perguntada, então mostram forma e comparação, nunca quantas buscas houve.
  • Perfis de domínio — quando um domínio foi registrado e quando expira, quem o registrou, com o que o site é construído (CMS, plataforma de loja, analytics, pagamentos, CRM), os contatos e links sociais que publica e o tamanho de sua presença de busca paga e não paga.

As perguntas são feitas na mesma linguagem simples que todo o resto — sem nomes de campos, operadores ou sintaxe de consulta. Relatórios grandes retornam como um resumo mais um índice de linhas, para que seu agente leia apenas as partes de que precisa.

Extração por significado, não despejo bruto

Cada busca e cada busca de conteúdo carrega um objetivo em linguagem simples — o que você realmente se importa. A plataforma não apenas baixa uma página; ela separa o sinal do ruído, dividindo os resultados em relevantes e fora do tópico e destacando as partes principais de material longo. Você recebe uma resposta à sua pergunta, não uma pilha de HTML.

Memória persistente e citável

Tudo o que é coletado é armazenado como registros duráveis em seu espaço de trabalho — não texto efêmero jogado em uma única interação:

  • Relegível — cada resultado de advanced_web_search e advanced_web_fetch é mantido como um registro citável que você pode abrir novamente mais tarde, muito depois da interação que o produziu.
  • Citações exatas — extraia as faixas de linhas exatas que você se importa de uma versão específica de um registro e obtenha respostas apoiadas por citações por registro e por linha.
  • Busca dentro do seu corpus — busca por palavra-chave e expressão regular em tudo o que você coletou, com contexto ao redor de cada correspondência.

Agentes de pesquisa

Ajudantes inteligentes trabalham sobre os dados coletados:

  • Busca em lote de dezenas de links em uma chamada, processados em paralelo com tratamento de erros limpo por item.
  • Perguntas estruturadas sobre seu corpus — obtenha uma resposta pronta, um conjunto de citações de apoio ou ambos de uma vez.
  • Fan-out de busca — execute uma série de buscas em diferentes plataformas em uma única tarefa.

Resultados em tempo real

Pesquisas longas não fazem você esperar por tudo ou nada. Resultados parciais chegam em fluxo conforme aparecem: primeiros achados aparecem imediatamente, para que seu agente possa reagir em tempo real, ramificar em novas direções e parar assim que tiver o suficiente.


As ferramentas que seu agente recebe

FerramentaO que ela faz
advanced_web_searchDescubra fontes no Google, DuckDuckGo, Google News, Google Scholar, Google Patents, Google Jobs, Google Maps, YouTube, Reddit, TikTok, Threads, Amazon, Walmart, Google Shopping, Google Hotels, Google Flights, Trustpilot, Tripadvisor, Google Play, App Store e nas bibliotecas de anúncios do Facebook, TikTok, LinkedIn e Google, além de um índice permanente de texto de páginas para menções na web e uma tabela permanente de listagens de empresas — execute uma consulta em várias fontes ao mesmo tempo.
advanced_web_fetchExtraia conteúdo limpo e estruturado de qualquer URL pública — muitos de uma vez — com extração ciente da plataforma para vídeo, social, lugares, avaliações, lojas de aplicativos, produtos, casas, hotéis, dados de mercado, patentes, perfis de pesquisadores, anúncios, PDFs e imagens.
seo_metricsResponda perguntas de visibilidade de busca — demanda por palavras-chave, classificações e concorrentes, backlinks, perfis de domínio, interesse de busca ao longo do tempo — feitas em linguagem simples.
ask_collected_recordsFaça uma pergunta sobre os registros que você coletou e obtenha uma resposta com citações por registro e por linha.
read_collected_recordsLeia qualquer registro coletado por referência — uma versão específica, ou apenas a faixa de linhas exata que você precisa.
grep_collected_recordsBusque em todo o seu corpus por palavra-chave ou regex, com contexto ao redor.
get_task_resultsTransmita e colete resultados de tarefas de pesquisa mais longas conforme elas são concluídas.

Fontes com as quais você pode trabalhar

  • Web e busca — Google e DuckDuckGo como dois índices independentes, sites, páginas de produtos
  • Menções na web — um índice permanente do texto das páginas: onde uma frase aparece, uma página por site, com o trecho, sua data e como sua redação é pontuada
  • Notícias e cobertura — Google News: editoras, horários de publicação e links para as próprias páginas das editoras
  • Pesquisa e patentes — Google Scholar com contagens de citações e perfis de pesquisadores, Google Patents com titulares, datas de depósito, status legal e o texto completo de uma patente
  • Produtos e preços — Amazon em qualquer uma das vinte e duas lojas nacionais, Walmart nos Estados Unidos, Google Shopping por país — pesquisados como listagens, abertos como páginas completas de produtos
  • Viagens e estadias — Google Hotels e Google Flights, com preços para as noites ou o dia de partida que a busca especifica
  • Imóveis e propriedades — Zillow: casas à venda, para alugar, vendidas recentemente e fora do mercado, nos Estados Unidos e no Canadá
  • Mercados e finanças — Google Finance: a cotação e os números publicados da empresa, abertos pelo símbolo
  • Empregos e contratação — Google Jobs, fora do Espaço Econômico Europeu, que ele não cobre
  • Visibilidade em buscas — demanda por palavras-chave, rankings e concorrentes, backlinks, perfis de domínio, interesse de busca ao longo do tempo
  • Mapas e local — lugares do Google Maps com suas avaliações e, sob solicitação, as atualizações que uma empresa publica em seu próprio perfil; além de listagens de negócios selecionadas por categoria, local e avaliação, até mil por vez
  • Avaliações e classificações — empresas do Trustpilot, restaurantes, hotéis e atrações do Tripadvisor
  • Lojas de aplicativos — Google Play e Apple App Store, por país
  • Vídeo e criadores — YouTube, TikTok, Twitch
  • Plataformas sociais — Reddit, X/Twitter, Instagram, Facebook, LinkedIn, Threads, Bluesky, Pinterest, Snapchat, Truth Social
  • Anúncios e criativos — as bibliotecas de anúncios do Facebook, Instagram, TikTok, LinkedIn e Google
  • Documentos e arquivos — PDFs, tabelas, imagens

Por que é melhor que a busca web comum

Busca web comumBRONTIR
Trechos que desaparecem após a respostaUm corpus permanente ao qual você pode voltar
Apenas o que entrou no trechoConteúdo completo de páginas, vídeos, posts, PDFs e imagens
Sem como citar um ponto específicoCitações precisas até a linha
Começa do zero a cada vezUm corpus em cache e re-legível que você pode buscar e citar
Um parser genéricoExtração específica por plataforma para cada fonte
Uma multidão de ferramentas sobrecarregando o agenteUm kit leve — poucas ferramentas simples com dezenas de fontes por trás, mantendo seu agente rápido e focado
Todo resultado parece igualmente importanteCada fonte vem com um resumo curto e uma nota de relevância, para seu agente pular o ruído
Páginas inteiras consumidas pela janela de contextoSeu agente lê apenas as partes que importam — cada tarefa termina mais rápido e custa menos

Começando

  1. Crie uma conta — gratuita, sem cartão. Você ganha créditos grátis para explorar imediatamente.
  2. Conecte seu cliente — adicione o endpoint MCP hospedado do BRONTIR ao seu cliente de IA e autorize com OAuth. Nada para instalar. Instruções passo a passo para cada cliente estão em Conectando seu cliente abaixo.
  3. Peça dados — encontre, extraia, compare, resuma ou estruture dados públicos, diretamente no seu chat.

Conectando seu cliente

O BRONTIR é um servidor MCP hospedado e transmitível. Não há nada para instalar nem para rodar localmente — você aponta seu cliente para uma única URL:

https://research.brontir.com/api/mcp

A mesma URL está esperando na sua conta em Conecte seu agente, pronta para copiar. A maioria dos clientes faz login com OAuth — sua conta do Google, nada para colar. Um cliente sem suporte a OAuth autentica com uma chave de API que você cria na sua conta.

Sempre reinicie seu cliente após conectar. Reinicie o aplicativo de desktop ou recarregue a página em um cliente web. Os clientes leem a lista de ferramentas uma vez na inicialização, então até reiniciarem, o agente muitas vezes não vê as novas ferramentas mesmo que o conector já apareça como conectado. Este único passo evita a maioria dos problemas de configuração.

Claude Desktop e Claude Web

Ambos os aplicativos compartilham a mesma interface de configurações, então os passos são idênticos.

  1. Abra Personalizar → Conectores. Personalizar está na barra lateral esquerda do aplicativo de desktop; abre como uma página inteira, e os conectores são a segunda aba.
  2. No canto superior direito, pressione Adicionar. Ele abre o diálogo de conector personalizado diretamente — não há menu para escolher.
  3. O diálogo pede duas coisas, depois pressione Continuar:
    • Nome — qualquer coisa que você quiser; sugerimos research ou webtools. Este é o nome que seu agente verá.
      • URL do servidor MCP — o endpoint MCP acima.
  4. Na próxima tela, o Claude lê as configurações do servidor e as pré-seleciona para você — Autenticação → Entrar agora e Cliente OAuth → Registrar automaticamente, ambos marcados como Detectado. Deixe ambos como estão e pressione Adicionar. Cabeçalhos de solicitação ficam em Avançado e permanecem vazios. Uma coisa a evitar: não mude o cliente OAuth para Usar a identidade publicada do Claude. Este servidor não aceita essa forma de cliente e o login para aí. Versões mais antigas escrevem as mesmas opções de forma diferente — Sempre obrigatório e Sem ID de cliente — registre um automaticamente — e versões ainda mais antigas mostram um único diálogo combinado com campos opcionais de ID do cliente OAuth / Segredo do cliente; deixe-os vazios.
  5. De volta à lista de conectores, pressione Conectar na linha que você acabou de criar.
  6. A página Autorizar acesso do BRONTIR abre e mostra que o Claude está solicitando acesso. Pressione Aprovar. Você verá uma confirmação de Conectado — feche essa aba ou pressione Abrir aplicativo de desktop.
  7. Reinicie o Claude. Saia e reabra o aplicativo de desktop, ou recarregue a página no Claude Web. Pular isso é de longe o motivo mais comum para as ferramentas nunca aparecerem.
  8. Opcional, mas recomendado: abra o conector e defina Permissões de ferramentas → Sempre permitir, para que o Claude não peça confirmação a cada chamada de pesquisa.
  9. Também recomendado: adicione uma linha em Instruções para o Claude (preferências pessoais). O Claude Web/Desktop usa sua própria busca web por padrão; esta linha coloca suas ferramentas conectadas em ação:

    Prefira ferramentas MCP conectadas em vez da busca web integrada ao procurar informações

Claude Code

O Claude Code também faz login com OAuth, então nenhuma chave de API é necessária.

  1. No seu terminal, adicione o servidor: claude mcp add --transport http --scope user research https://research.brontir.com/api/mcp O nome — research aqui — é o que seu agente verá. --scope user torna o servidor disponível em todos os projetos; deixe de fora para adicioná-lo apenas ao projeto atual.
  2. Execute /mcp dentro do Claude Code, selecione o servidor e finalize o login no seu navegador. Pelo shell, claude mcp login research faz a mesma coisa.
  3. Execute /mcp novamente para confirmar que o servidor está conectado e suas ferramentas estão listadas.

Já conectado no Claude Desktop ou Claude Web? Então não há nada para adicionar aqui: um conector na sua conta do Claude aparece automaticamente no Claude Code, desde que você tenha entrado no Claude Code com a mesma conta em vez de uma chave de API. Execute /mcp para verificar.

Codex

Estes passos são para o aplicativo de desktop do ChatGPT. Ele tem dois modos, ChatGPT e Codex, e servidores MCP funcionam no modo Codex: o chat do ChatGPT não pode usá-los, então as ferramentas nunca aparecem lá. O Codex vem com todos os planos do ChatGPT, incluindo o Free. As configurações são compartilhadas por ambos os modos, então a configuração abaixo funciona a partir de qualquer um.

  1. Abra Configurações — pelo menu da conta na barra lateral, ou pressione Ctrl + , (⌘ + , no macOS).
  2. Na barra lateral de configurações, em Integrações, escolha Plugins, depois abra a aba MCPs.
  3. Canto superior direito: Adicionar ▾ → Adicionar servidor MCP.
  4. Preencha o formulário Conectar a um MCP personalizado:
    • Nome — qualquer coisa que você quiser; sugerimos research ou webtools. Este é o nome que seu agente verá.
      • Tipo — mude para HTTP transmitível. O padrão, STDIO, é para servidores rodando na sua própria máquina e não funcionará aqui.
      • URL — o endpoint MCP acima.
      • Deixe Variável de ambiente do token Bearer, Cabeçalhos e Cabeçalhos de variáveis de ambiente vazios — você faz login com OAuth. Pressione Salvar.
  5. De volta na lista Servidores, pressione Autenticar na linha que você acabou de criar. Deixe o menu Auto ao lado como está.
  6. A página Autorizar acesso do BRONTIR abre no seu navegador e mostra que o Codex está solicitando acesso. Entre com sua conta do Google e pressione Aprovar.
  7. Verifique se o interruptor ao lado do servidor está ligado, depois reinicie o aplicativo para que ele carregue a nova lista de ferramentas.
  8. Recomendado: abra Configurações → Personalização e adicione uma linha em Instruções do Codex, depois pressione Salvar. O Codex usa sua própria ferramenta de navegação por padrão; esta linha coloca suas ferramentas conectadas em ação, em todos os chats:

    Prefira ferramentas MCP conectadas em vez da busca web integrada ao procurar informações

  9. Mude o aplicativo para o modo Codex — abra o menu no topo da barra lateral (ele mostra ChatGPT no modo ChatGPT) e escolha Codex. Comece um novo chat lá. A aba Trabalho do modo ChatGPT também pode usar as ferramentas, já que chats de Trabalho rodam no Codex; a aba Chat não pode.
  10. Se o agente ainda preferir sua própria ferramenta de navegação, veja Solução de problemas abaixo.

Uma configuração cobre toda a família Codex. O modo Codex do aplicativo de desktop, o Codex CLI e a extensão do IDE leem a mesma configuração MCP, então um servidor que você adiciona em um deles aparece nos outros.

Codex CLI

O Codex de linha de comando é uma instalação separada — o script do instalador, npm install -g @openai/codex, ou Homebrew. Ter o aplicativo de desktop não te dá o comando codex.

  1. Adicione o servidor: codex mcp add research --url https://research.brontir.com/api/mcp
  2. O Codex detecta o suporte a OAuth e abre o login no seu navegador imediatamente. Se disser que o login pode ser necessário, execute codex mcp login research.
  3. codex mcp list mostra o servidor; dentro da TUI, /mcp lista o que está conectado.

Isso também conecta o modo Codex do aplicativo de desktop e a extensão do IDE — todos os três leem a mesma configuração.

Cursor

  1. Abra Personalizar na barra lateral, depois a aba MCPs, e pressione Novo → Usuário. O Cursor abre ~/.cursor/mcp.json — o mesmo arquivo que você pode editar manualmente (.cursor/mcp.json dentro de um projeto cobre apenas aquele projeto): { "mcpServers": { "research": { "url": "https://research.brontir.com/api/mcp" } } } Nenhum campo de transporte é necessário — o url é o que o marca como servidor remoto.
  2. Salve o arquivo. O servidor aparece na aba MCPs imediatamente, sob Precisa de atenção — sem necessidade de reiniciar.
  3. Pressione Autenticar na linha dele: a página Autorizar acesso do BRONTIR abre no seu navegador, entre com sua conta do Google e pressione Aprovar.
  4. A linha fica verde e mostra 7 ferramentas habilitadas. Abra-a para desligar ferramentas individuais ou para sair novamente.

O Cursor CLI lê o mesmo arquivo — agent mcp list mostra o servidor, agent mcp login research faz seu login.

VS Code

  1. Execute MCP: Adicionar Servidor na paleta de comandos, escolha HTTP (HTTP ou Server-Sent Events), cole o endpoint MCP acima, nomeie-o research, e escolha Global (todos os workspaces) ou Workspace. Editar o arquivo também funciona — .vscode/mcp.json no workspace, ou MCP: Abrir Configuração do Usuário: { "servers": { "research": { "type": "http", "url": "https://research.brontir.com/api/mcp" } } }
  2. O VS Code escreve a entrada, depois pergunta duas vezes antes de entrar: Permitir, para a definição do servidor autenticar, e Abrir, para deixá-lo abrir a página no seu navegador.
  3. Na página Autorizar acesso do BRONTIR, entre com sua conta do Google e pressione Aprovar.
  4. De volta ao editor, a linha acima da entrada em mcp.json mostra Executando e conta as ferramentas. No chat, elas ficam em Configurar Ferramentas, em um grupo nomeado após o servidor. Gerenciar Servidores MCP Confiáveis, no menu Contas, é onde você revoga o acesso depois.

Cline

  1. Abra o ícone MCP Servers no painel do Cline e escolha a aba Remote Servers.
  2. Server Name — research. Server URL — o endpoint MCP acima. Transport Type — Streamable HTTP. Pressione Add Server.
  3. A linha do servidor mostra um botão Authenticate. Pressione-o, faça login com sua conta do Google e pressione Approve.
  4. Prefere o JSON? Pressione Configure MCP Servers na aba Configure e adicione: { "mcpServers": { "research": { "type": "streamableHttp", "url": "https://research.brontir.com/api/mcp" } } } O type importa aqui — sem ele, o Cline volta ao transporte SSE legado.

Grok

  1. Abra grok.com/connectors.
  2. Pressione New Connector e escolha Custom.
  3. Cole o endpoint MCP acima como URL do servidor.
  4. Faça login com sua conta do Google quando a página Authorize access da BRONTIR abrir e pressione Approve.
  5. O Grok descobre as ferramentas e as usa nas conversas. Se elas não aparecerem, inicie um novo chat.

No Grok Business e Enterprise, um administrador da equipe precisa adicionar o conector primeiro, no console em console.x.ai sob Grok Business → Connectors, antes que qualquer pessoa da equipe possa usá-lo.

Grok Build, o agente de linha de comando, usa o mesmo endpoint: grok mcp add --transport http research https://research.brontir.com/api/mcp. O login abre no seu navegador no primeiro uso, ou pressione i na linha do servidor em /mcps. Se uma chamada falhar, grok mcp doctor research explica o motivo.

Antigravity

  1. No painel lateral do agente, abra … → MCP Servers → Manage MCP Servers → View raw config.
  2. Adicione o servidor — observe que o campo é serverUrl, não url: { "mcpServers": { "research": { "serverUrl": "https://research.brontir.com/api/mcp" } } }
  3. Abra Agent Settings (Ctrl + , / ⌘ + ,), vá em Customizations e pressione Authenticate ao lado do servidor.
  4. Faça login com sua conta do Google no navegador, copie o código de autorização que ele fornece, cole-o de volta no painel de configurações e pressione Submit. O Antigravity reconecta sozinho.
  5. Se o servidor não aparecer, pressione Refresh na lista de servidores ou reinicie o Antigravity.

Kiro

  1. Abra a paleta de comandos e execute Kiro: Open user MCP config (JSON) (ou a variante do workspace). O suporte a MCP precisa ser ativado uma vez nas Configurações.
  2. Adicione o servidor: { "mcpServers": { "research": { "url": "https://research.brontir.com/api/mcp", "oauthScopes": [] } } } oauthScopes está vazio de propósito: sem ele, o Kiro pede um conjunto de escopos que não emitimos, e o login falha.
  3. Salve. O Kiro reconecta sozinho e abre a página de autorização no seu navegador — faça login com sua conta do Google e pressione Approve.
  4. A aba MCP servers no painel do Kiro mostra a conexão e lista as ferramentas. Não é necessário reiniciar.

Qualquer outro cliente MCP

OpenClaw, Hermes — ou qualquer outra coisa que fale o protocolo MCP streamable.

  1. Na sua conta, em Connect your agent → API keys, crie uma chave e copie-a. A chave completa é mostrada apenas uma vez.
  2. Aponte o cliente para o endpoint MCP acima, usando o transporte HTTP streamable.
  3. Envie a chave como um token bearer: Authorization: Bearer nai_…
  4. Reinicie o cliente para que ele carregue a nova lista de ferramentas.

Solução de problemas

O conector está conectado, mas o agente não vê as ferramentas

Reinicie o cliente primeiro: saia e reabra o aplicativo de desktop ou recarregue a página em um cliente web. Os clientes armazenam em cache a lista de ferramentas na inicialização e não descobrem um conector recém-adicionado até reiniciarem.

Se as ferramentas ainda estiverem ausentes após a reinicialização, inicie um novo chat. Uma conversa já aberta pode manter a lista de ferramentas com a qual foi criada, então um chat novo é a alternativa confiável.

Você pressionou Approve, mas o cliente ainda mostra o conector como não conectado

A autorização foi concluída — o cliente simplesmente não atualizou o próprio estado. Reinicie o aplicativo de desktop ou recarregue a página no Claude Web, e o conector aparecerá como conectado.

Se ainda parecer desconectado após a reinicialização, pressione Connect mais uma vez e aprove novamente; a segunda passagem tem efeito imediato.

O agente ignora a BRONTIR e usa a busca web integrada

Isso acontece quando o modelo já tem uma ferramenta de navegação própria e recorre ao hábito. Qualquer uma das opções abaixo resolve — a primeira é instantânea, as demais tornam a mudança permanente:

  • Nomeie as ferramentas no seu prompt. Em vez de "pesquise isso", escreva "use advanced_web_search e advanced_web_fetch do MCP de pesquisa". Referir-se diretamente ao conector e aos nomes das ferramentas é o empurrão mais confiável.
  • Adicione uma instrução permanente à memória do agente para não precisar repetir toda vez.
  • Coloque nas configurações de instruções do cliente — Instructions for Claude (preferências pessoais) no Claude Web e Claude Desktop, Settings → Personalization → Codex instructions no Codex. Por exemplo: "Para qualquer pesquisa web, use as ferramentas MCP da BRONTIR (advanced_web_search, advanced_web_fetch, read_collected_records, grep_collected_records, ask_collected_records). Não use a busca web integrada."
  • Para agentes de codificação, coloque a mesma regra no CLAUDE.md ou AGENTS.md do repositório — ela se aplica a todas as sessões naquele projeto.
  • Desative as ferramentas integradas. No Claude, você pode desabilitar a busca web nas configurações de ferramentas do chat, deixando o conector como o único caminho de pesquisa.

BRONTIR. Toda a web pública, como uma base de conhecimento estruturada.