Rastreie sua visibilidade em IA a partir do Claude Code e do Codex

Resposta rápida

Como rastreio a visibilidade em IA pelo Claude Code ou Codex?

Crie uma chave de API da Howseen, adicione o servidor MCP da Howseen com um comando e pergunte ao seu agente quais perguntas dos compradores mencionam um concorrente em vez de você.

O servidor MCP da Howseen está em https://app.howseen.ai/api/mcp e fala Streamable HTTP, então os dois agentes se conectam a ele como a qualquer servidor remoto. Ele dá ao seu agente 26 ferramentas sobre os dados da Howseen: as mesmas porcentagens de visibilidade, concorrentes e fontes citadas do seu painel, apenas para suas próprias marcas. Ferramentas de leitura funcionam com qualquer chave; ferramentas de ação só rodam após uma prévia e sua confirmação.

"MCP (Model Context Protocol) é um padrão de código aberto para conectar aplicações de IA a sistemas externos."

Por que o terminal

Por que desenvolvedores e agências querem esses dados perto do código

Quem pode corrigir uma lacuna de visibilidade (uma página, uma tabela comparativa, uma seção de documentação) geralmente trabalha no repositório. Colocar a lacuna no mesmo terminal elimina a ida e volta ao painel.

• Da lacuna ao pull request. Pergunte em qual pergunta você perde e depois peça ao mesmo agente para escrever ou atualizar a página que a responde, direto no seu próprio código.
• Agências, uma chave para cada cliente. A ferramenta list_brands retorna todas as marcas da sua conta Howseen, para você revisar todos os clientes em uma única sessão. Veja GEO para agências.
• Dados reais, não suposições. Seu agente lê as respostas que a Howseen realmente coletou do ChatGPT, Gemini, Perplexity, Google AI Overviews e Google AI Mode, em vez de supor o que a IA diz sobre você.

Se a ideia de visibilidade em IA é nova para você, leia primeiro o que é GEO (generative engine optimization) e como a IA escolhe quais marcas recomendar.

Exemplo real

Como fica na nossa própria marca

Em 6 de outubro de 2026, perguntamos ao Claude, conectado pelo servidor MCP da Howseen, sobre a própria Howseen, usando nosso scan de 5 de outubro. A resposta não foi lisonjeira, e esse é o ponto.

A parte útil é o último número. A página mais citada nas respostas que perdemos foi um artigo de lista de terceiros, então o primeiro passo é conseguir ser listado lá, não reescrever nossa página inicial. Mecanismos diferentes confiam em fontes diferentes: nosso estudo de 5.331 respostas de IA descobriu o YouTube citado em 45% das Google AI Overviews e em 0 de 1.164 respostas do ChatGPT. Para comparar ferramentas nesse tipo de dado, veja ferramentas de visibilidade em IA.

Configuração 1

Conectar o Claude Code

Um comando claude mcp add registra o servidor Howseen para sua conta de usuário, deixando-o disponível em todos os projetos. Depois, digite /mcp dentro do Claude Code para confirmar a conexão.

1. Crie uma chave. Na Howseen, abra Configurações > "API & assistentes de IA" (app.howseen.ai/settings?tab=api). A chave começa com hs_live_ e é exibida apenas uma vez, então copie na hora.
2. Execute isto no seu terminal, substituindo hs_live_YOUR_KEY pela sua chave:

claude mcp add --scope user --transport http howseen https://app.howseen.ai/api/mcp \
  --header "Authorization: Bearer hs_live_YOUR_KEY"

3. Confira. Inicie o Claude Code e digite /mcp. O servidor howseen deve aparecer como conectado. Executamos esse comando exato em 6 de outubro de 2026 e obtivemos "Connected".

