Retour au blog
Guide12 min de lecture
Cursor + Ornold MCP : guide complet d’automatisation navigateur
Connectez Cursor à Ornold MCP et automatisez les navigateurs antidetect avec l’IA. Configuration étape par étape pour Linken Sphere, Dolphin Anty et plus.
19 avr. 2026Ce que vous allez construire
À la fin de ce guide, vous aurez Cursor contrôlant des sessions de navigateur antidetect réelles — naviguant sur les pages, remplissant des formulaires, résolvant des CAPTCHA et gérant plusieurs profils — tout par le langage naturel dans le chat Cursor. Pas de scripts Playwright. Pas de sélecteurs CSS. Dites simplement à l’IA ce qu’elle doit faire.
Ce guide couvre macOS et Windows. Les étapes Linux sont les mêmes que macOS (utilisez votre gestionnaire de paquets au lieu de Homebrew).
Prérequis
- Un ordinateur exécutant macOS 12+ ou Windows 10/11
- Cursor installé (plan gratuit ou Pro)
- Un navigateur antidetect installé : Linken Sphere, Dolphin Anty, Wadex ou Vision Browser
- Une connexion Internet pour télécharger les outils et les paquets
Étape 1 — Installer Node.js
Ornold MCP s’exécute en tant que paquet Node.js. Vous avez besoin de Node.js version 20 ou supérieure.
macOS
Le moyen le plus simple est Homebrew. Si vous n’avez pas Homebrew, installez-le d’abord à partir de brew.sh. Ensuite :
brew install node@22
Windows
Téléchargez l’installateur officiel à partir de nodejs.org. Choisissez la version LTS (22.x). Exécutez l’installateur et suivez les invites. Assurez-vous que "Add to PATH" est coché.
Vérifiez l’installation en ouvrant Terminal (macOS) ou PowerShell (Windows) :
node --version
# Résultat attendu : v22.x.x ou supérieur
npm --version
# Résultat attendu : 10.x.x ou supérieur
Étape 2 — Installer Cursor
Cursor est un éditeur de code alimenté par l’IA construit sur VS Code. Il supporte MCP (Model Context Protocol) nativement, ce qui lui permet d’utiliser des outils externes comme l’automatisation de navigateur.
- Téléchargez Cursor à partir de cursor.com
- Installez et ouvrez-le
- Connectez-vous avec votre compte Cursor (le plan gratuit fonctionne pour MCP)
Si vous avez déjà Cursor installé, assurez-vous qu’il est mis à jour vers la dernière version — le support MCP a été ajouté dans les versions récentes.
Cursor Pro vous donne plus de requêtes IA par mois, mais le plan gratuit suffit pour tester l’automatisation de navigateur MCP.
Étape 3 — Créer un compte Ornold
Ornold est le pont entre les agents IA et les navigateurs antidetect. Vous avez besoin d’un compte pour obtenir un jeton API.
- Allez à mcp.ornold.com
- Cliquez sur "Register" et créez un compte avec votre e-mail
- Vérifiez votre e-mail avec le code à 6 chiffres envoyé à votre boîte de réception
- Vous arriverez au tableau de bord — vous êtes dedans !
Étape 4 — Créer un jeton API
Après l’enregistrement, le tableau de bord vous invitera à créer votre premier jeton API. Ce jeton authentifie votre connexion MCP.
- Entrez un nom pour votre jeton (par exemple, "Cursor")
- Cliquez sur "Create"
- Copiez le jeton et enregistrez-le quelque part de sûr — vous en aurez besoin à l’étape suivante
Les comptes gratuits obtiennent 1 siège, 5 résolutions de captcha (après avoir terminé la visite) et l’accès aux navigateurs standard. Mettez à niveau votre plan pour plus de capacité.
Étape 5 — Générer la configuration MCP avec l’assistant du tableau de bord
Le tableau de bord Ornold dispose d’un assistant Connect intégré qui génère la configuration MCP exacte pour votre configuration. Pas de création JSON manuelle nécessaire — choisissez simplement vos options et copiez le résultat.
Allez à l’onglet API Tokens du tableau de bord. Trouvez votre jeton et cliquez sur le bouton "Connect" à côté.
Étape de l’assistant 1 — Choisissez votre agent IA
L’assistant demande quel agent IA vous utilisez. Sélectionnez "Cursor" dans la liste. L’assistant générera la configuration au format JSON pour le mcp.json de Cursor. Les autres agents pris en charge incluent Claude Code, Codex, VS Code, Windsurf et Cline.
Étape de l’assistant 2 — Choisissez le mode d’interaction
Choisissez comment l’IA doit interagir avec les pages du navigateur :
- Mode DOM (par défaut) — L’IA lit la structure HTML de la page. Chaque élément obtient un marqueur [ref=N]. Gratuit et rapide. Idéal pour les formulaires, les pages structurées et les sites Web standard.
- Mode Vision AI — L’IA prend une capture d’écran et trouve visuellement les éléments par leur apparence. Fonctionne sur n’importe quelle page, même les interfaces basées sur canvas. Chaque analyse coûte 1 crédit de vision.
- Les deux modes — Tous les outils disponibles. L’IA choisit automatiquement la meilleure approche pour chaque action.
Commencez par le mode DOM. C’est gratuit, rapide et gère 90 % des cas d’utilisation. Vous pouvez toujours passer à "Both" plus tard si vous avez besoin d’une analyse visuelle.
Étape de l’assistant 3 — Activez les navigateurs Antidetect
Activez les navigateurs que vous utilisez et remplissez leurs détails de connexion :
- Linken Sphere — Définissez simplement le port API (par défaut : 40080). Assurez-vous que Sphere est en cours d’exécution.
- Dolphin Anty — Définissez le port local (par défaut : 3001) et collez votre jeton API Dolphin à partir de Settings → API.
- Wadex — Définissez le port API (par défaut : 8080).
- Vision Browser — Collez votre X-Token. Définissez éventuellement un port local.
Vous pouvez activer plusieurs navigateurs à la fois. La configuration MCP les inclura tous, et Cursor pourra contrôler celui qui est en cours d’exécution.
Étape de l’assistant 4 — Copiez la configuration
L’assistant génère la configuration JSON finale en fonction de vos choix. Cliquez sur "Copy" pour l’obtenir — vous la collerez dans les paramètres MCP de Cursor à l’étape suivante.
L’assistant pré-remplit vos valeurs de jeton et de port réelles — cliquez simplement sur "Copy" et collez. Aucune édition manuelle nécessaire.
Étape 6 — Ajouter Ornold MCP à Cursor
Cursor gère les serveurs MCP via un fichier de configuration JSON. Vous pouvez l’ouvrir depuis Cursor Settings → MCP → « Add new MCP server » — cela ouvre le fichier mcp.json dans l’éditeur. Cursor stocke les paramètres MCP à deux emplacements :
Si vous préférez éditer le fichier de configuration directement, Cursor stocke les paramètres MCP dans :
# Global (tous les projets)
~/.cursor/mcp.json
# Par projet (ce projet uniquement)
.cursor/mcp.json
Collez la configuration de l’assistant. Voici à quoi cela ressemble pour Linken Sphere :
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--linken-port", "40080"]
}
}
}
Pour Dolphin Anty :
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--dolphin-port", "3001", "--dolphin-token", "YOUR_DOLPHIN_TOKEN"]
}
}
}
Pour plusieurs navigateurs à la fois :
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": [
"ornold-mcp",
"--token", "YOUR_TOKEN",
"--linken-port", "40080",
"--dolphin-port", "3001",
"--dolphin-token", "DOLPHIN_KEY",
"--wadex-port", "8080"
]
}
}
}
Utilisez ~/.cursor/mcp.json pour la configuration globale (disponible dans tous les projets). Utilisez .cursor/mcp.json à la racine du projet pour partager la configuration avec votre équipe via le contrôle de version.
Étape 7 — Démarrez votre navigateur et testez
Assurez-vous que votre navigateur antidetect est en cours d’exécution avant d’utiliser le chat IA de Cursor. Liste de contrôle rapide :
- Linken Sphere — Ouvrez l’application. Créez au moins une session si vous n’en avez pas.
- Dolphin Anty — Ouvrez l’application. Assurez-vous que l’API locale est activée dans les paramètres.
- Wadex — Ouvrez l’application et vérifiez que le port API correspond à votre configuration.
Ouvrez n’importe quel projet dans Cursor et démarrez un chat avec l’IA (Cmd+L ou Ctrl+L). Assurez-vous que vous utilisez le mode Agent — c’est là que les outils MCP sont disponibles.
Étape 8 — Votre première commande de navigateur IA
Tout est connecté. Ouvrez le chat Cursor et parlez-lui en langage naturel. Voici quelques commandes à essayer :
# Démarrez une session Linken Sphere et naviguez
> Start a new Linken Sphere session and open google.com
# Remplissez un formulaire
> Go to example.com/signup, fill in email "test@mail.com" and password "SecurePass123", then click Sign Up
# Résolvez un CAPTCHA
> There's a CAPTCHA on this page, solve it
# Prenez une capture d’écran pour l’analyse visuelle
> Take a screenshot of the current page and describe what you see
# Travaillez avec plusieurs sessions
> Start 3 Linken Sphere sessions and open google.com in all of them
Outils MCP disponibles
Une fois connecté, Cursor a accès à 40+ outils d’automatisation de navigateur. Voici les plus couramment utilisés :
- linken_start_instances / dolphin_start_profiles — Démarrez les sessions de navigateur
- browser_parallel_navigate — Ouvrez les URL dans tous les navigateurs actifs
- browser_parallel_snapshot — Obtenez le DOM de la page avec les marqueurs [ref=N] cliquables
- browser_parallel_click — Cliquez sur les éléments par ref ou sélecteur
- browser_parallel_fill — Tapez du texte dans les champs d’entrée
- browser_parallel_screenshot — Capturez les captures d’écran de toutes les sessions
- browser_parallel_vision_analyze_grouped — Analyse de page visuelle alimentée par l’IA
- browser_solve_captcha — Résolvez automatiquement reCAPTCHA, hCaptcha, Turnstile et plus
- browser_parallel_evaluate — Exécutez JavaScript dans le contexte de la page
- linken_stop_instances / dolphin_stop_profiles — Fermez les sessions
Vous n’avez pas besoin de mémoriser les noms des outils. Décrivez simplement ce que vous voulez en anglais simple et Cursor choisira automatiquement les bons outils.
Modes d’interaction
Ornold MCP supporte deux modes d’interaction. Vous pouvez choisir lors de la configuration :
Mode DOM (par défaut, gratuit)
L’IA lit la structure de la page via les snapshots DOM. Chaque élément obtient un marqueur [ref=N]. Rapide et ne coûte aucun crédit de vision. Idéal pour les pages structurées avec du HTML clair.
Mode Vision AI (payant par analyse)
L’IA prend une capture d’écran et utilise l’analyse visuelle pour trouver les éléments par leur apparence. Fonctionne sur n’importe quelle page, même les SPA complexes ou les interfaces basées sur canvas. Chaque analyse coûte 1 crédit de vision.
Pour activer les deux modes, ajoutez l’indicateur --mode à vos arguments de configuration MCP :
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--mode", "both", "--linken-port", "40080"]
}
}
}
Mode Agent Cursor vs Mode Ask
Cursor dispose de deux modes de chat. Les outils MCP ne fonctionnent que en mode Agent :
- Mode Agent — L’IA peut utiliser les outils MCP, exécuter les commandes du terminal et éditer les fichiers. C’est ce dont vous avez besoin pour l’automatisation de navigateur.
- Mode Ask — L’IA répond uniquement aux questions basées sur votre base de code. Pas d’accès aux outils. Les outils MCP n’apparaîtront pas ici.
Assurez-vous que vous êtes en mode Agent (vérifiez la liste déroulante en haut du panneau de chat) avant d’essayer les commandes du navigateur. Si vous ne voyez pas les outils MCP, passez au mode Agent.
Vous pouvez également utiliser Composer de Cursor (Cmd+I / Ctrl+I) pour les tâches d’automatisation de navigateur multi-étapes. Composer supporte également les outils MCP en mode Agent.
Dépannage
- "MCP server not showing" — Assurez-vous que mcp.json est un JSON valide. Même une virgule finale le cassera. Utilisez un validateur JSON si vous n’êtes pas sûr.
- "npx: command not found" — Node.js n’est pas dans PATH. Redémarrez Cursor après l’installation de Node.js. Sur macOS avec nvm, vous devrez peut-être définir le chemin complet vers npx dans le champ de commande.
- "Cannot connect to Linken Sphere" — Assurez-vous que Sphere est en cours d’exécution et que le port API est correct (par défaut 40080). Vérifiez qu’aucun pare-feu ne bloque le port.
- "Token invalid" — Copiez à nouveau le jeton à partir du tableau de bord mcp.ornold.com. Les jetons sont de longues chaînes — assurez-vous d’avoir copié la valeur entière.
- "Tools not appearing in chat" — Assurez-vous que vous êtes en mode Agent, pas en mode Ask. Vérifiez Cursor Settings → MCP pour vérifier que le serveur affiche un statut "connected" vert.
- "CAPTCHA solve failed" — Vérifiez votre solde de crédits captcha sur le tableau de bord Ornold. Le plan gratuit inclut des résolutions limitées.
- "Server disconnected" — Cursor peut déconnecter les serveurs MCP après un temps d’inactivité. Redémarrez le chat ou basculez le serveur dans Settings → MCP.
Et après ?
- Lisez le guide Claude Code + Ornold MCP si vous utilisez également Claude Code
- Lisez le guide Codex + Ornold MCP si vous utilisez également OpenAI Codex
- Apprenez l’automatisation parallèle du navigateur pour exécuter 10+ sessions à la fois
- Consultez le guide de résolution de CAPTCHA pour gérer reCAPTCHA, hCaptcha et Turnstile
- Explorez le mode Vision AI pour interagir avec les interfaces visuelles complexes