Connecter Crawlens à Claude et aux autres outils IA
Crawlens intègre un serveur MCP. Une fois connecté, l’application IA que vous utilisez déjà peut lire vos crawls et vos audits, expliquer les problèmes, prioriser les corrections et rédiger des tickets. Le tout avec votre propre abonnement IA, sans clé API.
L’interface de Crawlens n’existe pour l’instant qu’en anglais. Les noms des réglages, boutons, outils et prompts restent donc en anglais ici, pour que vous les retrouviez tout de suite dans l’application.
À quoi il sert
MCP (Model Context Protocol) est la façon standard dont les applications IA utilisent des outils externes. Quand votre application IA a besoin de données de Crawlens, elle lance le serveur MCP de Crawlens sur votre ordinateur. Le serveur lit vos crawls et audits enregistrés et renvoie des résultats compacts, paginés.
- Lecture seule. Il ne peut ni lancer de crawl, ni modifier les réglages, ni rien supprimer.
- Local. Il tourne sur votre ordinateur et n’ouvre aucun port réseau. Crawlens lui-même n’envoie rien en ligne.
- Crawlens n’a pas besoin d’être ouvert. L’application IA démarre le serveur à la demande avec l’environnement d’exécution de Crawlens. Inutile d’installer Node.js.
1. L’activer dans Crawlens
Le partage est désactivé par défaut. Les outils IA ne voient rien tant que vous ne l’activez pas.
- Ouvrez Crawlens et allez dans Settings → Integrations → AI tools (MCP).
- Activez Share audits with AI tools.
- Sous Projects AI tools can read, gardez All projects, ou choisissez Only these projects.
- Facultatif : activez Hide Search Console and Analytics data pour que les clics, impressions, sessions et résultats d’inspection d’URL restent invisibles pour les outils IA.
Il vous faut au moins un projet avec un crawl audité. Si vous n’avez encore rien crawlé, commencez par là : d’ici là, l’IA n’a rien à lire.
2. Connecter votre outil IA
Dans la même carte de réglages, chaque application a un bouton Copy setup for. Utilisez-le : il insère les chemins exacts de votre installation. Les extraits ci-dessous montrent à quoi ressemble cette configuration, avec des chemins d’exemple.
Claude Desktop
- Cliquez sur Add to Claude Desktop.
- Quittez Claude Desktop et rouvrez-le. Fermer la fenêtre ne suffit pas : quittez l’application depuis la zone de notification de la barre des tâches.
- Dans une nouvelle conversation, ouvrez le menu des outils.
crawlensdoit y figurer.
Crawlens s’ajoute à claude_desktop_config.json en conservant vos autres serveurs MCP. Si le fichier existe déjà, Crawlens enregistre d’abord une sauvegarde datée à côté. La version classique de Claude Desktop et celle du Microsoft Store sont toutes deux prises en charge.
Vous préférez modifier la configuration vous-même ?
Ajoutez ceci à %APPDATA%\Claude\claude_desktop_config.json, en le fusionnant avec les mcpServers éventuellement présents :
{
"mcpServers": {
"crawlens": {
"command": "C:\\path\\to\\Crawlens.exe",
"args": ["C:\\path\\to\\resources\\mcp\\server.mjs", "--user-data", "C:\\Users\\you\\AppData\\Roaming\\Crawlens"],
"env": { "ELECTRON_RUN_AS_NODE": "1" }
}
}
}Claude Code
- Cliquez sur Copy setup for → Claude Code.
- Collez la commande dans un terminal et exécutez-la.
- Lancez
claudeet exécutez/mcppour vérifier quecrawlensest connecté.
La commande enregistre Crawlens pour votre compte utilisateur (--scope user), il est donc disponible dans tous vos projets :
claude mcp add crawlens --scope user --env ELECTRON_RUN_AS_NODE=1 -- "C:\path\to\Crawlens.exe" "C:\path\to\resources\mcp\server.mjs" --user-data "C:\Users\you\AppData\Roaming\Crawlens"Codex
Une seule configuration couvre la CLI Codex, l’extension pour IDE et l’application.
- Cliquez sur Copy setup for → Codex.
- Collez-la à la fin de
~/.codex/config.toml(créez le fichier s’il n’existe pas). - Redémarrez Codex.
[mcp_servers.crawlens]
command = 'C:\path\to\Crawlens.exe'
args = ['C:\path\to\resources\mcp\server.mjs', '--user-data', 'C:\Users\you\AppData\Roaming\Crawlens']
[mcp_servers.crawlens.env]
ELECTRON_RUN_AS_NODE = '1'La configuration copiée contient aussi, en commentaire, la commande codex mcp add … équivalente, si vous préférez l’exécuter.
Cursor
- Cliquez sur Copy setup for → Cursor.
- Ouvrez
~/.cursor/mcp.jsonet collez-la. Si le fichier contient déjà des serveurs, ajoutez l’entréecrawlensdans lesmcpServersexistants. - Vérifiez Cursor Settings → MCP :
crawlensdoit apparaître comme activé.
{
"mcpServers": {
"crawlens": {
"command": "C:\\path\\to\\Crawlens.exe",
"args": ["C:\\path\\to\\resources\\mcp\\server.mjs", "--user-data", "C:\\Users\\you\\AppData\\Roaming\\Crawlens"],
"env": { "ELECTRON_RUN_AS_NODE": "1" }
}
}
}VS Code
- Cliquez sur Copy setup for → VS Code.
- Collez-la dans
.vscode/mcp.jsondans votre espace de travail. Vous pouvez aussi exécuter MCP: Add Server depuis la palette de commandes. - Ouvrez Copilot Chat en mode Agent et cherchez
crawlensdans la liste des outils.
{
"servers": {
"crawlens": {
"type": "stdio",
"command": "C:\\path\\to\\Crawlens.exe",
"args": ["C:\\path\\to\\resources\\mcp\\server.mjs", "--user-data", "C:\\Users\\you\\AppData\\Roaming\\Crawlens"],
"env": { "ELECTRON_RUN_AS_NODE": "1" }
}
}
}Autres applications MCP : tout ce qui prend en charge les serveurs MCP stdio fonctionne. Utilisez la même commande, les mêmes arguments et la même variable d’environnement ELECTRON_RUN_AS_NODE=1 que ci-dessus.
3. Tester la connexion
Dans Crawlens, cliquez sur Test connection. Crawlens démarre le serveur exactement comme le fera votre application IA et indique ce qu’il a trouvé, par exemple :
Si le test réussit mais que votre application IA n’affiche pas Crawlens, le problème vient de l’application. Redémarrez-la et consultez le dépannage.
Quoi demander
Désignez votre projet par son nom ou son domaine. Vous pouvez poser vos questions en français. Quelques prompts qui marchent bien :
Résume le dernier audit Crawlens de example.com et donne-moi une liste de corrections priorisée.
Écris de nouveaux titles pour les pages qui n’en ont pas.
Explique les chaînes de redirection à notre développeur.
Qu’est-ce qui s’est dégradé depuis le dernier crawl ?
Quelles pages reçoivent des clics depuis la recherche mais renvoient des erreurs ou sont en noindex ?
Trouve les pages indexables en positions 11 à 20 et propose comment les faire passer en première page.
Outils & prompts
Voici ce que voit votre application IA. Les résultats sont paginés (50 lignes par défaut) pour que les gros sites ne saturent pas la conversation.
| Outil | Ce qu’il renvoie |
|---|---|
list_projects | Les projets partagés par Crawlens, avec leur dernier crawl. |
list_crawls | Les crawls d’un projet, du plus récent au plus ancien, avec le score de santé et le nombre de problèmes. |
get_overview | Le résumé d’un crawl audité : score de santé, problèmes par gravité, principaux problèmes, codes de statut, indexabilité, Core Web Vitals et totaux Search Console, Analytics et logs serveur quand ils existent. |
list_issues | Chaque contrôle en échec : ce qu’il signifie, comment le corriger et combien d’URL sont concernées (les plus graves en premier). |
get_issue_urls | Les URL touchées par un problème, avec le détail pour chacune. |
query_urls | Filtrer, trier et parcourir les URL crawlées comme dans le tableau des URL, colonnes Search Console, GA4 et extraction personnalisée comprises. |
get_url_details | Tout sur une URL : champs SEO, problèmes, liens, redirections, en-têtes, données structurées, HTML brut ou rendu, Core Web Vitals et données de recherche. |
compare_crawls | Ce qui a changé entre deux crawls : score de santé, problèmes nouveaux et corrigés par contrôle, et changements d’URL. |
Des prompts prêts à l’emploi apparaissent dans le menu des prompts ou des commandes slash de votre application IA, quand elle le permet :
| Prompt | Ce qu’il fait |
|---|---|
| Summarise the audit & prioritise fixes | Une synthèse du dernier audit et un plan de corrections classé par impact et par effort, avec un responsable et des URL d’exemple pour chaque point. |
| Rewrite titles & meta descriptions | De nouveaux titles (30–60 caractères) et descriptions (70–160) pour les pages qui ont des problèmes de title ou de description, chacun dans la langue de la page. |
| Explain an issue for developers | Un problème expliqué avec les vraies URL et valeurs de ce site : cause, vérification, correction et une checklist. |
Confidentialité & sécurité
- Désactivé tant que vous ne l’activez pas, et désactivable à tout moment. Le serveur refuse alors toute requête.
- Lecture seule. Le serveur ouvre vos données en lecture seule. Il ne peut ni crawler, ni modifier les réglages, ni rien supprimer.
- Aucun port réseau. Il communique avec votre application IA uniquement par l’entrée et la sortie standard, sur votre ordinateur.
- Vous choisissez ce qui est visible : tous les projets ou seulement certains, avec ou sans les données Search Console et Analytics.
Crawlens n’envoie rien en ligne, mais votre application IA envoie ce qu’elle lit à son propre service d’IA, dans le cadre de la conversation. Ce sont alors les règles de confidentialité de l’application IA qui s’appliquent : vérifiez-les avant de partager des données de clients.
Dépannage
- Crawlens n’apparaît pas dans mon application IA
- Redémarrez complètement l’application après la configuration. Claude Desktop continue de tourner dans la zone de notification : quittez-le depuis là. Pour Cursor et VS Code, vérifiez que le JSON est toujours valide après le collage : une virgule manquante rend tout le fichier inutilisable.
- « Sharing audits with AI tools is turned off »
- Activez Share audits with AI tools dans Settings → Integrations → AI tools (MCP).
- « No shared project matches … »
- Le projet ne figure pas dans la liste que les outils IA peuvent lire, ou son nom ne correspond pas. Le message d’erreur liste les projets disponibles. Ajoutez le projet sous Projects AI tools can read, ou reformulez votre question avec l’un de ces noms.
- « This project has no audited crawl yet »
- Crawlez d’abord le site dans Crawlens. L’IA lit des audits : elle a besoin d’au moins un crawl terminé et audité.
- « This data was saved by an older Crawlens »
- Ouvrez une fois le projet dans Crawlens. Ses données sont alors mises à jour et l’application IA peut de nouveau les lire.
- Ça ne marche plus depuis que j’ai déplacé ou réinstallé Crawlens
- La configuration contient le chemin de
Crawlens.exe. Copiez à nouveau la configuration depuis Crawlens (ou cliquez de nouveau sur Add to Claude Desktop) pour que les chemins soient à jour. Déplacer le dossier de données depuis Crawlens ne pose en revanche aucun problème : le serveur le suit automatiquement. - « … is not valid JSON, so Crawlens left it untouched »
- Votre
claude_desktop_config.jsoncontenait déjà une erreur de syntaxe, Crawlens ne l’a donc pas modifié. Corrigez ou supprimez le fichier, puis cliquez à nouveau sur Add to Claude Desktop.
Vous n’avez pas encore Crawlens ?
Téléchargez-le, crawlez un site, puis revenez ici pour connecter vos outils IA.