Novo · servidor MCP + API REST
Howseen MCP: veja onde a IA escolhe seu concorrente em vez de você
Pergunte ao Claude, ChatGPT ou Cursor quais perguntas de compradores mencionam um concorrente em vez da sua marca, e corrija direto no mesmo chat. Testamos primeiro na nossa própria marca: em 5 de outubro de 2026, 45 das nossas 50 perguntas rastreadas mencionaram um concorrente, e não nós.
Toda alteração é mostrada para você antes. Nada acontece até você confirmar.
Claude & Claude Code
ChatGPT & Codex
Cursor
Por Raphaël Aubry, fundador da Howseen AI · Atualizado em Visão geral
O que é o servidor MCP do Howseen?
O servidor MCP do Howseen permite que o Claude, o ChatGPT ou o Cursor leiam seus dados de visibilidade em IA do Howseen e, quando você autorizar, ajam sobre eles. As chaves são somente leitura por padrão; nada muda até você criar uma chave com ações habilitadas e confirmar cada alteração.
O Howseen rastreia como ChatGPT, Gemini, Perplexity, Google AI Overviews e Google AI Mode respondem às perguntas dos seus compradores: se mencionam sua marca, quais concorrentes mencionam no seu lugar, e quais fontes citam. Se você está começando agora, veja o que é GEO (generative engine optimization) e como a IA escolhe quais marcas recomendar.
Até agora, esses dados ficavam só no painel. O servidor MCP os leva até o assistente de IA que você já usa. Ele fala o Model Context Protocol, o padrão aberto que os aplicativos de IA usam para se conectar a dados externos:
"Pense no MCP como uma porta USB-C para aplicativos de IA."
A Anthropic abriu o código do protocolo em novembro de 2024 (anúncio), e a OpenAI documenta como seus modelos se conectam a servidores MCP remotos (guia de MCP da OpenAI). Os números que seu assistente recebe do Howseen são os mesmos do seu painel, apenas para suas próprias marcas.
Casos de uso
Veja a lacuna. Depois feche ela.
Cada pergunta de comprador que você perde é uma recomendação que foi para outra pessoa. Seu assistente mostra onde ChatGPT, Gemini, Perplexity e Google AI citam seus concorrentes em vez de você, em quais sites essas respostas confiam, e ajuda você a reconquistar a pergunta.
| Você pergunta | O que acontece |
|---|---|
| "Quais perguntas de comprador citam meus concorrentes e não a mim?" | Ele lista as perguntas exatas onde você perde, engine por engine |
| "Em quais sites eu deveria aparecer primeiro?" | Ele classifica os sites que a IA já cita nessas respostas, começando pela vitória mais fácil |
| "O que mudou desde meu último escaneamento?" | Ele diz o que mudou e o motivo provável |
| "Escreva o artigo que reconquista minha maior lacuna e publique-o." | Ele redige o artigo, mostra para você, e só publica quando você confirmar |
Novo por aqui? Comece seu teste grátis de 3 dias, o servidor MCP está incluído. Já é cliente Howseen? Crie sua chave em Configurações > API & assistentes de IA.
Prova
A prova, feita em nós mesmos
Em 5 de outubro de 2026, em 50 perguntas reais de compradores, um concorrente foi citado em 45 e a Howseen não foi citada em nenhuma. Nossa visibilidade era de 4%.
Ainda não temos um case de cliente para mostrar, então apontamos a Howseen para a própria Howseen. A mesma resposta não parou no estrago: ela retornou uma lista classificada de sites de terceiros já citados nessas respostas perdidas, os primeiros em que vale a pena trabalhar.
Para o padrão mais amplo, nosso estudo público de 5.331 respostas de IA descobriu que o YouTube foi citado em 45% dos Google AI Overviews e em 0 de 1.164 respostas do ChatGPT. Engines diferentes confiam em fontes diferentes, por isso você precisa acompanhar cada uma delas.
Referência
As 26 ferramentas
Ferramentas de leitura funcionam com qualquer chave. Ferramentas de ação precisam de uma chave com ações habilitadas, e toda mudança é pré-visualizada antes de você confirmar. Seu assistente escolhe sozinho a ferramenta certa, com base na pergunta que você faz.
| Ferramenta | O que ela faz |
|---|---|
| Veja a lacuna (qualquer chave) | |
get_changes | O que mudou entre seus dois últimos escaneamentos, por engine de IA |
get_prompt_gaps | Perguntas onde um concorrente é citado e você não |
get_easiest_wins | Os sites que a IA cita nessas respostas, classificados, mais fáceis primeiro |
get_action_plan | Suas próximas melhores ações |
get_visibility | Visibilidade %, share of voice, posição média e tendência, por engine |
get_competitors | Ranking de concorrentes por visibilidade |
get_top_sources | Domínios e URLs mais citados, por engine |
search_responses | Trechos reais de respostas de IA com suas citações |
list_prompts | As perguntas de comprador que você acompanha |
list_articles | Artigos que a Howseen escreveu para a marca |
get_article_performance | Como seus artigos estão indexados no Google e no Bing |
suggest_prompts | Perguntas reais de compradores que você ainda não acompanha |
get_usage | Seu plano, cotas e o que sua chave pode fazer |
list_brands | As marcas acompanhadas na sua conta |
| Feche a lacuna (chave com ações habilitadas, pré-visualizada e depois confirmada) | |
add_prompts, archive_prompts, remove_prompts | Escolha as perguntas que você acompanha |
add_competitor, remove_competitor | Escolha com quem você se compara |
mark_action_done, dismiss_action | Mantenha seu plano de ação atualizado |
draft_article | Um rascunho que responde a uma pergunta de comprador (nunca publicado sozinho) |
run_scan | Atualize seus dados, mesmo limite do botão Executar agora |
create_share_report | Um link de relatório pronto para o cliente, com a marca da sua agência |
| Publicar (pré-visualizado e depois confirmado) | |
publish_article | Publique um rascunho no seu CMS conectado (WordPress, Shopify, Ghost, BigCommerce, webhook) ou no blog hospedado pela Howseen, agora ou em uma data definida |
request_indexing | Peça ao Google e ao Bing para indexar a nova página |
Prompts prontos: weekly_review (o que mudou, suas lacunas, suas vitórias mais fáceis, o que fazer nesta semana) e client_report (visibilidade, concorrentes e um link compartilhável).
Configuração
Configure em 2 minutos
Crie uma chave de API pessoal na Howseen, cole a configuração pronta para o seu app de IA e faça sua primeira pergunta. Sem necessidade de escrever código.
- Crie uma chave. No painel da Howseen, abra Configurações > "API & assistentes de IA" (app.howseen.ai/settings?tab=api). Sua chave começa com
hs_live_e é mostrada uma única vez, então copie-a imediatamente. Ela é somente leitura, a menos que você habilite ações. - Copie a configuração do seu app. Configurações tem uma configuração pronta para copiar e colar para Claude, Claude Code, ChatGPT, Codex, Cursor e REST, já com sua chave incluída. Trabalha no terminal? Veja o guia de Claude Code e Codex.
- Pergunte. Experimente "Quais perguntas de comprador citam meus concorrentes e não a mim?" e seu assistente responde com seus dados da Howseen.
| App | Conexão |
|---|---|
| Claude | Um conector personalizado com a URL do servidor, depois funciona no claude.ai, no app Claude Desktop e no celular |
| Claude Code | Um comando no seu terminal (claude mcp add), disponível em todos os projetos |
| ChatGPT | Conector MCP, no modo desenvolvedor |
| Codex | Um comando no seu terminal (codex mcp add), chave lida de uma variável de ambiente |
| Cursor | Entrada mcp.json (Configurações gera isso para você) |
| Scripts | API REST com curl ou qualquer cliente HTTP |
O servidor fica em https://app.howseen.ai/api/mcp (Streamable HTTP). Ele autentica com o cabeçalho Authorization: Bearer <sua chave>. Para clientes que não conseguem enviar cabeçalhos, a chave vai na URL como ?key=. Alguns apps de IA só conseguem enviar sua chave dentro da URL do servidor: trate essa URL como uma senha, não a compartilhe nem a exiba na tela, e revogue a chave em Configurações se ela vazar.
Para desenvolvedores e agências
API REST para desenvolvedores e agências
Os mesmos dados estão disponíveis como uma API REST JSON somente leitura, com filtros de período e engine e paginação, para seus scripts, relatórios e painéis de clientes.
| Endpoint | Retorna |
|---|---|
GET /api/v1/brands | Suas marcas |
GET /api/v1/brands/{id}/visibility | Visibilidade, share of voice, posição, tendência |
GET /api/v1/brands/{id}/prompts | Perguntas de comprador acompanhadas |
GET /api/v1/brands/{id}/competitors | Ranking de concorrentes |
GET /api/v1/brands/{id}/sources | Domínios e URLs mais citados |
GET /api/v1/brands/{id}/responses | Trechos de respostas de IA e citações |
GET /api/v1/brands/{id}/actions | Próximas melhores ações |
GET /api/v1/brands/{id}/articles | Artigos |
curl "https://app.howseen.ai/api/v1/brands/BRAND_ID/visibility?from=2026-09-01&to=2026-09-30&engine=chatgpt" \
-H "Authorization: Bearer hs_live_YOUR_KEY"- Filtros:
frometo(AAAA-MM-DD),engine(chatgpt, gemini, perplexity, ai_overviews, ai_mode). - Paginação:
limiteoffset. - Limites de taxa: 120 requisições por minuto e 5.000 por dia, por chave.
Agências podem puxar todas as marcas de clientes para o próprio relatório. Veja GEO para agências e os planos para agências.
Confiança
Segurança e privacidade
Somente leitura por padrão. Uma chave só pode agir se você a criar com ações habilitadas, e toda mudança precisa da sua confirmação. Cada chave só vê suas próprias marcas, e a Howseen nunca armazena sua chave em si, apenas seu hash sha256.
- Somente leitura por padrão. Uma chave só pode agir se você a criar com ações habilitadas, e toda mudança precisa da sua confirmação. A API REST permanece somente leitura.
- Toda mudança é registrada. As mudanças aplicadas ficam listadas em Configurações em "Ações feitas pela sua IA", e os limites do seu plano se aplicam exatamente como no app.
- Somente seus dados. Uma chave fica restrita estritamente às marcas da conta que a criou, ou a uma única marca, se você preferir.
- Chave mostrada uma única vez. A Howseen guarda apenas um hash sha256, então ninguém consegue recuperar sua chave, nem mesmo nós.
- Revogável. Cada chave pode ser revogada a qualquer momento em Configurações.
Perguntas respondidas
O que é um servidor MCP?+
Um servidor MCP expõe dados e ferramentas através do Model Context Protocol, um padrão aberto para conectar aplicativos de IA a sistemas externos. O servidor MCP da Howseen expõe 26 ferramentas sobre seus dados de visibilidade em IA: ferramentas de leitura para seus números, e ferramentas de ação (acompanhar perguntas, redigir e publicar artigos) que só são executadas depois que você confirmar.
Meu assistente pode alterar minha conta?+
Somente se você permitir. As chaves de API são somente leitura por padrão. Para permitir que seu assistente aja, crie uma chave com ações habilitadas. Mesmo assim, toda alteração aparece primeiro como uma prévia (o que vai mudar e o efeito nas suas cotas) e só acontece depois da sua confirmação. Os limites do seu plano se aplicam exatamente como no app, toda alteração aplicada é listada em Configurações em “Ações feitas pela sua IA”, e você pode revogar uma chave a qualquer momento.
Quais aplicativos são suportados?+
Qualquer assistente que suporte servidores MCP remotos. Em Configurações você encontra uma configuração pronta para copiar para o Claude (claude.ai, o app Claude Desktop e o mobile, por meio de um conector personalizado), Claude Code (um comando no terminal), ChatGPT (conectores em modo desenvolvedor), Codex (um comando no terminal) e Cursor (mcp.json). Desenvolvedores também podem acessar os mesmos dados pela REST API.
Meus dados estão seguros?+
Cada chave só enxerga as marcas da conta que a criou. A Howseen armazena apenas um hash sha256 da sua chave, mostra a chave uma única vez e permite revogá-la a qualquer momento. Alguns apps só conseguem enviar sua chave dentro da URL do servidor: trate essa URL como uma senha.
Preciso programar?+
Não. Você cria uma chave em Configurações, copia a configuração para o seu app de IA, cola e faz perguntas em linguagem natural. Claude Code e Codex exigem apenas um comando no terminal. A REST API é para desenvolvedores que querem automatizar com scripts.
Existem limites?+
Sim, para que nada sobrecarregue o seu plano, e o uso normal fique bem abaixo deles: 120 solicitações por minuto e 5.000 por dia por chave. As varreduras seguem a mesma regra de Executar agora do aplicativo, e seus dados são atualizados automaticamente a cada 3 dias, ou diariamente no Business.
Quais planos incluem isso?+
O servidor MCP e a API REST estão incluídos nos planos Pro e Business, além do teste gratuito de 3 dias.
Agências podem usar para várias marcas?+
Sim. A ferramenta list_brands retorna todas as marcas monitoradas na sua conta Howseen, então uma única chave cobre as marcas de todos os seus clientes, e create_share_report gera um link de relatório pronto para o cliente, com a identidade visual da sua agência. Você também pode criar uma chave limitada a uma única marca para um cliente específico.
Você não pode corrigir uma lacuna que não mediu
Conecte seu assistente por 3 dias, de graça, e pergunte quem é mencionado no seu lugar. Incluído no Pro e no Business, veja os preços para marcas.
