Retour au blog
Guide15 min de lecture
Claude Code + Ornold MCP : guide d'installation complet
Installez Node.js, configurez Claude Code, connectez Ornold MCP et automatisez les navigateurs antidetect avec l'IA. macOS et Windows.
17 avr. 2026Ce que vous allez construire
À la fin de ce guide, vous aurez Claude Code contrôlant de vraies sessions de navigateur antidetect — naviguer sur des pages, remplir des formulaires, résoudre des CAPTCHAs et gérer plusieurs profils — le tout via des commandes en langage naturel. Aucun script Playwright. Aucun sélecteur CSS. Dites simplement à l'IA ce qu'elle doit faire.
Ce guide couvre macOS et Windows. Les étapes Linux sont identiques à macOS (utilisez votre gestionnaire de paquets à la place de Homebrew).
Prérequis
- Un ordinateur sous macOS 12+ ou Windows 10/11
- Un navigateur antidetect installé : Linken Sphere, Dolphin Anty, Wadex ou Vision Browser
- Une connexion Internet pour télécharger les outils et les paquets
- Une aisance de base avec le terminal (macOS) ou PowerShell (Windows)
Étape 1 — Installer Node.js
Ornold MCP fonctionne comme un paquet Node.js. Vous avez besoin de Node.js version 20 ou supérieure.
macOS
La façon la plus simple est d'utiliser Homebrew. Si vous n'avez pas Homebrew, installez-le d'abord depuis brew.sh. Puis :
brew install node@22
Windows
Téléchargez l'installeur officiel depuis nodejs.org. Choisissez la version LTS (22.x). Lancez l'installeur et suivez les instructions. Assurez-vous que « Ajouter au PATH » est coché.
Vérifiez l'installation en ouvrant le Terminal (macOS) ou PowerShell (Windows) :
node --version
# Sortie attendue : v22.x.x ou supérieure
npm --version
# Sortie attendue : 10.x.x ou supérieure
Étape 2 — Installer Claude Code
Claude Code est l'agent de codage IA d'Anthropic qui fonctionne dans votre terminal. Il prend en charge MCP (Model Context Protocol) qui lui permet d'utiliser des outils externes — comme l'automatisation de navigateur.
macOS
npm install -g @anthropic-ai/claude-code
Windows
Ouvrez PowerShell en tant qu'Administrateur et exécutez :
npm install -g @anthropic-ai/claude-code
Après l'installation, lancez Claude Code pour finaliser l'authentification :
claude
# Suivez les instructions pour vous connecter avec votre compte Anthropic
Claude Code nécessite une clé API Anthropic ou un abonnement Claude Pro/Team. Si vous n'en avez pas encore, inscrivez-vous sur console.anthropic.com.
É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 token API.
- Rendez-vous sur mcp.ornold.com
- Cliquez sur « S'inscrire » et créez un compte avec votre e-mail
- Vérifiez votre e-mail avec le code à 6 chiffres envoyé dans votre boîte de réception
- Vous arriverez sur le tableau de bord — vous êtes connecté !
Étape 4 — Créer un token API
Après l'inscription, le tableau de bord vous invitera à créer votre premier token API. Ce token authentifie votre connexion MCP.
- Entrez un nom pour votre token (par ex. « Claude Code »)
- Cliquez sur « Créer »
- Copiez le token et sauvegardez-le en lieu sûr — vous en aurez besoin à l'étape suivante
Les comptes gratuits obtiennent 1 siège, 5 résolutions de CAPTCHA (après avoir complété la visite guidée) et l'accès aux navigateurs standard. Améliorez 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 de connexion intégré qui génère la configuration MCP exacte pour votre setup. Aucune création manuelle de commande nécessaire — choisissez simplement vos options et copiez le résultat.
Rendez-vous dans l'onglet Tokens API du tableau de bord. Trouvez votre token et cliquez sur le bouton « Connecter » à côté.
Assistant Étape 1 — Choisissez votre agent IA
L'assistant demande quel agent IA vous utilisez. Sélectionnez « Claude Code » dans la liste. Les autres agents pris en charge incluent Cursor, VS Code, Windsurf, Cline et Codex — chacun reçoit un format de configuration adapté.
Assistant Étape 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 reçoit un marqueur [ref=N]. Gratuit et rapide. Idéal pour les formulaires, les pages structurées et les sites standard.
- Mode Vision AI — L'IA prend une capture d'écran et trouve visuellement les éléments selon leur apparence. Fonctionne sur n'importe quelle page, même les interfaces canvas. Chaque analyse coûte 1 crédit vision.
- Les deux modes — Tous les outils disponibles. L'IA choisit automatiquement la meilleure approche pour chaque action.
Commencez avec le mode DOM. Il est gratuit, rapide et gère 90 % des cas d'usage. Vous pouvez toujours passer à « Les deux » plus tard si vous avez besoin d'une analyse visuelle.
Assistant Étape 3 — Activer les navigateurs antidetect
Activez les navigateurs que vous utilisez et renseignez 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 token API Dolphin depuis Paramètres → 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 l'agent IA pourra contrôler celui qui est en cours d'exécution.
Assistant Étape 4 — Copier et appliquer la configuration
L'assistant génère la configuration finale en fonction de vos choix. Pour Claude Code, vous avez deux options :
Option A : Commande terminal (recommandée)
Copiez la commande en une ligne et collez-la dans votre terminal. C'est une configuration unique — MCP démarrera automatiquement avec Claude Code à chaque fois après cela.
claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --linken-port 40080
Option B : Fichier .mcp.json de projet
Si vous souhaitez partager la configuration MCP avec votre équipe via le contrôle de version, copiez le JSON et enregistrez-le sous .mcp.json à la racine de votre projet :
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--linken-port", "40080"]
}
}
}
L'assistant pré-remplit vos valeurs réelles de token et de port — cliquez simplement sur « Copier » et collez. Aucune modification manuelle nécessaire.
Vérifiez que le serveur MCP a été enregistré :
claude mcp list
# Vous devriez voir "ornold-browser" dans la liste
Étape 6 — Démarrer votre navigateur et tester
Assurez-vous que votre navigateur antidetect est en cours d'exécution avant de démarrer Claude Code. Checklist 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.
Étape 7 — Votre première commande de navigateur IA
Tout est connecté. Démarrez Claude Code dans n'importe quel répertoire :
claude
Parlez-lui maintenant en langage naturel. Voici quelques commandes à essayer :
# Démarrer une session Linken Sphere et naviguer
> Démare une nouvelle session Linken Sphere et ouvre google.com
# Remplir un formulaire
> Va sur example.com/signup, remplis l'email "test@mail.com" et le mot de passe "SecurePass123", puis clique sur S'inscrire
# Résoudre un CAPTCHA
> Il y a un CAPTCHA sur cette page, résous-le
# Prendre une capture d'écran pour l'analyse visuelle
> Prends une capture d'écran de la page actuelle et décris ce que tu vois
# Travailler avec plusieurs sessions
> Démarre 3 sessions Linken Sphere et ouvre google.com dans toutes
Outils MCP disponibles
Une fois connecté, Claude Code a accès à plus de 40 outils d'automatisation de navigateur. Voici les plus couramment utilisés :
- linken_start_instances / dolphin_start_profiles — Démarrer des sessions de navigateur
- browser_parallel_navigate — Ouvrir des URLs dans tous les navigateurs actifs
- browser_parallel_snapshot — Obtenir le DOM de la page avec des marqueurs [ref=N] cliquables
- browser_parallel_click — Cliquer sur des éléments par ref ou sélecteur
- browser_parallel_fill — Taper du texte dans les champs de saisie
- browser_parallel_screenshot — Capturer des captures d'écran de toutes les sessions
- browser_parallel_vision_analyze_grouped — Analyse visuelle de page assistée par IA
- browser_solve_captcha — Résoudre automatiquement reCAPTCHA, hCaptcha, Turnstile et plus
- browser_parallel_evaluate — Exécuter du JavaScript dans le contexte de la page
- linken_stop_instances / dolphin_stop_profiles — Fermer les sessions
Vous n'avez pas besoin de mémoriser les noms des outils. Décrivez simplement ce que vous voulez en anglais et Claude Code choisira automatiquement les bons outils.
Modes d'interaction
Ornold MCP prend en charge 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 des instantanés DOM. Chaque élément reçoit un marqueur [ref=N]. Rapide et ne coûte aucun crédit 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 selon leur apparence. Fonctionne sur n'importe quelle page, même les SPA complexes ou les interfaces canvas. Chaque analyse coûte 1 crédit vision.
# Activer les deux modes :
claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --mode both
Résolution des problèmes
- « npx : commande introuvable » — Node.js n'est pas dans le PATH. Redémarrez le terminal après avoir installé Node.js. Sous Windows, assurez-vous d'avoir coché « Ajouter au PATH » lors de l'installation.
- « Impossible de se connecter à Linken Sphere » — Assurez-vous que Sphere est en cours d'exécution et que le port API est correct (40080 par défaut). Vérifiez qu'aucun pare-feu ne bloque le port.
- « Token invalide » — Copiez à nouveau le token depuis le tableau de bord mcp.ornold.com. Les tokens sont de longues chaînes — assurez-vous d'avoir copié la valeur entière.
- « Le serveur MCP ne répond pas » — Exécutez `claude mcp list` pour vérifier l'enregistrement. Essayez de supprimer et de ré-ajouter : `claude mcp remove ornold-browser` puis relancez la commande d'ajout.
- « Échec de la résolution du CAPTCHA » — Vérifiez votre solde de crédits CAPTCHA sur le tableau de bord Ornold. Le plan gratuit inclut des résolutions limitées.
- « Permission refusée (npm install) » — Sur macOS, préfixez avec sudo. Sous Windows, exécutez PowerShell en tant qu'Administrateur.
Et maintenant ?
- Lisez le guide d'automatisation Linken Sphere pour la gestion avancée des sessions
- Apprenez l'automatisation de navigateur en parallèle pour exécuter 10+ sessions simultanément
- Consultez le guide de résolution de CAPTCHA pour gérer reCAPTCHA, hCaptcha et Turnstile
- Explorez le mode Vision AI pour interagir avec des interfaces visuelles complexes