Volver al blog
Guía12 min de lectura
Cursor + Ornold MCP: guía completa de automatización de navegadores
Conecta Cursor a Ornold MCP y automatiza navegadores antidetect con IA. Configuración paso a paso para Linken Sphere, Dolphin Anty y más.
19 abr 2026Lo que construirás
Al final de esta guía, tendrás Cursor controlando sesiones reales de navegadores antidetección — navegando páginas, rellenando formularios, resolviendo CAPTCHA y administrando múltiples perfiles — todo a través del chat de Cursor en lenguaje natural. Sin scripts de Playwright. Sin selectores CSS. Solo dile al AI qué hacer.
Esta guía cubre macOS y Windows. Los pasos de Linux son los mismos que macOS (usa tu gestor de paquetes en lugar de Homebrew).
Requisitos previos
- Una computadora con macOS 12+ o Windows 10/11
- Cursor instalado (plan gratuito o Pro)
- Un navegador antidetección instalado: Linken Sphere, Dolphin Anty, Wadex o Vision Browser
- Una conexión a Internet para descargar herramientas y paquetes
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 fácil es usar Homebrew. Si no tienes Homebrew, instálalo primero desde brew.sh. Luego:
brew install node@22
Windows
Descarga el instalador oficial desde nodejs.org. Elige la versión LTS (22.x). Ejecuta el instalador y sigue las instrucciones. Asegúrate de que "Add to PATH" esté marcado.
Verifica la instalación abriendo Terminal (macOS) o PowerShell (Windows):
node --version
# Expected output: v22.x.x or higher
npm --version
# Expected output: 10.x.x or higher
Paso 2 — Instalar Cursor
Cursor es un editor de código impulsado por AI construido sobre VS Code. Soporta MCP (Model Context Protocol) de forma nativa, lo que te permite usar herramientas externas como la automatización de navegadores.
- Descarga Cursor desde cursor.com
- Instálalo y ábrelo
- Inicia sesión con tu cuenta de Cursor (el plan gratuito funciona para MCP)
Si ya tienes Cursor instalado, asegúrate de que esté actualizado a la última versión — el soporte de MCP se agregó en versiones recientes.
Cursor Pro te da más solicitudes de AI por mes, pero el plan gratuito es suficiente para probar la automatización de navegadores con MCP.
Paso 3 — Crear una cuenta de Ornold
Ornold es el puente entre agentes de AI y navegadores antidetección. Necesitas una cuenta para obtener un token de API.
- Ve a mcp.ornold.com
- Haz clic en "Register" y crea una cuenta con tu correo electrónico
- Verifica tu correo electrónico con el código de 6 dígitos enviado a tu bandeja de entrada
- Aterrizarás en el panel de control — ¡listo!
Paso 4 — Crear un token de API
Después del registro, el panel de control te pedirá que crees tu primer token de API. Este token autentica tu conexión MCP.
- Ingresa un nombre para tu token (por ejemplo, "Cursor")
- Haz clic en "Create"
- Copia el token y guárdalo en un lugar seguro — lo necesitarás en el siguiente paso
Las cuentas gratuitas obtienen 1 asiento, 5 resoluciones de CAPTCHA (después de completar el tour) y acceso a navegadores estándar. Actualiza tu plan para más capacidad.
Paso 5 — Generar 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. Sin necesidad de escribir JSON 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" junto a él.
Paso del asistente 1 — Elige tu agente de AI
El asistente te preguntará qué agente de AI estás usando. Selecciona "Cursor" de la lista. El asistente generará la configuración en formato JSON para el mcp.json de Cursor. Otros agentes soportados incluyen Claude Code, Codex, VS Code, Windsurf y Cline.
Paso del asistente 2 — Elige el modo de interacción
Elige cómo el AI debe interactuar con las páginas del navegador:
- Modo DOM (predeterminado) — El AI lee la estructura HTML de la página. Cada elemento obtiene un marcador [ref=N]. Gratis y rápido. Mejor para formularios, páginas estructuradas y sitios web estándar.
- Modo Vision AI — El AI toma una captura de pantalla y encuentra visualmente elementos por su apariencia. Funciona en cualquier página, incluso interfaces basadas en canvas. Cada análisis cuesta 1 crédito de vision.
- Ambos modos — Todas las herramientas disponibles. El AI elige automáticamente el mejor enfoque para cada acción.
Comienza con el modo DOM. Es gratis, rápido y maneja el 90% de los casos de uso. Siempre puedes cambiar a "Ambos" más tarde si necesitas análisis visual.
Paso del asistente 3 — Habilitar navegadores antidetección
Activa los navegadores que usas y completa sus detalles de conexión:
- Linken Sphere — Solo establece el puerto de API (predeterminado: 40080). Asegúrate de que Sphere esté ejecutándose.
- Dolphin Anty — Establece el puerto local (predeterminado: 3001) y pega tu token de API de Dolphin desde Settings → API.
- Wadex — Establece el puerto de API (predeterminado: 8080).
- Vision Browser — Pega tu X-Token. Opcionalmente establece un puerto local.
Puedes habilitar múltiples navegadores a la vez. La configuración MCP incluirá todos ellos, y Cursor podrá controlar cualquiera que esté ejecutándose.
Paso del asistente 4 — Copia la configuración
El asistente genera la configuración JSON final basada en tus opciones. Haz clic en "Copy" para obtenerla — la pegarás en la configuración MCP de Cursor en el siguiente paso.
El asistente completa previamente tus valores reales de token y puerto — solo haz clic en "Copy" y pega. Sin necesidad de edición manual.
Paso 6 — Agregar Ornold MCP a Cursor
Cursor gestiona los servidores MCP a través de un archivo de configuración JSON. Puedes abrirlo desde Cursor Settings → MCP → "Add new MCP server" — esto abre el archivo mcp.json en el editor. Cursor almacena la configuración MCP en dos ubicaciones:
Si prefieres editar el archivo de configuración directamente, Cursor almacena la configuración MCP en:
# Global (all projects)
~/.cursor/mcp.json
# Per-project (this project only)
.cursor/mcp.json
Pega la configuración del asistente. Así es como se ve para Linken Sphere:
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--linken-port", "40080"]
}
}
}
Para Dolphin Anty:
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--dolphin-port", "3001", "--dolphin-token", "YOUR_DOLPHIN_TOKEN"]
}
}
}
Para múltiples navegadores a la vez:
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": [
"ornold-mcp",
"--token", "YOUR_TOKEN",
"--linken-port", "40080",
"--dolphin-port", "3001",
"--dolphin-token", "DOLPHIN_KEY",
"--wadex-port", "8080"
]
}
}
}
Usa ~/.cursor/mcp.json para configuración global (disponible en todos los proyectos). Usa .cursor/mcp.json en la raíz del proyecto para compartir la configuración con tu equipo a través del control de versiones.
Paso 7 — Inicia tu navegador y prueba
Asegúrate de que tu navegador antidetección esté ejecutándose antes de usar el chat de AI de Cursor. Lista de verificación rápida:
- Linken Sphere — Abre la aplicación. Crea al menos una sesión si no tienes ninguna.
- Dolphin Anty — Abre la aplicación. Asegúrate de que la API local esté habilitada en Settings.
- Wadex — Abre la aplicación y verifica que el puerto de API coincida con tu configuración.
Abre cualquier proyecto en Cursor e inicia un chat con el AI (Cmd+L o Ctrl+L). Asegúrate de estar en modo Agent — ese es donde están disponibles las herramientas MCP.
Paso 8 — Tu primer comando de navegador AI
Todo está conectado. Abre el chat de Cursor y habla con él en lenguaje natural. Aquí hay algunos comandos para probar:
# Start a Linken Sphere session and navigate
> Start a new 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
Herramientas MCP disponibles
Una vez conectado, Cursor tiene acceso a 40+ herramientas de automatización de navegadores. Aquí están las más comúnmente usadas:
- linken_start_instances / dolphin_start_profiles — Iniciar sesiones de navegador
- browser_parallel_navigate — Abrir URLs en todos los navegadores activos
- browser_parallel_snapshot — Obtener DOM de 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 capturas de pantalla de todas las sesiones
- browser_parallel_vision_analyze_grouped — Análisis visual de página impulsado por AI
- browser_solve_captcha — Resolver automáticamente reCAPTCHA, hCaptcha, Turnstile y más
- browser_parallel_evaluate — Ejecutar JavaScript en contexto de página
- linken_stop_instances / dolphin_stop_profiles — Cerrar sesiones
No necesitas recordar los nombres de las herramientas. Solo describe en inglés simple lo que quieres hacer y Cursor elegirá automáticamente las herramientas correctas.
Modos de interacción
Ornold MCP soporta dos modos de interacción. Puedes elegir al configurar:
Modo DOM (predeterminado, gratis)
El AI lee la estructura de la página a través de instantáneas DOM. Cada elemento obtiene un marcador [ref=N]. Rápido y no cuesta créditos de vision. Mejor para páginas estructuradas con HTML claro.
Modo Vision AI (pagado por análisis)
El AI toma una captura de pantalla y usa análisis visual para encontrar elementos por su apariencia. Funciona en cualquier página, incluso SPA complejas o interfaces basadas en canvas. Cada análisis cuesta 1 crédito de vision.
Para habilitar ambos modos, agrega la bandera --mode a tus argumentos de configuración MCP:
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--mode", "both", "--linken-port", "40080"]
}
}
}
Modo Agent de Cursor vs modo Ask
Cursor tiene dos modos de chat. Las herramientas MCP solo funcionan en modo Agent:
- Modo Agent — El AI puede usar herramientas MCP, ejecutar comandos de terminal y editar archivos. Esto es lo que necesitas para la automatización de navegadores.
- Modo Ask — El AI solo responde preguntas basadas en tu base de código. Sin acceso a herramientas. Las herramientas MCP no aparecerán aquí.
Asegúrate de estar en modo Agent (verifica el menú desplegable en la parte superior del panel de chat) antes de intentar comandos de navegador. Si no ves herramientas MCP, cambia a modo Agent.
También puedes usar Composer de Cursor (Cmd+I / Ctrl+I) para tareas de automatización de navegadores de múltiples pasos. Composer también soporta herramientas MCP en modo Agent.
Solución de problemas
- "MCP server not showing" — Asegúrate de que mcp.json sea JSON válido. Incluso una coma al final lo romperá. Usa un validador JSON si no estás seguro.
- "npx: command not found" — Node.js no está en PATH. Reinicia Cursor después de instalar Node.js. En macOS con nvm, es posible que necesites establecer la ruta completa a npx en el campo de comando.
- "Cannot connect to Linken Sphere" — Asegúrate de que Sphere esté ejecutándose y el puerto de API sea correcto (predeterminado 40080). Verifica que el firewall no bloquee el puerto.
- "Token invalid" — Copia el token nuevamente desde el panel mcp.ornold.com. Los tokens son cadenas largas — asegúrate de haber copiado el valor completo.
- "Tools not appearing in chat" — Asegúrate de estar en modo Agent, no en modo Ask. Verifica Cursor Settings → MCP para confirmar que el servidor muestra un estado verde "connected".
- "CAPTCHA solve failed" — Verifica tu saldo de créditos de CAPTCHA en el panel de Ornold. El plan gratuito incluye soluciones limitadas.
- "Server disconnected" — Cursor puede desconectar servidores MCP después del tiempo de inactividad. Reinicia el chat o cambia el servidor en Settings → MCP.
¿Qué sigue?
- Lee la guía Claude Code + Ornold MCP si también usas Claude Code
- Lee la guía Codex + Ornold MCP si también usas OpenAI Codex
- Aprende sobre automatización paralela de navegadores para ejecutar 10+ sesiones a la vez
- Consulta la guía de resolución de CAPTCHA para manejar reCAPTCHA, hCaptcha y Turnstile
- Explora modo Vision AI para interactuar con interfaces visuales complejas