Volver al blog
Guía3 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 2026La forma más fácil: pídele a Codex que se instale solo
OpenAI Codex (CLI y app de escritorio) puede instalar Ornold MCP por sí mismo. Pega un prompt con tu token, Codex edita `~/.codex/config.toml` y recarga. Sin TOML manual.
Codex CLI funciona en macOS, Windows y Linux. La app de escritorio Codex es solo para macOS Apple Silicon. Ambos usan el mismo `~/.codex/config.toml`, así la configuración MCP es idéntica.
Paso 1 — Obtén tu token
- Regístrate en mcp.ornold.com
- Abre la página Tokens
- Click en Create token, copia el valor
Paso 2 — Pega este prompt en Codex
Abre Codex (CLI: `codex`, o app de escritorio), y pega:
Install Ornold MCP — browser automation for antidetect browsers.
Requirements: Node.js ≥ 18 (https://nodejs.org)
Token: get one at https://mcp.ornold.com (sign up → Tokens page → Create token)
Create or edit ~/.codex/config.toml and add:
[mcp_servers.ornold-browser]
command = "npx"
args = ["-y", "mcp-ornold-browser", "--token", "YOUR_TOKEN"]
Replace YOUR_TOKEN with the token from the dashboard.
Note: Desktop apps don't inherit terminal PATH. If MCP fails to start, find your npx path with `which npx` and use the full path in the command field.
Reemplaza `YOUR_TOKEN` con tu token real antes de enviar. Codex escribe el TOML, luego carga MCP en la próxima sesión.
Paso 3 — Verifica
En Codex, pregunta:
List my connected browsers using browser_list
Si tu navegador antidetección está corriendo, verás sus perfiles. Listo.
Flags de navegadores antidetección
Dile a Codex qué navegador usas — añade el flag correcto a args:
- Linken Sphere — `--linken-port 40080`
- Dolphin Anty — `--dolphin-port 3001 --dolphin-token YOUR_DOLPHIN_TOKEN`
- Vision Browser — `--vision-token vx_...`
- Wadex — `--wadex-port 8080`
Para sigilo antidetección, añade `--mode vision` para que la IA haga clic vía screenshots y coordenadas en vez de selectores DOM.
Codex App vs CLI
Ambos leen `~/.codex/config.toml`. La app de escritorio además tiene UI para añadir servidores MCP (Settings → Integrations & MCP), pero escribe al mismo archivo. Usuarios CLI editan TOML directamente o usan:
codex mcp add ornold-browser -- npx mcp-ornold-browser --token YOUR_TOKEN
Política de aprobación de herramientas
Codex pide aprobación antes de ejecutar herramientas por defecto. Para ejecutar herramientas de navegador sin confirmar cada vez, añade a config.toml:
approval_policy = "on-request"
Solución de problemas
- **Servidor MCP no carga** — Revisa la sintaxis de config.toml. TOML es sensible al formato. Usa un validador TOML.
- **App Codex no encuentra config** — Asegúrate de que `config.toml` está en `~/.codex/config.toml`, no en una carpeta de proyecto.
- **App de escritorio: npx not found** — Las apps no heredan el PATH del terminal. Usa la ruta completa: `which npx` → pon el resultado en `command`.
- **Token inválido** — Vuelve a copiar de mcp.ornold.com.
- **No conecta al navegador** — Asegúrate de que el navegador antidetección está corriendo y los puertos coinciden.
¿Qué sigue?
- Guía Claude Code + Ornold MCP si también usas Claude Code
- Automatización paralela de navegadores — corre 10+ sesiones a la vez
- Guía de resolución de CAPTCHA — reCAPTCHA, hCaptcha, Turnstile
- Vision AI vs selectores CSS — por qué los clics por coordenadas vencen al DOM scraping