RankFlowSEOConnecteur MCP | inclus dans Pro

Guide d'installation

Brancher RankFlow à ton IA, en 2 minutes.

Claude, Cursor, Windsurf ou VS Code lancent de vrais audits RankFlow et corrigent tes pages avec les vraies données. Colle ta clé dans la carte blanche, choisis ton application, copie l'extrait. C'est tout.

Node.js 18 ou plus
Une clé RankFlow Pro, Expert ou Agency

Ta clé RankFlow

Elle remplit tous les extraits de la page. Elle reste dans ton navigateur : rien n'est envoyé, rien n'est enregistré.

Colle ta clé

Les extraits ci-dessous portent TA_CLE tant que rien n'est saisi.

Où la trouver ? Dans l'extension Chrome, onglet de ta formule (RankFlow Pro, RankFlow Expert ou RankFlow Agency), ou dans l'email reçu après ton paiement. Le connecteur s'ouvre au premier paiement encaissé : pendant l'essai, l'extension fonctionne, le connecteur attend.

Claude Desktop et Claude Code sont 2 applications différentes

Même nom, même compte, mais 2 programmes séparés, chacun avec son propre fichier de configuration et ses propres autorisations. Installer le connecteur dans l'un ne l'installe pas dans l'autre, et l'autorisation accordée dans l'un ne vaut pas dans l'autre. C'est le point qui a fait perdre le plus de temps aux premiers utilisateurs.

Claude Desktop : l'application avec une fenêtre de discussion. Un fichier JSON à modifier, un redémarrage.
Claude Code : l'assistant dans le terminal. Une commande, avec --scope user pour qu'elle vaille partout.
Tu utilises les 2 ? Fais les 2 installations, 2 minutes chacune. Cursor, Windsurf et VS Code ont aussi chacun la leur.

Avant de commencer

2 prérequis, et un seul est technique.

Node.js, version 18 ou plus

Le connecteur se lance avec npx, qui vient avec Node.js. Vérifie dans un terminal : node -v. Rien ne s'affiche ou la version est inférieure à 18 ? Installe la version LTS depuis nodejs.org, avec l'installateur officiel.

Pourquoi l'installateur officiel : Claude Desktop et Cursor cherchent npx dans les emplacements standard. Un Node.js installé par nvm peut être invisible pour eux (voir le dépannage).

Une clé RankFlow Pro, Expert ou Agency, ouverte au connecteur

Ta clé est dans l'extension Chrome, onglet de ta formule (RankFlow Pro, RankFlow Expert ou RankFlow Agency), et dans l'email de bienvenue. Elle commence par rf_.

Le connecteur s'ouvre au premier paiement encaissé, à la fin de l'essai. Tu ne veux pas attendre ? Dans l'onglet RankFlow Pro, le bouton Activer maintenant termine l'essai et ouvre le connecteur dans la foulée.

Installation

Choisis ton application, suis les étapes.

Chaque extrait porte ta clé si tu l'as collée en haut de la page. Le nom du connecteur est toujours rankflow-seo, l'outil qu'il ajoute à ton IA s'appelle rankflow_audit_page.

Claude Desktop

l'application de bureau

L'application Claude que tu ouvres depuis ton Dock ou ton menu Démarrer. Elle lit un fichier de configuration : tu y colles un bloc, tu relances l'application, c'est tout. Ce que tu installes ici n'existe pas dans Claude Code, et inversement.

Ouvre le fichier de configuration

Dans Claude Desktop : menu Réglages (ou Settings), onglet Développeur, bouton Modifier la configuration. Le fichier s'ouvre dans ton éditeur. Il s'appelle claude_desktop_config.json et il vit ici :

macOS~/Library/Application Support/Claude/claude_desktop_config.json

Windows%APPDATA%\Claude\claude_desktop_config.json

Colle ce bloc

Si le fichier contient déjà un mcpServers avec d'autres connecteurs, ajoute seulement la partie "rankflow-seo" à l'intérieur, sans dupliquer mcpServers. Une virgule oubliée entre 2 connecteurs suffit à tout bloquer.

{ "mcpServers": { "rankflow-seo": { "command": "npx", "args": ["-y", "rankflow-mcp"], "env": { "RANKFLOW_LICENSE_KEY": "TA_CLE" } } } }

Quitte Claude Desktop complètement, puis rouvre-le

Fermer la fenêtre ne suffit pas : Claude continue de tourner et ne relit pas le fichier. Sur Mac, Cmd Q. Sur Windows, clic droit sur l'icône de Claude près de l'horloge (ouvre la flèche ^ si tu ne la vois pas), puis Quitter. Au redémarrage, l'icône des outils (le petit marteau ou la prise, sous la zone de saisie) liste rankflow-seo.

Autorise l'outil à la première demande

