Guide14 min de lecture

Codex + Ornold MCP : guide d'automatisation navigateur

Connectez Codex CLI ou l'app à Ornold MCP. Configurez config.toml et automatisez les navigateurs antidetect avec l'IA.

17 avr. 2026

Ce que vous allez construire

À la fin de ce guide, vous aurez OpenAI Codex — à la fois la CLI et l'application desktop — qui contrôle de vraies sessions de navigateur antidetect via Ornold MCP. Naviguez sur des pages, remplissez des formulaires, résolvez des CAPTCHAs et gérez plusieurs profils, le tout en langage naturel. Pas de scripts, pas de sélecteurs.

Ce guide couvre la Codex CLI (macOS, Windows, Linux) et l'application desktop Codex (macOS Apple Silicon). Codex Cloud (ChatGPT web) utilise un workflow différent et n'a pas besoin de MCP — il n'est pas couvert ici.

Codex CLI vs Codex App vs Codex Cloud

OpenAI propose Codex sous trois formes. Voici celle dont vous avez besoin :

Codex CLI — Agent basé sur le terminal. S'exécute localement via la commande `codex`. Supporte MCP via config.toml. Fonctionne sur macOS, Windows et Linux.
Codex App — Application desktop pour macOS (Apple Silicon). Interface visuelle avec le même support MCP que la CLI.
Codex Cloud — Agent basé sur le navigateur dans ChatGPT. Se connecte directement aux dépôts GitHub. N'utilise PAS MCP — les tâches s'exécutent dans le sandbox cloud d'OpenAI.

Ce guide couvre la CLI et l'App. Les deux se connectent à Ornold MCP de la même façon — via config.toml.

Prérequis

Un ordinateur sous macOS 12+, Windows 10/11 ou Linux
Une clé API OpenAI ou un abonnement ChatGPT Plus/Pro/Team
Un navigateur antidetect installé : Linken Sphere, Dolphin Anty, Wadex ou Vision Browser
Node.js 20+ installé (voir Étape 1)

Étape 1 — Installer Node.js

Ornold MCP s'exécute en tant que package Node.js. Vous avez besoin de Node.js version 20 ou supérieure.

macOS

La façon la plus simple est Homebrew :

brew install node@22

Windows

Téléchargez l'installateur LTS depuis nodejs.org (22.x). Exécutez-le et assurez-vous que « Ajouter au PATH » est coché.

Linux

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# Or use nvm
nvm install 22

Vérifier :

node --version   # v22.x.x or higher
npm --version    # 10.x.x or higher

Terminal showing node --version output v22

Confirmer que Node.js est correctement installé

Étape 2 — Installer Codex

Option A : Codex CLI

Installez la Codex CLI globalement via npm :

npm install -g codex

Lancez-le pour vérifier et s'authentifier :

codex
# Sign in with your OpenAI API key when prompted

Vous pouvez aussi définir la variable d'environnement OPENAI_API_KEY au lieu de vous connecter de façon interactive.

🖼️

Codex CLI s'exécutant dans le terminal

Option B : Application desktop Codex

Téléchargez l'application Codex depuis openai.com/codex (macOS Apple Silicon uniquement). Installez-la, ouvrez-la et connectez-vous avec votre compte ChatGPT ou votre clé API OpenAI. Sélectionnez un dossier de projet lorsque demandé.

L'application Codex lit le même config.toml que la CLI, donc la configuration MCP fonctionne de manière identique pour les deux.

Étape 3 — Créer un compte Ornold

Ornold est le pont entre les agents IA et les navigateurs antidetect.

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
Vous arriverez sur le tableau de bord

Ornold MCP registration page with email and password fields

