Guía14 min de lectura

Codex + Ornold MCP: guía de automatización de navegadores

Conecta Codex CLI o la app de escritorio a Ornold MCP. Configura config.toml y automatiza navegadores antidetección con IA.

17 abr 2026

Qué vas a construir

Al finalizar esta guía, tendrás OpenAI Codex —tanto el CLI como la aplicación de escritorio— controlando sesiones reales de navegadores antidetección a través de Ornold MCP. Navega páginas, rellena formularios, resuelve CAPTCHAs y gestiona múltiples perfiles, todo mediante lenguaje natural. Sin scripts, sin selectores.

Esta guía cubre el Codex CLI (macOS, Windows, Linux) y la aplicación de escritorio Codex (macOS Apple Silicon). Codex Cloud (web de ChatGPT) usa un flujo de trabajo diferente y no necesita MCP — no se trata aquí.

Codex CLI vs Codex App vs Codex Cloud

OpenAI ofrece Codex en tres formas. Esto es lo que necesitas saber:

Codex CLI — Agente basado en terminal. Se ejecuta localmente mediante el comando `codex`. Soporta MCP vía config.toml. Funciona en macOS, Windows y Linux.
Codex App — Aplicación de escritorio para macOS (Apple Silicon). Interfaz visual con el mismo soporte de MCP que el CLI.
Codex Cloud — Agente basado en navegador dentro de ChatGPT. Se conecta directamente a repositorios de GitHub. NO usa MCP — las tareas se ejecutan en el sandbox en la nube de OpenAI.

Esta guía cubre el CLI y la App. Ambos se conectan a Ornold MCP de la misma manera — a través de config.toml.

Requisitos previos

Un equipo con macOS 12+, Windows 10/11 o Linux
Una clave de API de OpenAI o suscripción ChatGPT Plus/Pro/Team
Un navegador antidetección instalado: Linken Sphere, Dolphin Anty, Wadex o Vision Browser
Node.js 20+ instalado (ver Paso 1)

Paso 1 — Instalar Node.js

Ornold MCP se ejecuta como un paquete de Node.js. Necesitas Node.js versión 20 o superior.

macOS

La forma más sencilla es con Homebrew:

brew install node@22

Windows

Descarga el instalador LTS desde nodejs.org (22.x). Ejecútalo y asegúrate de que "Add to PATH" esté marcado.

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

Verifica:

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

Terminal showing node --version output v22

Confirma que Node.js está instalado correctamente

Paso 2 — Instalar Codex

Opción A: Codex CLI

Instala el Codex CLI globalmente vía npm:

npm install -g codex

Lánzalo para verificar y autenticarte:

codex
# Sign in with your OpenAI API key when prompted

También puedes establecer la variable de entorno OPENAI_API_KEY en lugar de iniciar sesión de forma interactiva.

🖼️

Codex CLI ejecutándose en el terminal

Opción B: Aplicación de escritorio Codex

Descarga la aplicación Codex desde openai.com/codex (solo macOS Apple Silicon). Instálala, ábrela e inicia sesión con tu cuenta de ChatGPT o clave de API de OpenAI. Selecciona una carpeta de proyecto cuando se te indique.

La aplicación Codex lee el mismo config.toml que el CLI, por lo que la configuración de MCP es idéntica para ambos.

Paso 3 — Crear una cuenta en Ornold

Ornold es el puente entre los agentes de IA y los navegadores antidetección.

Ve a mcp.ornold.com
Haz clic en "Register" y crea una cuenta con tu email
Verifica tu email con el código de 6 dígitos
Llegarás al panel de control

Ornold MCP registration page with email and password fields

