Base de connaissances

Connectez Findrix à votre assistant IA

Une fois la connexion établie, vous pouvez demander à votre assistant IA comment votre marque apparaît dans les réponses des IA, quoi corriger ensuite ou un rapport PDF : il récupère les réponses depuis votre compte Findrix. Avec Claude ou ChatGPT, quelques minutes suffisent, sans clé ni fichier de configuration.

Avant de commencer

  • Un compte Findrix avec au moins un site sur une offre payante (Presence ou supérieure). Sans cela, votre assistant peut seulement vous indiquer votre identité dans Findrix.
  • L’application d’assistant que vous souhaitez utiliser, avec une session ouverte. Si votre compte Claude appartient à une entreprise (Claude Team ou Enterprise), un propriétaire devra peut-être d’abord ajouter Findrix pour toute l’organisation.
  • Quelques minutes : environ deux pour Claude, environ trois pour ChatGPT, environ cinq pour Cursor ou Codex.

Claude : claude.ai et l’application de bureauRecommandé

La méthode la plus simple. Vous vous connectez avec votre compte Findrix : aucune clé à copier et rien à installer. La procédure est identique sur Mac et Windows, dans le navigateur comme dans l’application de bureau Claude.

Ajouter Findrix à Claude

Ouvre claude.ai avec le nom et l’adresse du serveur renseignés. Adresse du serveur :

https://app.findrix.ai/api/mcp
  1. Cliquez sur Add Findrix to Claude ci-dessus. Claude ouvre le formulaire Add custom connector, avec le nom et l’adresse du serveur déjà renseignés. Pour l’ajouter manuellement, ouvrez Customize → Connectors → Add custom connector dans Claude et collez l’adresse du serveur https://app.findrix.ai/api/mcp.

  2. Si la section Request headers apparaît, laissez-la vide. La plupart des comptes Claude n’ont pas cette section ; si c’est votre cas, passez cette étape.

  3. Sous Authentication, choisissez Sign in when needed.

  4. Sous OAuth client, choisissez Use Claude’s published identity. Ne sélectionnez pas Register automatically : Findrix ne le prend pas en charge et la connexion échouera.

  5. Cliquez sur Add.

    Formulaire Add custom connector de Claude : Request headers, présent seulement sur certains comptes, laissé vide ; Sign in when needed ; Use Claude’s published identity ; puis Add. Illustration — votre écran peut être légèrement différent.
  6. Ouvrez une nouvelle conversation et demandez : Who am I in Findrix, and which sites do I have? Claude vous invite à connecter Findrix. Cliquez sur Connect, connectez-vous à Findrix, puis cliquez sur Autoriser sur l’écran Autoriser l’accès.

    L’écran Findrix qui s’ouvre lors de la connexion de Claude : gardez Effectuer des modifications pour vous coché pour autoriser Claude à effectuer des modifications, puis cliquez sur Allow. Illustration — votre écran peut être légèrement différent.

Laissez Effectuer des modifications pour vous coché si Claude doit approuver des corrections, ajouter des prompts ou consigner des travaux pour vous. Décochez cette option pour limiter Claude à la lecture.

Le formulaire de Claude varie selon les comptes. Si le vôtre affiche le nom, l’adresse du serveur et Advanced settings sur un même écran, aucun choix n’est nécessaire : laissez Advanced settings vide et cliquez sur Add.

L’offre Free de Claude permet d’ajouter un seul connecteur personnalisé. Si vous en avez déjà un autre, supprimez-le dans Customize → Connectors avant d’ajouter Findrix.

Vous utilisez l’application de bureau Claude ? Un connecteur ajouté sur claude.ai y apparaît automatiquement avec le même compte Claude. Vous pouvez aussi l’ajouter depuis les paramètres de l’application de bureau, dans Connectors, en faisant les mêmes choix.

Vous êtes propriétaire d’une organisation Claude Team ou Enterprise ? Ajoutez Findrix pour tout le monde dans Organization settings → Connectors.

ChatGPT

