Base de conhecimento

Conecte o Findrix ao seu assistente de IA

Depois de conectar, você pode perguntar ao seu assistente de IA como sua marca aparece nas respostas das IAs, o que corrigir a seguir ou pedir um relatório em PDF. Ele busca a resposta na sua conta do Findrix. Com o Claude ou o ChatGPT, leva poucos minutos e você não precisa de chave nem de arquivo de configurações.

Antes de começar

  • Uma conta do Findrix com pelo menos um site em um plano pago (Presence ou superior). Sem isso, seu assistente só consegue informar quem você é no Findrix.
  • O aplicativo do assistente que você quer usar, com a sessão iniciada. Se sua conta do Claude pertence a uma empresa (Claude Team ou Enterprise), alguém com perfil de proprietário talvez precise adicionar o Findrix para toda a organização primeiro.
  • Alguns minutos: cerca de dois para o Claude, três para o ChatGPT e cinco para o Cursor ou o Codex.

Claude: claude.ai e aplicativo para computadorRecomendado

A maneira mais fácil. Você entra com sua conta do Findrix, então não há chave para copiar nem nada para instalar. Funciona da mesma forma no Mac e no Windows, no navegador e no aplicativo do Claude para computador.

Adicionar o Findrix ao Claude

Abre claude.ai com o nome e o endereço do servidor preenchidos. Endereço do servidor:

https://app.findrix.ai/api/mcp

  1. Clique em Add Findrix to Claude (adicionar o Findrix ao Claude) acima. O Claude abre o formulário Add custom connector (adicionar conector personalizado) com o nome e o endereço do servidor já preenchidos. Para adicionar manualmente, abra Customize → Connectors → Add custom connector (personalizar → conectores → adicionar conector personalizado) no Claude e cole o endereço do servidor https://app.findrix.ai/api/mcp.

  2. Se aparecer Request headers (cabeçalhos da solicitação), deixe em branco. A maioria das contas do Claude não tem essa seção; se ela não aparecer na sua, pule esta etapa.

  3. Em Authentication (autenticação), escolha Sign in when needed (entrar quando necessário).

  4. Em OAuth client (cliente OAuth), escolha Use Claude's published identity (usar a identidade publicada do Claude). Não escolha Register automatically (registrar automaticamente): o Findrix não oferece suporte a essa opção e a conexão falha.

  5. Clique em Add (adicionar).

    Formulário Add custom connector (adicionar conector personalizado) do Claude: Request headers (cabeçalhos da solicitação), presente apenas em algumas contas, em branco; Sign in when needed (entrar quando necessário); Use Claude’s published identity (usar a identidade publicada do Claude); depois Add (adicionar). Ilustração — sua tela pode ser um pouco diferente.

  6. Abra uma nova conversa e pergunte: Who am I in Findrix, and which sites do I have? O Claude pede que você conecte o Findrix. Clique em Connect (conectar), entre no Findrix e, na tela Autorizar acesso (autorizar acesso), clique em Permitir (permitir).

    A tela do Findrix que abre quando o Claude conecta: mantenha Fazer alterações por você (fazer alterações para você) marcado para permitir que o Claude faça alterações e depois clique em Allow (permitir). Ilustração — sua tela pode ser um pouco diferente.

Deixe Fazer alterações por você (fazer alterações para você) marcado se quiser que o Claude aprove correções, adicione prompts ou registre trabalhos para você. Se desmarcar, o Claude só poderá consultar informações.

O formulário do Claude varia entre as contas. Se o seu mostrar o nome, o endereço do servidor e Advanced settings (configurações avançadas) na mesma tela, não há nada para escolher: deixe Advanced settings (configurações avançadas) em branco e clique em Add (adicionar).

No plano Free do Claude, você só pode adicionar um conector personalizado. Se já tiver outro, remova-o em Customize → Connectors (personalizar → conectores) antes de adicionar o Findrix.

Está usando o aplicativo do Claude para computador? Um conector adicionado em claude.ai aparece automaticamente no aplicativo, na mesma conta do Claude. Você também pode adicioná-lo nas configurações do próprio aplicativo, em Connectors (conectores), com as mesmas opções.

Você é proprietário de uma organização Claude Team ou Enterprise? Nesse caso, adicione o Findrix para todos em Organization settings → Connectors (configurações da organização → conectores).

ChatGPT