Écris « Audite https://mon-site.fr avec RankFlow ». Claude Desktop demande l'autorisation d'utiliser rankflow_audit_page : choisis Autoriser pour cette discussion ou Toujours autoriser. Cette autorisation est propre à Claude Desktop : Claude Code te la redemandera de son côté.

C'est branché quand l'icône des outils affiche rankflow-seo et que la première demande d'audit renvoie un score sur 100 avec son plan d'action.

Claude Code

le terminal

L'assistant en ligne de commande. Une seule commande suffit, mais elle a un piège : sans --scope user, le connecteur n'est installé que dans le dossier où tu tapes la commande, et il « disparaît » dès que tu ouvres un autre projet.

Tape cette commande dans ton terminal

Avec --scope user, le connecteur est disponible dans tous tes projets. La clé part dans la variable d'environnement RANKFLOW_LICENSE_KEY.

claude mcp add --scope user rankflow-seo -e RANKFLOW_LICENSE_KEY=TA_CLE -- npx -y rankflow-mcp

Relance Claude Code, puis vérifie

Dans une nouvelle session, tape /mcp : rankflow-seo doit apparaître avec l'état connecté. S'il est marqué en échec, la ligne d'erreur dit pourquoi, en général Node.js absent.

Autorise l'outil à la première demande

Demande « Audite https://mon-site.fr avec RankFlow ». Claude Code affiche une demande d'autorisation pour rankflow_audit_page : accepte, éventuellement « pour toujours ». Cette autorisation ne vaut que pour Claude Code. Si tu utilises aussi Claude Desktop, refais l'installation de l'onglet Claude Desktop.

C'est branché quand /mcp montre rankflow-seo connecté et que l'audit renvoie un score sur 100.

Cursor

l'éditeur

Cursor lit ses connecteurs dans un fichier mcp.json. Le même bloc que Claude Desktop fonctionne tel quel. Global ou par projet, à toi de choisir.

Ouvre le fichier de configuration

Réglages (Cmd , ou Ctrl ,), section MCP, puis Add new global MCP server. Cursor ouvre le fichier :

Global~/.cursor/mcp.json

Par projet.cursor/mcp.json à la racine du projet

Colle ce bloc

{ "mcpServers": { "rankflow-seo": { "command": "npx", "args": ["-y", "rankflow-mcp"], "env": { "RANKFLOW_LICENSE_KEY": "TA_CLE" } } } }

Vérifie le voyant

De retour dans Réglages, MCP, la ligne rankflow-seo passe au vert et liste l'outil rankflow_audit_page. Un voyant rouge signale presque toujours Node.js absent ou une virgule de trop dans le fichier.

Utilise le mode Agent

Dans le chat, mode Agent, demande « Audite https://mon-site.fr avec RankFlow ». Cursor demande confirmation avant d'appeler l'outil : accepte.

C'est branché quand la ligne rankflow-seo est verte dans les réglages MCP et que l'agent renvoie le score sur 100.

Windsurf

l'éditeur

Windsurf lit ses connecteurs dans mcp_config.json, avec le même format que Claude Desktop.

Ouvre le fichier de configuration

Dans Windsurf : icône MCP en haut à droite du panneau Cascade, puis Configure. Ou directement :

Fichier~/.codeium/windsurf/mcp_config.json

Colle ce bloc

{ "mcpServers": { "rankflow-seo": { "command": "npx", "args": ["-y", "rankflow-mcp"], "env": { "RANKFLOW_LICENSE_KEY": "TA_CLE" } } } }

Rafraîchis les connecteurs

Dans le panneau MCP, clique sur Refresh : rankflow-seo apparaît avec son outil. Puis, dans Cascade, demande un audit et accepte l'appel de l'outil.

C'est branché quand rankflow-seo apparaît dans le panneau MCP de Cascade et que l'audit renvoie le score sur 100.

VS Code

avec GitHub Copilot

VS Code utilise les connecteurs MCP dans le mode Agent de Copilot Chat. Le format diffère légèrement : la clé racine est servers, pas mcpServers.

Crée le fichier

À la racine de ton projet, crée .vscode/mcp.json (ou Réglages, MCP, Add Server pour une configuration globale).

Colle ce bloc

{ "servers": { "rankflow-seo": { "type": "stdio", "command": "npx", "args": ["-y", "rankflow-mcp"], "env": { "RANKFLOW_LICENSE_KEY": "TA_CLE" } } } }

Démarre le serveur et passe en mode Agent

Un bouton Start apparaît au-dessus du bloc dans le fichier : clique. Puis, dans Copilot Chat, choisis le mode Agent, demande un audit RankFlow et Continue quand VS Code demande l'autorisation d'appeler l'outil.

C'est branché quand l'outil rankflow_audit_page est listé dans les outils du mode Agent et que l'audit renvoie le score sur 100.

