Guide12 min de lecture

Linken Sphere MCP Setup : connecter des agents IA à votre navigateur antidetect

Guide étape par étape pour connecter Claude Code, Cursor, Windsurf ou Cline à Linken Sphere. Contrôlez les sessions en langage naturel, sans scripts.

18 avr. 2026

Ce que vous obtiendrez

À la fin de ce guide, les agents IA (Claude Code, Cursor, Windsurf ou Cline) contrôleront des sessions réelles de Linken Sphere — ouvrir des pages, remplir des formulaires, résoudre des CAPTCHA et gérer plusieurs sessions — tout par des commandes en langage naturel. Pas de scripts Playwright. Pas de sélecteurs CSS. Dites simplement à l’IA ce qu’il faut faire.

Ce guide couvre Linken Sphere spécifiquement. Si vous utilisez Dolphin Anty, Wadex ou Vision Browser, consultez les guides de configuration spécifiques au navigateur.

Prérequis

Linken Sphere installé et en cours d’exécution
Au moins une session créée dans Linken Sphere
Node.js 20+ installé (nodejs.org)
Un agent IA : Claude Code, Cursor, Windsurf ou Cline
Familiarité de base avec le terminal/ligne de commande

Étape 1 — Activer l’API Linken Sphere

Linken Sphere expose une API HTTP locale qu’Ornold MCP utilise pour lancer et contrôler les sessions. L’API est activée par défaut sur le port 40080.

Ouvrez Linken Sphere
Assurez-vous que l’application est en cours d’exécution
L’API est automatiquement disponible sur http://localhost:40080
Aucune configuration supplémentaire requise — l’API Linken Sphere est toujours activée

Si vous avez modifié le port par défaut dans les paramètres de Linken Sphere, notez-le — vous en aurez besoin à l’étape 4.

Étape 2 — Créer un compte Ornold

Ornold est le pont entre les agents IA et les navigateurs anti-détection. Vous avez besoin d’un compte pour obtenir un jeton API.

Allez 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é à votre boîte de réception
Vous arriverez au tableau de bord — prêt pour l’étape suivante

🖼️

Créez votre compte Ornold sur mcp.ornold.com

Étape 3 — Créer un jeton API

Après l’inscription, le tableau de bord vous demandera de créer votre premier jeton API. Ce jeton authentifie la connexion MCP.

Entrez un nom pour le jeton (par exemple, « Linken Sphere »)
Cliquez sur « Créer »
Copiez le jeton et enregistrez-le dans un endroit sûr — vous en aurez besoin à l’étape suivante

🖼️

Créez et copiez votre jeton API

Le plan gratuit comprend 1 emplacement, 5 résolutions CAPTCHA (après l’intégration) et l’accès aux navigateurs standard. Mettez à niveau pour plus de capacité.

Étape 4 — Générer la configuration MCP via l’assistant de configuration

Le tableau de bord Ornold dispose d’un assistant de connexion intégré qui génère la configuration MCP exacte pour votre configuration. Pas de saisie manuelle — sélectionnez 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é.

🖼️

Cliquez sur « Connect » sur votre jeton pour ouvrir l’assistant

Étape de l’assistant 1 — Sélectionnez votre agent IA

L’assistant vous demandera quel agent IA vous utilisez. Sélectionnez votre agent dans la liste (Claude Code, Cursor, Windsurf, Cline ou Codex). Chaque agent obtient son propre format de configuration.

🖼️

Étape 1 : Sélectionnez votre agent IA

Étape de l’assistant 2 — Choisir 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. Chaque élément obtient un marqueur [ref=N]. Gratuit et rapide. Meilleur pour les formulaires, les pages structurées et les sites Web standard.
Mode Vision IA — L’IA prend une capture d’écran et trouve visuellement les éléments par apparence. Fonctionne sur n’importe quelle page, y compris 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 par le mode DOM. Il est gratuit, rapide et gère 90 % des tâches. Vous pouvez toujours passer à « Les deux modes » si vous avez besoin d’une analyse visuelle.

🖼️

Étape 2 : Choisissez le mode DOM pour la plupart des cas

Étape de l’assistant 3 — Activer Linken Sphere

Activez Linken Sphere et remplissez les détails de connexion :

Port API (par défaut : 40080) — utilisez la valeur par défaut sauf si vous l’avez modifiée dans les paramètres de Linken Sphere

Vous pouvez activer plusieurs navigateurs à la fois. La configuration MCP les inclura tous, et l’agent IA peut contrôler n’importe lequel qui est en cours d’exécution.

🖼️

Étape 3 : Activez Linken Sphere et confirmez le port

Étape de l’assistant 4 — Copier et appliquer la configuration

L’assistant génère la configuration finale en fonction de vos choix. Pour la plupart des agents IA, vous avez deux options :

Option A : Commande de terminal (recommandée)

Copiez la commande d’une ligne et collez-la dans votre terminal. C’est une configuration unique — MCP démarrera automatiquement avec votre agent IA à chaque fois après.

claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --linken-port 40080

🖼️

Étape 4 : Copiez la commande de terminal et exécutez-la

Option B : Fichier .mcp.json du projet

Si vous souhaitez partager la configuration MCP avec votre équipe via le contrôle de version, copiez le JSON et enregistrez-le en tant que .mcp.json à la racine de votre projet :