Por que --scope user: a documentação da Anthropic diz que esse escopo armazena o servidor em ~/.claude.json e o torna disponível em todos os seus projetos, mantendo-o privado para sua conta de usuário. O escopo de projeto, por outro lado, é feito para ser compartilhado via controle de versão, o que é o lugar errado para uma chave. Fonte: Connect Claude Code to tools via MCP.

Configuração 2

Conectar o Codex

O Codex lê o bearer token a partir de uma variável de ambiente, então sua chave fica fora do arquivo de configuração do Codex. Exporte a chave e depois execute codex mcp add uma vez.

export HOWSEEN_API_KEY=hs_live_YOUR_KEY
codex mcp add howseen --url https://app.howseen.ai/api/mcp --bearer-token-env-var HOWSEEN_API_KEY

Adicione a linha export ao perfil do seu shell (por exemplo, ~/.zshrc ou ~/.bashrc) para que a chave continue disponível na próxima sessão do terminal. Para conferir a configuração, execute codex mcp list, ou digite /mcp dentro do Codex.

Prefere editar o arquivo diretamente? O mesmo servidor em ~/.codex/config.toml:

[mcp_servers.howseen]
url = "https://app.howseen.ai/api/mcp"
bearer_token_env_var = "HOWSEEN_API_KEY"

As opções --url e --bearer-token-env-var e as chaves url e bearer_token_env_var vêm da documentação do Codex da OpenAI: Model Context Protocol (MCP) for Codex.

O que perguntar

7 prompts que funcionam

Você não precisa saber o nome das ferramentas. Pergunte em português claro e seu agente escolhe a ferramenta certa da Howseen sozinho. Aqui estão sete que funcionam bem.

Agências também podem usar o prompt client_report (visibilidade, concorrentes e um link compartilhável) para cada marca cliente. A lista completa das 26 ferramentas está na página de MCP da Howseen.

Permissões

Somente leitura por padrão, ações apenas após sua confirmação

Uma chave padrão só lê. Para permitir que seu agente altere algo, crie uma chave com ações ativadas; mesmo assim, toda mudança vem como prévia e só acontece depois que você confirma.

Os limites do seu plano valem exatamente como no app, e toda alteração aplicada aparece em Configurações, em “Ações realizadas pela sua IA”.

Segurança

Mantenha sua chave fora do seu repositório

Trate uma chave Howseen como uma senha. Guarde-a em uma variável de ambiente ou na sua configuração de usuário, nunca em um arquivo versionado, e revogue-a em Configurações assim que houver vazamento.

• Nunca faça commit dela. Não cole a chave em um .mcp.json do projeto, em um README ou em um script que vai para o Git. No Claude Code, use --scope user; no Codex, use --bearer-token-env-var.
• Cuidado com os dotfiles. Se você sincroniza ~/.zshrc ou ~/.claude.json com um repositório público, mova a chave para um arquivo que não seja sincronizado.
• Evite a forma de URL aqui. A opção ?key= existe para clientes que não conseguem enviar headers. Claude Code e Codex conseguem, então use o header ou a variável de ambiente.
• Revogue com um clique. Cada chave pode ser revogada a qualquer momento em Configurações > "API & assistentes de IA". A Howseen guarda apenas um hash da sua chave, nunca a chave em si.
• Limites de uso. 120 requisições por minuto e 5.000 por dia, por chave.

Automação

Use em CI ou scripts

Para um job noturno, uma checagem de CI ou um dashboard de cliente, pule o agente e chame diretamente a API REST somente leitura, com a mesma chave e os mesmos dados.

A API REST retorna JSON com filtros de período e de engine, além de paginação. Guarde a chave como um secret de CI, nunca no arquivo do workflow. Os endpoints e um exemplo com curl estão na seção de API REST da página do MCP.

Preços

Quanto custa

O servidor MCP está incluído no Pro (€79 por site por mês) e no Business, além do teste gratuito de 3 dias, veja os preços para marcas.

Ainda não quer testar? Pegue primeiro um relatório de IA gratuito: sem cartão, cerca de 2 minutos.