Comme Claude, ChatGPT utilise votre compte Findrix pour se connecter : aucune clé à copier et rien à installer. Vous ajoutez Findrix une seule fois, sur chatgpt.com dans votre navigateur.

  1. Ouvrez ChatGPT Plugins, cliquez sur Add et choisissez Add custom MCP server.

  2. Nommez-le Findrix. Sous Connection, collez l’adresse du serveur https://app.findrix.ai/api/mcp dans Server URL.

  3. Pour l’authentification, choisissez OAuth. Laissez l’identifiant client et le secret vides : ChatGPT se connecte à Findrix automatiquement.

  4. Cliquez sur I understand and want to continue, puis sur Create as a plugin, et installez le plugin.

  5. Lorsque ChatGPT vous le demande, connectez-vous à Findrix, puis cliquez sur Autoriser sur l’écran Autoriser l’accès.

  6. Ouvrez une nouvelle conversation, saisissez @, sélectionnez Findrix et demandez : Who am I in Findrix, and which sites do I have?

Laissez Effectuer des modifications pour vous coché si ChatGPT doit approuver des corrections, ajouter des prompts ou consigner des travaux pour vous. Décochez cette option pour limiter ChatGPT à la lecture. Dans les deux cas, ChatGPT vous demande votre accord avant chaque modification.

Vous utilisez ChatGPT au travail (Business ou Enterprise) ? Un administrateur devra peut-être d’abord autoriser les serveurs MCP personnalisés dans votre espace de travail.

Vérifiez que la connexion fonctionne

Demandez à votre assistant Who am I in Findrix, and which sites do I have? Il doit répondre avec votre adresse e-mail, votre offre et la liste de vos sites. Si c’est le cas, Findrix est connecté.

Une première question dans une nouvelle conversation et le type de réponse qui confirme que Findrix est connecté. Illustration — votre écran peut être légèrement différent.

Essayez ensuite l’une de ces demandes :

  • Comment yourbrand.com apparaît-il dans les réponses des IA ce mois-ci ?
  • Quels concurrents les moteurs d’IA mentionnent-ils à notre place ?
  • Que dois-je corriger en premier sur ma page d’accueil ?
  • Qu’est-ce qui a changé cette semaine et qu’est-ce qui attend ma décision ?
  • Crée un rapport PDF sur notre visibilité dans les IA.
  • Montre-moi les corrections prêtes à être approuvées, puis approuve-les.

Désignez votre site par son nom de domaine. Si vous en avez plusieurs, précisez lequel dans votre premier message : l’assistant s’en souviendra pendant toute la conversation.

Cursor et Codex : commencez par obtenir une clé

Cursor et Codex se connectent avec une clé Findrix, un long mot de passe destiné à une seule application. Vous la créez dans votre compte Findrix, puis Findrix vous fournit la configuration complète à coller, avec la clé déjà intégrée.

  1. Ouvrez MCP et connexions dans votre compte Findrix (Compte → MCP et connexions).

  2. Créez une clé et donnez-lui le nom de l’application, par exemple Cursor. Un compte peut avoir jusqu’à cinq clés.

  3. Findrix affiche la clé une seule fois, avec une configuration prête à l’emploi. Sous Configurez un client avec cette clé, sélectionnez votre application et votre système (macOS / Linux ou Windows), puis cliquez sur Copier. Gardez la page ouverte jusqu’à ce que vous ayez collé la configuration.

    Juste après la création d’une clé, Findrix l’affiche une seule fois avec une configuration prête à l’emploi : sous Configurez un client avec cette clé, choisissez votre application et votre système, puis cliquez sur Copy. Illustration — votre écran peut être légèrement différent.

Traitez la clé comme un mot de passe : ne la collez pas dans une conversation avec l’assistant et ne l’envoyez pas par e-mail. Si elle est divulguée, révoquez-la sur la même page et créez-en une nouvelle.