{
  "mcpServers": {
    "ornold-browser": {
      "command": "npx",
      "args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--linken-port", "40080"]
    }
  }
}

L’assistant remplit automatiquement vos valeurs de jeton et de port — cliquez simplement sur « Copier » et collez. Aucune édition manuelle requise.

Vérifiez que le serveur MCP est enregistré :

claude mcp list
# You should see "ornold-browser" in the list

🖼️

Serveur MCP Ornold enregistré avec succès

Étape 5 — Lancez Linken Sphere et testez

Avant d’exécuter votre agent IA, assurez-vous que Linken Sphere est ouvert et que vous avez créé au moins une session.

Ouvrez Linken Sphere
Assurez-vous d’avoir au moins une session dans la liste
Gardez Linken Sphere en cours d’exécution en arrière-plan

Étape 6 — Première commande de navigateur IA

Tout est connecté. Lancez votre agent IA (Claude Code, Cursor, Windsurf ou Cline) et parlez-lui en langage naturel. Voici quelques commandes pour commencer :

# Start a Linken Sphere session and navigate
> Start a Linken Sphere session and open google.com

# Fill a form
> Go to example.com/signup, fill in email "test@mail.com" and password "SecurePass123", then click Sign Up

# Solve a CAPTCHA
> There's a CAPTCHA on this page, solve it

# Take a screenshot for visual analysis
> Take a screenshot of the current page and describe what you see

# Work with multiple sessions
> Start 3 Linken Sphere sessions and open google.com in all of them

🖼️

Agent IA contrôlant Linken Sphere via le langage naturel

Outils MCP disponibles

Après la connexion, votre agent IA a accès à 40+ outils d’automatisation de navigateur. Voici les plus couramment utilisés :

browser_list — Lister toutes les sessions Linken Sphere disponibles
browser_parallel_navigate — Ouvrir une URL dans tous les navigateurs actifs
browser_parallel_snapshot — Obtenir le DOM de la page avec des marqueurs cliquables [ref=N]
browser_parallel_click — Cliquer sur les éléments par ref ou sélecteur
browser_parallel_fill — Saisir du texte dans les champs de saisie
browser_parallel_screenshot — Prendre des captures d’écran de toutes les sessions
browser_parallel_vision_analyze_grouped — Analyse visuelle des pages avec l’IA
browser_solve_captcha — Résoudre automatiquement reCAPTCHA, hCaptcha, Turnstile et plus
browser_parallel_evaluate — Exécuter JavaScript dans le contexte de la page
browser_status — Vérifier quelles sessions sont en cours d’exécution

Vous n’avez pas besoin de mémoriser les noms des outils. Décrivez simplement ce que vous voulez en langage simple, et l’agent IA choisira automatiquement les bons outils.

Bureaux Linken Sphere

Linken Sphere organise les sessions en « bureaux » — des espaces de travail isolés qui regroupent les sessions connexes. Lorsque vous démarrez une session via MCP, elle utilise le bureau actuellement actif dans Linken Sphere.

Pour contrôler quel bureau est utilisé, basculez vers celui-ci dans Linken Sphere avant d’exécuter les commandes IA. Le pont MCP respecte votre sélection de bureau actif.

Modes d’interaction

Ornold MCP prend en charge deux modes d’interaction. Vous en avez choisi un lors de la configuration :

Mode DOM (par défaut, gratuit)

L’IA lit la structure de la page via des snapshots DOM. Chaque élément obtient un marqueur [ref=N]. Rapide et ne consomme pas de crédits vision. Meilleur pour les pages structurées avec du HTML clair.

Mode Vision IA (payant, par analyse)

L’IA prend une capture d’écran et utilise l’analyse visuelle pour trouver les éléments par apparence. Fonctionne sur n’importe quelle page, y compris les SPA complexes ou les interfaces canvas. Chaque analyse coûte 1 crédit vision.

# Enable both modes:
claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --mode both --linken-port 40080

Dépannage

"No sessions found" — Assurez-vous que Linken Sphere est en cours d’exécution et que vous avez créé au moins une session.
"Connection refused" — Vérifiez que le numéro de port (par défaut : 40080) correspond à votre port API Linken Sphere. Assurez-vous que le pare-feu ne bloque pas les connexions localhost.
"MCP server not found" — Exécutez `claude mcp list` pour vérifier que ornold-browser est enregistré. Si ce n’est pas le cas, réexécutez la commande de configuration de l’étape 4.
"Permission denied (npm install)" — Sur macOS, ajoutez le préfixe sudo. Sur Windows, exécutez PowerShell en tant qu’administrateur.
"Session launch timeout" — Linken Sphere peut être lent au lancement des sessions lors de la première exécution. Attendez 10-15 secondes et réessayez.

Et après ?

Lisez le guide d’automatisation Dolphin Anty (/blog/dolphin-anty-mcp-setup) pour comparer avec un autre navigateur anti-détection populaire
Découvrez l’automatisation parallèle des navigateurs (/blog/parallel-browser-automation) pour exécuter 10+ sessions à la fois
Consultez le guide de résolution CAPTCHA (/blog/captcha-solving-guide) pour gérer reCAPTCHA, hCaptcha et Turnstile
Explorez le mode Vision IA (/blog/vision-vs-selectors) pour interagir avec des interfaces visuelles complexes