Assim como o Claude, o ChatGPT entra com sua conta do Findrix: não há chave para copiar nem nada para instalar. Você adiciona o Findrix uma única vez, em chatgpt.com pelo navegador.

  1. Abra ChatGPT Plugins, clique em Add (adicionar) e escolha Add custom MCP server (adicionar servidor MCP personalizado).

  2. Dê a ele o nome Findrix. Em Connection (conexão), cole o endereço do servidor https://app.findrix.ai/api/mcp em Server URL (URL do servidor).

  3. Para autenticação, escolha OAuth. Deixe o ID e o segredo do cliente em branco: o ChatGPT faz a autenticação no Findrix por conta própria.

  4. Clique em I understand and want to continue (entendo e quero continuar), depois em Create as a plugin (criar como plugin) e instale o plugin.

  5. Quando o ChatGPT solicitar, entre no Findrix e, na tela Autorizar acesso (autorizar acesso), clique em Permitir (permitir).

  6. Abra uma nova conversa, digite @, selecione Findrix e pergunte: Who am I in Findrix, and which sites do I have?

Deixe Fazer alterações por você (fazer alterações para você) marcado se quiser que o ChatGPT aprove correções, adicione prompts ou registre trabalhos para você. Se desmarcar, o ChatGPT só poderá consultar informações. Em ambos os casos, o ChatGPT pede sua confirmação antes de cada alteração.

Usa o ChatGPT no trabalho (Business ou Enterprise)? Talvez um administrador precise permitir servidores MCP personalizados no seu workspace primeiro.

Confira se está funcionando

Pergunte ao seu assistente Who am I in Findrix, and which sites do I have? Ele deve responder com seu e-mail, seu plano e a lista dos seus sites. Se isso acontecer, o Findrix está conectado.

Uma primeira pergunta em uma nova conversa e o tipo de resposta que mostra que o Findrix está conectado. Ilustração — sua tela pode ser um pouco diferente.

Depois, tente uma destas opções:

  • Como yourbrand.com está se saindo nas respostas das IAs neste mês?
  • Quais concorrentes os mecanismos de IA mencionam no nosso lugar?
  • O que devo corrigir primeiro na minha página inicial?
  • O que mudou nesta semana e o que está aguardando minha decisão?
  • Crie um relatório em PDF sobre nossa visibilidade nas IAs.
  • Mostre as correções que estão prontas para aprovação e depois aprove-as.

Identifique seu site pelo domínio. Se você tiver vários sites, diga qual deles na primeira mensagem: o assistente se lembra dele pelo resto da conversa.

Cursor e Codex: obtenha uma chave primeiro

O Cursor e o Codex se conectam com uma chave do Findrix, uma senha longa criada para um aplicativo. Você a cria na sua conta do Findrix, e o Findrix fornece a configuração completa para colar, já com a chave incluída.

  1. Abra MCP e conexões na sua conta do Findrix (Conta → MCP e conexões).

  2. Crie uma chave e dê a ela o nome do aplicativo, por exemplo, Cursor. Uma conta pode ter até cinco chaves.

  3. O Findrix mostra a chave uma única vez, junto com uma configuração pronta. Em Configure um cliente com esta chave (configurar um cliente), selecione seu aplicativo e seu sistema (macOS / Linux ou Windows) e clique em Copiar (copiar). Mantenha a página aberta até colar a configuração.

    Logo após criar uma chave, o Findrix a mostra uma única vez com uma configuração pronta: em Configure um cliente com esta chave (configurar um cliente), selecione seu aplicativo e seu sistema e clique em Copy (copiar). Ilustração — sua tela pode ser um pouco diferente.

Trate a chave como uma senha: não a cole em uma conversa com o assistente nem a envie por e-mail. Se ela vazar, revogue-a na mesma página e crie outra.