Cursor

  1. Obtenez une clé avec la configuration prête à l’emploi pour Cursor (ci-dessus), puis cliquez sur Copier.

  2. Ouvrez le fichier de configuration MCP de Cursor, mcp.json.

    Sur Mac

    Ouvrez Terminal (appuyez sur Cmd+Space, saisissez Terminal, puis appuyez sur Retour), collez cette ligne et appuyez sur Retour. Le fichier s’ouvre dans Cursor.

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

    Sur Windows

    Appuyez sur Win+R, collez cette ligne et appuyez sur Entrée. Si Notepad vous propose de créer le fichier, cliquez sur Yes. Si le chemin est introuvable, ouvrez Cursor une fois, fermez-le et réessayez.

    notepad %USERPROFILE%\.cursor\mcp.json
  3. Si le fichier est vide ou contient seulement {'}, sélectionnez tout son contenu et collez la configuration. S’il répertorie déjà d’autres serveurs, collez uniquement la partie "findrix": { … } dans "mcpServers", en ajoutant une virgule entre celle-ci et le serveur précédent.

    Le fichier mcp.json de Cursor après collage : une entrée findrix avec l’adresse du serveur et votre clé. Illustration — votre écran peut être légèrement différent.
  4. Enregistrez le fichier.

    Sur Mac

    Appuyez sur Cmd+S.

    Sur Windows

    Appuyez sur Ctrl+S.

  5. Quittez complètement Cursor et rouvrez-le. Cliquez sur Customize dans la barre latérale, puis sur MCPs (dans les versions antérieures à 3.9 : Cursor Settings → Tools & MCP). Findrix apparaît dans la liste et est activé. S’il n’apparaît pas ou affiche une erreur, ouvrez le panneau Output et sélectionnez MCP Logs pour en connaître la cause.

    Sur Mac

    Appuyez sur Cmd+Q pour quitter. Cmd+Shift+U ouvre le panneau Output.

    Sur Windows

    Fermez toutes les fenêtres Cursor pour quitter. Ctrl+Shift+U ouvre le panneau Output.

  6. Ouvrez une nouvelle conversation et demandez : Who am I in Findrix, and which sites do I have?

Codex

L’application Codex, la ligne de commande Codex et l’extension Codex pour VS Code ou Cursor partagent un seul fichier de configuration : vous configurez donc Findrix une seule fois pour les trois.

  1. Obtenez une clé avec la configuration prête à l’emploi pour Codex (ci-dessus), puis cliquez sur Copier.

  2. Ouvrez le fichier de configuration de Codex.

    Sur Mac

    Ouvrez Terminal (appuyez sur Cmd+Space, saisissez Terminal, puis appuyez sur Retour), collez cette ligne et appuyez sur Retour. Le fichier s’ouvre dans TextEdit.

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

    Sur Windows

    Appuyez sur Win+R, collez cette ligne et appuyez sur Entrée. Si Notepad vous propose de créer le fichier, cliquez sur Yes. Si le chemin est introuvable, ouvrez Codex une fois, fermez-le et réessayez.

    notepad %USERPROFILE%\.codex\config.toml
  3. Collez la configuration à la fin du fichier et enregistrez-le.

    Le fichier config.toml de Codex après collage : la configuration commence par [mcp_servers.findrix]. Illustration — votre écran peut être légèrement différent.
  4. Quittez complètement Codex et relancez-le. Vous utilisez Codex dans VS Code ou Cursor ? Redémarrez cette application.

    Sur Mac

    Appuyez sur Cmd+Q dans Codex, puis rouvrez-le.

    Sur Windows

    Fermez Codex, ainsi que son icône dans la zone de notification si elle y figure. Puis rouvrez-le.

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

Le fichier de configuration contient maintenant votre clé. Ne le partagez pas et ne le conservez pas dans un dossier synchronisé ou partagé.

Vous aviez déjà connecté Codex à Findrix avec une variable FINDRIX_MCP_KEY ? Remplacez l’ancienne partie [mcp_servers.findrix] par la nouvelle configuration au lieu d’en ajouter une seconde.

Lire et effectuer des modifications

Votre assistant peut toujours lire les données. Les modifications (approuver des corrections, ajouter des prompts ou des concurrents, consigner des travaux) nécessitent votre autorisation :

  • Connexion par authentification (Claude, ChatGPT) : il s’agit de la case Effectuer des modifications pour vous sur l’écran Findrix affiché lors de la connexion. Pour modifier ce choix, déconnectez-vous et reconnectez-vous.
  • Connexion avec une clé (Cursor, Codex) : il s’agit de l’interrupteur Autoriser les écritures à côté de la clé sur MCP et connexions. Lorsqu’il est désactivé, l’assistant peut toujours lire, mais toute modification est refusée avec writes_disabled. Désactivez-le pour une clé que vous confiez à quelqu’un d’autre.
  • Chaque modification effectuée de cette façon apparaît dans votre Journal d’activité avec la mention via MCP.
  • Pour annuler, demandez Undo the last change dans les 24 heures. Si vous avez ensuite modifié le même élément dans le tableau de bord, l’annulation est refusée afin de conserver votre propre modification.
  • Certaines modifications ne peuvent pas être annulées ainsi : modifier le profil de votre marque ou sa région (marchés, langues), reformuler un prompt, générer ou importer des prompts et rechercher des thèmes de prompts, rédiger une lettre ou une réponse Reddit (Être mentionné, Corriger les informations erronées), supprimer une affirmation interdite, demander à Findrix de préparer des corrections pour vos pages, lancer un audit, ajouter un site ou le lancer après l’intégration. Il en va de même pour un concurrent supprimé (ajoutez-le à nouveau) ou un fichier généré (il expire automatiquement). Findrix informe votre assistant chaque fois qu’une modification ne peut pas être annulée.
  • Si l’assistant a créé un nouveau lien public vers votre rapport client, son annulation génère encore un nouveau lien et ne rétablit pas l’ancien.
  • Avant toute opération en masse, comme approuver toutes les corrections, demandez à l’assistant de vous montrer la liste.
  • Votre assistant ne peut pas lancer une nouvelle mesure de visibilité dans les IA (Findrix les exécute selon un calendrier) et ne paie jamais rien : pour changer d’offre, il vous fournit un lien de paiement à ouvrir vous-même.

Se déconnecter

  • Claude : supprimez Findrix dans Customize → Connectors dans Claude. Ensuite, sur MCP et connexions dans Findrix, cliquez sur Déconnecter à côté du connecteur dans Applications connectées : l’accès est immédiatement coupé.
  • ChatGPT : supprimez le plugin Findrix sur ChatGPT Plugins, dans Personal. Cliquez ensuite sur Déconnecter à côté du plugin dans Applications connectées sur MCP et connexions.
  • Cursor ou Codex : supprimez la partie Findrix du fichier de configuration, puis révoquez la clé sur MCP et connexions. Une clé révoquée cesse de fonctionner immédiatement.

En cas de problème

L’assistant ne voit pas Findrix
Ouvrez une nouvelle conversation. Cursor, Codex et l’application de bureau Claude ne détectent une nouvelle connexion qu’après un redémarrage complet : quittez l’application, pas seulement sa fenêtre, puis rouvrez-la. Dans Cursor, vérifiez aussi que Findrix est activé dans Customize → MCPs. Dans Claude, vérifiez que Findrix est activé dans le menu des outils de la conversation. Dans ChatGPT, saisissez @ et sélectionnez Findrix dans la conversation.
Chaque requête échoue avec 401 ou « Unauthorized »
La clé est absente, mal saisie ou révoquée. Créez une nouvelle clé sur MCP et connexions et copiez à nouveau la configuration prête à l’emploi ; ne ressaisissez pas la clé manuellement.
plan_required
Le site ou votre compte ne bénéficie pas d’une offre payante. Souscrivez une offre pour le site dans Findrix, ou demandez un lien de paiement à l’assistant.
writes_disabled
Les modifications sont désactivées pour cette connexion. Activez Autoriser les écritures à côté de la clé, ou déconnectez Claude ou ChatGPT et reconnectez-vous avec Effectuer des modifications pour vous coché.
rate_limited
Trop de requêtes en peu de temps : attendez la durée indiquée dans le message. Votre compte peut effectuer 120 lectures par minute et 5,000 par jour, ainsi que 60 modifications par minute et 1,000 par jour, toutes connexions confondues. Si Claude et Cursor sont tous deux connectés, ils partagent ces limites ; une clé supplémentaire ne les augmente pas.
Claude ne se connecte pas après avoir choisi Sign in now
Cette option est encore en cours de vérification. Supprimez le connecteur et ajoutez-le à nouveau en choisissant Sign in when needed.
L’option Add custom connector n’apparaît pas dans Claude
Votre offre Claude ou les paramètres de votre organisation n’autorisent peut-être pas les connecteurs personnalisés. Pour un compte d’entreprise, demandez à un propriétaire d’ajouter Findrix pour l’organisation.
L’option Add custom MCP server n’apparaît pas dans ChatGPT
Votre offre ChatGPT ou les paramètres de votre espace de travail n’autorisent peut-être pas les serveurs MCP personnalisés. Pour un compte professionnel, demandez à un administrateur de les autoriser.
Dans Codex, les réponses longues sont coupées au milieu
Copiez à nouveau la configuration prête à l’emploi pour Codex depuis Findrix : elle contient la ligne qui évite ce problème.

Pour les développeurs

Claude Code, VS Code, n8n, MCP Inspector et les API Claude et OpenAI peuvent aussi se connecter. Les configurations de chacun, tous les outils et leurs actions, les limites et le journal des modifications figurent dans la référence du serveur MCP ; les mêmes configurations sont disponibles sur MCP et connexions dans votre compte, sous Connecter un client. L’adresse du serveur est https://app.findrix.ai/api/mcp ; il accepte l’authentification (OAuth) et les clés envoyées via Authorization: Bearer.