Sources et références

Accès : envoi de la clé par email dès l'inscription, rien à livrer. Conditions : conditions générales de vente, remboursement et retours, confidentialité. Page mise à jour le 26 octobre 2026.

Premier essai

Parle-lui normalement.

Il n'y a aucune formule à retenir. Donne une URL, dis ce que tu veux, ton IA appelle RankFlow et travaille sur les vraies mesures.

Pour commencer

« Audite https://mon-site.fr/ma-page avec RankFlow et donne-moi les 3 corrections qui rapportent le plus de points. »

Avec un mot-clé

« Audite cette page sur le mot-clé « plombier montpellier » et liste les termes du top 10 qui manquent. »

En série

« Audite les 30 pages de mon sitemap, sors-moi les 10 pires et réécris leurs balises title. »

Dépannage

Si ça coince, c'est presque toujours l'un de ces 8 cas.

Installé dans Claude Code, invisible dans Claude Desktop

ou l'inverse

Ce sont 2 applications. Chacune a sa propre installation et sa propre autorisation. Refais l'installation dans la seconde application, c'est l'affaire de 2 minutes.

Le connecteur disparaît quand je change de projet

Claude Code

La commande a été tapée sans --scope user : le connecteur n'est installé que dans le dossier d'origine. Relance la commande de l'onglet Claude Code, avec --scope user.

Le serveur ne démarre pas

spawn npx ENOENT, command not found

Node.js n'est pas installé, ou l'application ne le trouve pas. Installe la version LTS depuis nodejs.org. Si Node vient de nvm, remplace "command": "npx" par le chemin complet donné par which npx dans ton terminal.

Claude Desktop ne montre rien après le redémarrage

aucun outil, aucune erreur

2 causes sur 3 : l'application a été fermée mais pas quittée (Cmd Q sur Mac ; sur Windows, clic droit sur l'icône de Claude près de l'horloge, puis Quitter), ou le fichier JSON contient une virgule de trop ou de moins. Colle le fichier dans un validateur JSON, corrige, quitte, rouvre.

« L'accès MCP s'ouvre au premier paiement encaissé »

trial_pending

Ta clé est en période d'essai. Le connecteur s'ouvre automatiquement au premier paiement, à la fin de l'essai. Pour l'ouvrir tout de suite, bouton Activer maintenant dans l'onglet RankFlow Pro de l'extension.

« Cette clé est déjà activée sur le nombre maximum d'appareils »

device_limit

Ta clé est déjà active sur d'autres appareils. Pour transférer une place : extension RankFlow, section Licence, recolle ta clé et clique Libérer mes autres appareils s'il s'affiche. S'il ne s'affiche pas, écris à [email protected] : je libère dans la foulée. Besoin de plus de postes ? Une clé Pro en compte 2, RankFlow Expert 3, RankFlow Agency 5, pour l'extension et le connecteur. Tu changes de formule depuis l'extension, au prorata.

« Clé de licence invalide »

invalid_key

La clé a été recopiée à la main ou tronquée. Retourne dans l'onglet RankFlow Pro de l'extension, utilise le bouton Copier, et vérifie qu'il ne reste ni espace ni guillemet en trop autour.

Windows : le fichier de Claude Desktop est introuvable

%APPDATA%

Dans l'explorateur, tape %APPDATA%\Claude dans la barre d'adresse. Si le fichier claude_desktop_config.json n'existe pas encore, crée-le avec le bloc de l'onglet Claude Desktop.

Vie privée

Ce qui sort de ta machine, et ce qui n'en sort jamais.

Autant le dire clairement, surtout si tu audites des sites clients.

Envoyé à RankFlow à chaque audit

ta clé de licence, pour vérifier tes droits ;
l'URL auditée et le score obtenu ;
un identifiant d'appareil anonyme, pour reconnaître tes appareils, sans nom de machine ni nom d'utilisateur.

Jamais envoyé

le contenu des pages auditées ;
le détail de l'analyse ;
tes fichiers, tes conversations avec l'IA.

Ta clé est en clair dans le fichier de configuration : c'est normal, mais elle vaut ton abonnement. Ne partage pas ce fichier, floute-la sur une capture d'écran. Détail dans la politique de confidentialité de l'extension.

Encore bloqué ?

Écris-moi, avec la ligne d'erreur.

Une capture de l'erreur ou du fichier de configuration (clé floutée) et je te réponds avec le geste exact. Tu n'as pas encore d'abonnement ? Le connecteur est inclus dans RankFlow Pro (2 postes), RankFlow Expert (3 postes) et RankFlow Agency (5 postes).

[email protected]

Découvrir RankFlow Pro | Découvrir RankFlow Expert | Découvrir RankFlow Agency | Voir la roadmap