Crea tu cuenta de Ornold en [mcp.ornold.com](https://mcp.ornold.com)

Paso 4 — Crear un token de API

En el panel de control, crea tu primer token de API:

Ingresa un nombre para tu token (por ejemplo, "Codex")
Haz clic en "Create"
Copia el token — lo necesitarás en el siguiente paso

Ornold dashboard showing token creation modal with copy button

Crea y copia tu token de API

Las cuentas gratuitas obtienen 1 asiento, 5 resoluciones de CAPTCHA (tras el recorrido del panel) y acceso a navegadores estándar.

Paso 5 — Generar la configuración MCP con el asistente del panel

El panel de Ornold tiene un asistente de conexión integrado que genera la configuración MCP exacta para tu configuración. No necesitas escribir comandos manualmente — solo elige tus opciones y copia el resultado.

Ve a la pestaña "API Tokens" en el panel. Encuentra tu token y haz clic en el botón "Connect" que aparece junto a él.

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

Haz clic en "Connect" en tu token para abrir el asistente

Asistente Paso 1 — Elegir tu agente de IA

El asistente pregunta qué agente de IA estás usando. Selecciona "Codex" de la lista. El asistente generará la configuración en formato TOML (config.toml) en lugar de JSON. Otros agentes compatibles incluyen Claude Code, Cursor, VS Code, Windsurf y Cline.

🖼️

Paso 1: Selecciona Codex como tu agente de IA

Asistente Paso 2 — Elegir el modo de interacción

Elige cómo debe interactuar la IA con las páginas del navegador:

Modo DOM (predeterminado) — La IA lee la estructura HTML de la página. Cada elemento recibe un marcador [ref=N]. Gratuito y rápido. Ideal para formularios, páginas estructuradas y sitios web estándar.
Modo Vision AI — La IA toma una captura de pantalla y localiza elementos visualmente por su apariencia. Funciona en cualquier página, incluso en interfaces basadas en canvas. Cada análisis cuesta 1 crédito de visión.
Ambos modos — Todas las herramientas disponibles. La IA elige automáticamente el mejor enfoque para cada acción.

Empieza con el modo DOM. Es gratuito, rápido y cubre el 90% de los casos de uso. Siempre puedes cambiar a "Ambos" más adelante si necesitas análisis visual.

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

Paso 2: Elige el modo DOM para la mayoría de los casos

Asistente Paso 3 — Habilitar navegadores antidetección

Activa los navegadores que usas e introduce sus datos de conexión:

Linken Sphere — Solo establece el puerto de API (predeterminado: 40080). Asegúrate de que Sphere esté en ejecución.
Dolphin Anty — Establece el puerto local (predeterminado: 3001) y pega tu token de API de Dolphin desde Configuración → API.
Wadex — Establece el puerto de API (predeterminado: 8080).
Vision Browser — Pega tu X-Token. Opcionalmente establece un puerto local.

Puedes habilitar varios navegadores a la vez. La configuración MCP los incluirá todos, y el agente de IA podrá controlar cualquiera que esté en ejecución.

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

Paso 3: Habilita tus navegadores antidetección e introduce los puertos

Asistente Paso 4 — Copiar la configuración

El asistente genera la configuración final según tus elecciones. Para Codex, obtienes un bloque TOML listo para pegar en config.toml. Haz clic en "Copy" para copiarlo.

🖼️

Paso 4: Copia la configuración TOML generada

El asistente pre-rellena tu token y valores de puerto reales — solo haz clic en "Copy" y pega en config.toml. No se necesita edición manual.

Paso 6 — Añadir Ornold MCP a Codex

Tienes dos formas de añadir el servidor MCP: a través de la interfaz gráfica de la aplicación Codex o editando config.toml manualmente. Ambos métodos producen el mismo resultado.

Opción A: A través de la interfaz de la aplicación Codex (recomendado)

Si estás usando la aplicación de escritorio Codex, puedes añadir servidores MCP directamente desde la interfaz de configuración, sin necesidad de editar archivos.

Abre la aplicación Codex y haz clic en el icono de engranaje (⚙️) en la esquina superior derecha
Ve a la sección Integrations & MCP
Haz clic en "Add Server" o "Add Custom Server"

🖼️

Abre Settings → Integrations & MCP en la aplicación Codex

En el formulario de configuración del servidor, completa:

Server name: ornold-browser
Transport: stdio
Command: npx
Arguments: ornold-mcp --token YOUR_TOKEN --linken-port 40080 (ajusta según tu navegador)

🖼️

Completa los detalles del servidor MCP: nombre, comando y argumentos

Haz clic en "Save" o "Add". El servidor Ornold MCP aparecerá en tu lista de servidores. Codex lo carga automáticamente en la siguiente sesión.

🖼️

Servidor Ornold MCP añadido y listo en la aplicación Codex

La configuración se almacena en config.toml internamente, por lo que se sincroniza automáticamente entre la aplicación Codex, el CLI y la extensión del IDE.

Opción B: Editar config.toml manualmente (usuarios de CLI)

Si prefieres el CLI o quieres configurar Codex en un servidor sin interfaz gráfica, edita el archivo de configuración directamente:

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

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

Pega el bloque de servidor MCP del asistente. Así es como se ve para Linken Sphere:

# ~/.codex/config.toml

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

Para Dolphin Anty, los args incluyen el token de Dolphin:

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

Para múltiples navegadores simultáneamente:

[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"]

Opción C: Una sola línea mediante CLI

También puedes añadir el servidor con un solo comando de terminal:

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

Los tres métodos escriben en el mismo config.toml. Elige el que te resulte más cómodo: el resultado es idéntico.

Paso 7 — Iniciar el navegador y lanzar Codex

Asegúrate de que tu navegador antidetección esté en ejecución y luego lanza Codex:

CLI

codex

Aplicación de escritorio

Abre la aplicación Codex. Selecciona el modo "Local". Los servidores MCP de config.toml se cargan automáticamente.

Codex detectará el servidor Ornold MCP y mostrará las herramientas de navegador disponibles. Ahora puedes hablar con él:

# 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 controlando Linken Sphere a través de Ornold MCP

Herramientas MCP disponibles

Una vez conectado, Codex tiene acceso a más de 40 herramientas de automatización de navegador:

linken_start_instances / dolphin_start_profiles — Iniciar sesiones de navegador
browser_parallel_navigate — Abrir URLs en todos los navegadores activos
browser_parallel_snapshot — Obtener el DOM de la página con marcadores [ref=N] clicables
browser_parallel_click — Hacer clic en elementos por ref o selector
browser_parallel_fill — Escribir texto en campos de entrada
browser_parallel_screenshot — Capturar pantallas de todas las sesiones
browser_parallel_vision_analyze_grouped — Análisis visual de páginas impulsado por IA
browser_solve_captcha — Resolución automática de reCAPTCHA, hCaptcha, Turnstile y más
browser_parallel_evaluate — Ejecutar JavaScript en el contexto de la página
linken_stop_instances / dolphin_stop_profiles — Cerrar sesiones

No necesitas memorizar los nombres de las herramientas. Solo describe lo que quieres en lenguaje natural — Codex elige las herramientas correctas automáticamente.

Política de aprobación de herramientas

Codex tiene tres modos de aprobación que controlan cómo ejecuta las herramientas:

"untrusted" — Codex pide permiso antes de cada llamada a una herramienta (más seguro, predeterminado)
"on-request" — Codex solo pide permiso para herramientas destructivas o desconocidas
"never" — Codex ejecuta todas las herramientas sin preguntar (más rápido, usar con precaución)

Establece el valor predeterminado en config.toml:

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

O sobreescribe por herramienta para Ornold:

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

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

Solución de problemas

"npx: command not found" — Node.js no está en el PATH. Reinicia el terminal después de la instalación.
"MCP handshake failed" en la app de escritorio Codex — La app de escritorio no hereda el PATH del terminal (faltan las rutas de nvm/fnm). Solución: ejecuta `which npx` en el terminal, luego usa la ruta completa en config.toml: `command = "/Users/you/.nvm/versions/node/v22.x.x/bin/npx"` en lugar de solo `"npx"`.
"codex: command not found" — Ejecuta `npm install -g codex` nuevamente. En macOS puede que necesites `sudo`.
"Cannot connect to Linken Sphere" — Asegúrate de que Sphere esté en ejecución y el puerto de API sea correcto (predeterminado 40080).
"Token invalid" — Copia el token nuevamente desde mcp.ornold.com. Asegúrate de haber copiado la cadena completa.
"MCP server not loading" — Verifica la sintaxis de config.toml. TOML es sensible al formato. Usa un validador de TOML si no estás seguro.
"CAPTCHA solve failed" — Revisa tu saldo de créditos de CAPTCHA en el panel de Ornold.
La aplicación Codex no encuentra la configuración — Asegúrate de que config.toml esté en ~/.codex/config.toml (no dentro de una carpeta de proyecto).

¿Qué sigue?

Lee la guía de Claude Code + Ornold MCP si también usas Claude Code
Aprende sobre la automatización paralela de navegadores para ejecutar más de 10 sesiones a la vez
Consulta la guía de resolución de CAPTCHA para manejar reCAPTCHA, hCaptcha y Turnstile
Explora el modo Vision AI para interactuar con interfaces visuales complejas