Cursor

  1. Obtenha uma chave com a configuração pronta para o Cursor (acima) e clique em Copiar (copiar).

  2. Abra o arquivo de configurações MCP do Cursor, mcp.json.

    No Mac

    Abra o Terminal (pressione Cmd+Space, digite Terminal e pressione Return), cole esta linha e pressione Return. O arquivo abre no Cursor.

    mkdir -p ~/.cursor && touch ~/.cursor/mcp.json && open -a Cursor ~/.cursor/mcp.json

    No Windows

    Pressione Win+R, cole esta linha e pressione Enter. Se o Notepad perguntar se você quer criar o arquivo, clique em Yes (sim). Se informar que o caminho não foi encontrado, abra o Cursor uma vez, feche-o e tente novamente.

    notepad %USERPROFILE%\.cursor\mcp.json

  3. Se o arquivo estiver vazio ou contiver apenas {'}, selecione todo o conteúdo e cole. Se ele já listar outros servidores, cole apenas o trecho "findrix": { … } dentro de "mcpServers", com uma vírgula entre ele e o servidor anterior.

    O mcp.json do Cursor após colar: uma entrada findrix com o endereço do servidor e sua chave. Ilustração — sua tela pode ser um pouco diferente.

  4. Salve o arquivo.

    No Mac

    Pressione Cmd+S.

    No Windows

    Pressione Ctrl+S.

  5. Encerre completamente o Cursor e abra-o novamente. Clique em Customize (personalizar) na barra lateral e depois em MCPs (nas versões anteriores à 3.9: Cursor Settings → Tools & MCP, ou configurações do Cursor → ferramentas e MCP). O Findrix aparece na lista e está ativado. Se não aparecer ou mostrar um erro, abra o painel Output (saída) e selecione MCP Logs (logs do MCP) para ver o motivo.

    No Mac

    Pressione Cmd+Q para encerrar. Cmd+Shift+U abre o painel Output (saída).

    No Windows

    Feche todas as janelas do Cursor para encerrá-lo. Ctrl+Shift+U abre o painel Output (saída).

  6. Abra uma nova conversa e pergunte: Who am I in Findrix, and which sites do I have?

Codex

O aplicativo do Codex, a linha de comando do Codex e a extensão do Codex para VS Code ou Cursor compartilham um único arquivo de configurações. Assim, você configura o Findrix uma única vez para todos eles.

  1. Obtenha uma chave com a configuração pronta para o Codex (acima) e clique em Copiar (copiar).

  2. Abra o arquivo de configurações do Codex.

    No Mac

    Abra o Terminal (pressione Cmd+Space, digite Terminal e pressione Return), cole esta linha e pressione Return. O arquivo abre no TextEdit.

    mkdir -p ~/.codex && touch ~/.codex/config.toml && open -e ~/.codex/config.toml

    No Windows

    Pressione Win+R, cole esta linha e pressione Enter. Se o Notepad perguntar se você quer criar o arquivo, clique em Yes (sim). Se informar que o caminho não foi encontrado, abra o Codex uma vez, feche-o e tente novamente.

    notepad %USERPROFILE%\.codex\config.toml

  3. Cole a configuração no final do arquivo e salve.

    O config.toml do Codex após colar: a configuração começa com [mcp_servers.findrix]. Ilustração — sua tela pode ser um pouco diferente.

  4. Encerre completamente o Codex e inicie-o novamente. Usa o Codex dentro do VS Code ou do Cursor? Reinicie esse aplicativo.

    No Mac

    Pressione Cmd+Q no Codex e depois abra-o novamente.

    No Windows

    Feche o Codex e, se o ícone dele aparecer na bandeja do sistema, feche-o por lá também. Depois, abra-o novamente.

  5. Pergunte: Who am I in Findrix, and which sites do I have?

Agora o arquivo de configurações contém sua chave. Não o compartilhe nem o mantenha em uma pasta sincronizada ou compartilhada.

Já conectou o Codex ao Findrix antes, com uma variável FINDRIX_MCP_KEY? Substitua o trecho antigo [mcp_servers.findrix] pela nova configuração em vez de adicionar um segundo trecho.

Consultar informações e fazer alterações

Seu assistente sempre pode consultar informações. Fazer alterações (aprovar correções, adicionar prompts ou concorrentes, registrar trabalhos) exige sua permissão:

  • Conexão por login (Claude, ChatGPT): é a caixa Fazer alterações por você (fazer alterações para você) na tela do Findrix que você viu ao conectar. Para mudar essa opção, desconecte e conecte novamente.
  • Conexão com chave (Cursor, Codex): é a opção Permitir gravações (permitir gravações) ao lado da chave em MCP e conexões. Quando ela está desativada, o assistente ainda pode consultar informações, mas toda alteração é recusada com writes_disabled. Desative-a nas chaves que você entregar a outra pessoa.
  • Toda alteração feita dessa forma aparece no seu Registro de trabalho com a marca via MCP.
  • Para desfazer, peça Undo the last change em até 24 horas. Se você tiver alterado o mesmo item no painel depois disso, a ação de desfazer será recusada para preservar sua própria edição.
  • Algumas alterações não podem ser desfeitas dessa forma: editar o perfil ou a região da marca (mercados, idiomas), reformular um prompt, gerar ou importar prompts e pesquisar temas de prompts, redigir uma carta ou uma resposta para o Reddit (Obter destaque, Corrigir informações erradas), remover uma alegação proibida, pedir ao Findrix que prepare correções para suas páginas, iniciar uma auditoria e adicionar um site ou ativá-lo após o onboarding. Também não é possível desfazer a remoção de um concorrente (adicione-o novamente) nem a geração de um arquivo (ele expira por conta própria). O Findrix avisa seu assistente sempre que uma alteração não puder ser desfeita.
  • Se o assistente criar um novo link público para seu relatório de cliente, desfazer essa ação gera mais um link novo, sem recuperar o anterior.
  • Antes de qualquer ação em lote, como aprovar todas as correções, peça ao assistente que mostre a lista primeiro.
  • Seu assistente não pode iniciar uma nova medição de visibilidade nas IAs (o Findrix as executa conforme a programação) e nunca faz pagamentos: para mudar de plano, ele fornece um link de checkout para você abrir por conta própria.

Como desconectar

  • Claude: remova o Findrix em Customize → Connectors (personalizar → conectores) no Claude. Depois, em MCP e conexões no Findrix, clique em Desconectar (desconectar) ao lado dele, em Aplicativos conectados (aplicativos conectados): o acesso é interrompido imediatamente.
  • ChatGPT: remova o plugin do Findrix em ChatGPT Plugins, na seção Personal (pessoal). Depois, clique em Desconectar (desconectar) ao lado dele em Aplicativos conectados (aplicativos conectados), na página MCP e conexões.
  • Cursor ou Codex: exclua o trecho do Findrix do arquivo de configurações e depois revogue a chave em MCP e conexões. Uma chave revogada deixa de funcionar imediatamente.

Se algo não funcionar

O assistente não encontra o Findrix
Inicie uma nova conversa. O Cursor, o Codex e o aplicativo do Claude para computador só reconhecem uma nova conexão após reiniciar completamente: encerre o aplicativo, não apenas a janela, e abra-o novamente. No Cursor, confira também se o Findrix está ativado em Customize → MCPs (personalizar → MCPs). No Claude, confira se o Findrix está ativado no menu de ferramentas da conversa. No ChatGPT, digite @ e selecione o Findrix na conversa.
Todas as solicitações falham com 401 ou "Unauthorized" (não autorizado)
A chave está ausente, foi digitada incorretamente ou foi revogada. Crie uma nova chave em MCP e conexões e copie a configuração pronta novamente; não digite a chave manualmente.
plan_required
O site ou sua conta não está em um plano pago. Assine um plano para o site no Findrix ou peça ao assistente um link de checkout.
writes_disabled
As alterações estão desativadas para esta conexão. Ative Permitir gravações (permitir gravações) ao lado da chave ou desconecte o Claude ou o ChatGPT e conecte novamente com Fazer alterações por você (fazer alterações para você) marcado.
rate_limited
Houve solicitações demais em pouco tempo: aguarde pelo período indicado na mensagem. Sua conta pode fazer 120 consultas por minuto e 5,000 por dia, além de 60 alterações por minuto e 1,000 por dia, considerando todas as conexões juntas. Se o Claude e o Cursor estiverem conectados, eles compartilham esses limites; outra chave não os aumenta.
O Claude não conecta após escolher Sign in now (entrar agora)
Essa opção ainda está sendo verificada. Remova o conector e adicione-o novamente com Sign in when needed (entrar quando necessário).
Não há Add custom connector (adicionar conector personalizado) no Claude
Seu plano do Claude ou as configurações da sua organização podem não permitir conectores personalizados. Em uma conta corporativa, peça a alguém com perfil de proprietário que adicione o Findrix para a organização.
Não há Add custom MCP server (adicionar servidor MCP personalizado) no ChatGPT
Seu plano do ChatGPT ou as configurações do seu workspace podem não permitir servidores MCP personalizados. Em uma conta de trabalho, peça a um administrador que os permita.
No Codex, respostas longas são cortadas no meio
Copie novamente a configuração pronta para o Codex no Findrix: ela inclui a linha que evita esse problema.

Para desenvolvedores

Claude Code, VS Code, n8n, MCP Inspector e as APIs do Claude e da OpenAI também podem se conectar. As configurações de cada um, todas as ferramentas e suas ações, os limites e o changelog estão na referência do servidor MCP; as mesmas configurações estão em MCP e conexões na sua conta, em Conectar um cliente (conectar um cliente). O endereço do servidor é https://app.findrix.ai/api/mcp; ele aceita autenticação por login (OAuth) e chaves enviadas como Authorization: Bearer.

← AnteriorComo postar no Reddit sem ser banidoPróximo →Como corrigir uma informação errada sobre sua empresa em outro site