Créez votre compte Ornold sur [mcp.ornold.com](https://mcp.ornold.com)

Étape 4 — Créer un token API

Dans le tableau de bord, créez votre premier token API :

Entrez un nom pour votre token (ex. : « Codex »)
Cliquez sur « Créer »
Copiez le token — vous en aurez besoin ensuite

Ornold dashboard showing token creation modal with copy button

Créer et copier votre token API

Les comptes gratuits bénéficient d'1 siège, 5 résolutions de CAPTCHA (après la visite guidée du tableau de bord) et l'accès aux navigateurs standard.

É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 configuration. Pas besoin de créer des commandes manuellement — choisissez simplement vos options et copiez le résultat.

Allez dans l'onglet Tokens API du tableau de bord. Trouvez votre token et cliquez sur le bouton « Connecter » à côté.

Ornold dashboard API Tokens page with Connect button highlighted next to a token

Cliquez sur « Connecter » sur votre token pour ouvrir l'assistant

Assistant Étape 1 — Choisissez votre agent IA

L'assistant demande quel agent IA vous utilisez. Sélectionnez « Codex » dans la liste. L'assistant générera la configuration au format TOML (config.toml) au lieu de JSON. Les autres agents pris en charge incluent Claude Code, Cursor, VS Code, Windsurf et Cline.

🖼️

Étape 1 : Sélectionnez Codex comme agent IA

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 web standards.
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 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 couvre 90 % des cas d'utilisation. Vous pouvez toujours passer à « Les deux » plus tard si vous avez besoin d'analyse visuelle.

Connect wizard step 2 showing three interaction mode options: DOM, Vision AI, Both

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

Assistant Étape 3 — Activez 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.

Connect wizard step 3 showing browser toggles with Linken Sphere enabled and port field filled in

Étape 3 : Activez vos navigateurs antidetect et renseignez les ports

Assistant Étape 4 — Copiez la configuration

L'assistant génère la configuration finale en fonction de vos choix. Pour Codex, vous obtenez un bloc TOML prêt à coller pour config.toml. Cliquez sur « Copier » pour le récupérer.

🖼️

Étape 4 : Copiez la configuration TOML générée

L'assistant pré-remplit votre token réel et les valeurs de port — cliquez simplement sur « Copier » et collez dans config.toml. Aucune modification manuelle nécessaire.

Étape 6 — Ajouter Ornold MCP à Codex

Vous avez deux façons d'ajouter le serveur MCP — via l'interface graphique de l'application Codex ou en modifiant config.toml manuellement. Les deux méthodes produisent le même résultat.

Option A : Via l'interface de l'application Codex (recommandé)

Si vous utilisez l'application desktop Codex, vous pouvez ajouter des serveurs MCP directement depuis l'interface des paramètres — sans modifier de fichier.

Ouvrez l'application Codex et cliquez sur l'icône d'engrenage (⚙️) en haut à droite
Allez dans la section Integrations & MCP
Cliquez sur « Add Server » ou « Add Custom Server »

🖼️

Ouvrez Paramètres → Integrations & MCP dans l'application Codex

Dans le formulaire de configuration du serveur, remplissez :

Server name : ornold-browser
Transport : stdio
Command : npx
Arguments : ornold-mcp --token YOUR_TOKEN --linken-port 40080 (ajustez selon votre navigateur)

🖼️

Remplissez les détails du serveur MCP — nom, commande et arguments

Cliquez sur « Save » ou « Add ». Le serveur Ornold MCP apparaîtra dans votre liste de serveurs. Codex le charge automatiquement à la prochaine session.

🖼️

Serveur Ornold MCP ajouté et prêt dans l'application Codex

Les paramètres sont stockés dans config.toml en coulisses, ils se synchronisent donc automatiquement entre l'application Codex, la CLI et l'extension IDE.

Option B : Modifier config.toml manuellement (utilisateurs CLI)

Si vous préférez la CLI ou souhaitez configurer Codex sur un serveur headless, modifiez directement le fichier de configuration :

# macOS / Linux
~/.codex/config.toml

# Windows
%USERPROFILE%\.codex\config.toml

Collez le bloc de serveur MCP provenant de l'assistant. Voici à quoi il ressemble pour Linken Sphere :

# ~/.codex/config.toml

[mcp_servers.ornold-browser]
command = "npx"
args = ["ornold-mcp", "--token", "YOUR_TOKEN", "--linken-port", "40080"]

Pour Dolphin Anty, les args incluent le token Dolphin :

[mcp_servers.ornold-browser]
command = "npx"
args = ["ornold-mcp", "--token", "YOUR_TOKEN", "--dolphin-port", "3001", "--dolphin-token", "YOUR_DOLPHIN_TOKEN"]

Pour plusieurs navigateurs à la fois :

[mcp_servers.ornold-browser]
command = "npx"
args = ["ornold-mcp", "--token", "YOUR_TOKEN", "--linken-port", "40080", "--dolphin-port", "3001", "--dolphin-token", "DOLPHIN_KEY", "--wadex-port", "8080"]

Option C : One-liner via CLI

Vous pouvez également ajouter le serveur avec une seule commande dans le terminal :

codex mcp add ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --linken-port 40080

Les trois méthodes écrivent dans le même config.toml. Choisissez celle qui vous convient le mieux — le résultat est identique.

Étape 7 — Démarrer votre navigateur et lancer Codex

Assurez-vous que votre navigateur antidetect est en cours d'exécution, puis lancez Codex :

CLI

codex

Application desktop

Ouvrez l'application Codex. Sélectionnez le mode « Local ». Les serveurs MCP de config.toml se chargent automatiquement.

Codex détectera le serveur Ornold MCP et affichera les outils de navigateur disponibles. Parlez-lui maintenant :

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

# Fill a form
> Navigate to example.com/signup, fill email "test@mail.com" and password "Pass123", click Sign Up

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

# Multi-session
> Start 3 Linken Sphere sessions and open google.com in all of them

# Visual analysis
> Take a screenshot and describe what you see on the page

🖼️

Codex contrôlant Linken Sphere via Ornold MCP

Outils MCP disponibles

Une fois connecté, Codex a accès à plus de 40 outils d'automatisation de navigateur :

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 — Saisir du texte dans des champs de saisie
browser_parallel_screenshot — Capturer des captures d'écran de toutes les sessions
browser_parallel_vision_analyze_grouped — Analyse visuelle de page propulsée par l'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 langage courant — Codex choisit automatiquement les bons outils.

Politique d'approbation des outils

Codex dispose de trois modes d'approbation qui contrôlent la façon dont il exécute les outils :

« untrusted » — Codex demande une permission avant chaque appel d'outil (le plus sûr, par défaut)
« on-request » — Codex demande uniquement pour les outils destructifs ou inconnus
« never » — Codex exécute tous les outils sans demander (le plus rapide, à utiliser avec précaution)

Définissez la valeur par défaut dans config.toml :

# ~/.codex/config.toml
approval_policy = "on-request"

Ou remplacez par outil pour Ornold :

[mcp_servers.ornold-browser.tools.browser_parallel_navigate]
approval_mode = "approve"

[mcp_servers.ornold-browser.tools.browser_solve_captcha]
approval_mode = "approve"

Dépannage

« npx : commande introuvable » — Node.js absent du PATH. Redémarrez le terminal après l'installation.
« MCP handshake failed » dans l'application Codex Desktop — L'application de bureau n'hérite pas du PATH du terminal (les chemins nvm/fnm sont absents). Solution : exécutez `which npx` dans le terminal, puis utilisez le chemin complet dans config.toml : `command = "/Users/you/.nvm/versions/node/v22.x.x/bin/npx"` au lieu de simplement `"npx"`.
« codex : commande introuvable » — Exécutez à nouveau `npm install -g codex`. Sur macOS, vous aurez peut-être besoin de `sudo`.
« Impossible de se connecter à Linken Sphere » — Assurez-vous que Sphere est en cours d'exécution et que le port API est correct (par défaut 40080).
« Token invalide » — Copiez à nouveau le token depuis mcp.ornold.com. Assurez-vous d'avoir obtenu la chaîne complète.
« Serveur MCP ne se charge pas » — Vérifiez la syntaxe de config.toml. TOML est sensible au formatage. Utilisez un validateur TOML si nécessaire.
« Échec de la résolution du CAPTCHA » — Vérifiez votre solde de crédits CAPTCHA sur le tableau de bord Ornold.
L'application Codex ne trouve pas la config — Assurez-vous que config.toml est à ~/.codex/config.toml (pas dans un dossier de projet).

Et ensuite ?

Lisez le guide Claude Code + Ornold MCP si vous utilisez également Claude Code
Apprenez l'automatisation parallèle de navigateur 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