Volver al blog
Guía15 min de lectura
Claude Code + Ornold MCP: guía completa de configuración
Instala Node.js, configura Claude Code, conecta Ornold MCP y automatiza navegadores antidetección con IA. macOS y Windows.
17 abr 2026Qué vas a construir
Al finalizar esta guía, tendrás Claude Code controlando sesiones reales de navegadores antidetección: navegando páginas, rellenando formularios, resolviendo CAPTCHAs y gestionando múltiples perfiles, todo mediante comandos en lenguaje natural. Sin scripts de Playwright. Sin selectores CSS. Solo dile a la IA qué hacer.
Esta guía cubre macOS y Windows. Los pasos para Linux son iguales a los de macOS (usa tu gestor de paquetes en lugar de Homebrew).
Requisitos previos
- Un ordenador con macOS 12+ o Windows 10/11
- Un navegador antidetección instalado: Linken Sphere, Dolphin Anty, Wadex o Vision Browser
- Conexión a internet para descargar herramientas y paquetes
- Comodidad básica con la terminal (macOS) o PowerShell (Windows)
Paso 1 — Instalar Node.js
Ornold MCP se ejecuta como un paquete Node.js. Necesitas Node.js versión 20 o superior.
macOS
La forma más sencilla 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 marcar "Add to PATH".
Verifica la instalación abriendo la 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 Claude Code
Claude Code es el agente de codificación con IA de Anthropic que se ejecuta en tu terminal. Es compatible con MCP (Model Context Protocol), lo que le permite utilizar herramientas externas, como la automatización del navegador.
macOS
npm install -g @anthropic-ai/claude-code
Windows
Abre PowerShell como Administrador y ejecuta:
npm install -g @anthropic-ai/claude-code
Tras la instalación, lanza Claude Code para completar la autenticación:
claude
# Follow the prompts to sign in with your Anthropic account
Claude Code requiere una clave API de Anthropic o una suscripción a Claude Pro/Team. Si aún no tienes una, regístrate en console.anthropic.com.
Paso 3 — Crear una cuenta en Ornold
Ornold es el puente entre los agentes de IA y los navegadores antidetección. Necesitas una cuenta para obtener un token API.
- Ve a mcp.ornold.com
- Haz clic en "Register" y crea una cuenta con tu correo electrónico
- Verifica tu correo con el código de 6 dígitos enviado a tu bandeja de entrada
- Llegarás al panel de control — ¡ya estás dentro!
Paso 4 — Crear un token API
Tras el registro, el panel te pedirá que crees tu primer token API. Este token autentica tu conexión MCP.
- Introduce un nombre para tu token (p. ej., "Claude Code")
- Haz clic en "Create"
- Copia el token y guárdalo en un lugar seguro — lo necesitarás en el siguiente paso
Las cuentas gratuitas incluyen 1 puesto, 5 resoluciones de captcha (tras completar el tour) y acceso a navegadores estándar. Actualiza tu plan para obtener más capacidad.
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 entorno. No necesitas construir comandos manualmente — solo elige tus opciones y copia el resultado.
Ve a la pestaña API Tokens del panel. Localiza tu token y haz clic en el botón "Connect" que aparece junto a él.
Asistente — Paso 1: Elige tu agente de IA
El asistente pregunta qué agente de IA estás usando. Selecciona "Claude Code" de la lista. Otros agentes compatibles son Cursor, VS Code, Windsurf, Cline y Codex — cada uno recibe un formato de configuración adaptado.
Asistente — Paso 2: Elige 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 una marca [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" si necesitas análisis visual.
Asistente — Paso 3: Activa los navegadores antidetección
Activa los navegadores que uses e introduce sus datos de conexión:
- Linken Sphere — Solo configura el puerto API (por defecto: 40080). Asegúrate de que Sphere esté en ejecución.
- Dolphin Anty — Configura el puerto local (por defecto: 3001) y pega tu token API de Dolphin desde Ajustes → API.
- Wadex — Configura el puerto API (por defecto: 8080).
- Vision Browser — Pega tu X-Token. Opcionalmente, configura un puerto local.
Puedes activar varios navegadores a la vez. La configuración MCP los incluirá todos, y el agente de IA podrá controlar el que esté en ejecución.
Asistente — Paso 4: Copia y aplica la configuración
El asistente genera la configuración final en función de tus elecciones. Para Claude Code, tienes dos opciones:
Opción A: Comando de terminal (recomendado)
Copia el comando de una sola línea y pégalo en tu terminal. Es una configuración única — después, MCP se inicia automáticamente con Claude Code en cada ocasión.
claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --linken-port 40080
Opción B: Archivo .mcp.json del proyecto
Si quieres compartir la configuración MCP con tu equipo mediante control de versiones, copia el JSON y guárdalo como .mcp.json en la raíz de tu proyecto:
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--linken-port", "40080"]
}
}
}
El asistente completa automáticamente tu token y los valores de puerto reales — solo haz clic en "Copy" y pega. No es necesario editar nada manualmente.
Verifica que el servidor MCP se ha registrado:
claude mcp list
# You should see "ornold-browser" in the list
Paso 6 — Inicia tu navegador y prueba
Asegúrate de que tu navegador antidetección está en ejecución antes de iniciar Claude Code. 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 Ajustes.
- Wadex — Abre la aplicación y verifica que el puerto API coincide con tu configuración.
Paso 7 — Tu primer comando de navegador con IA
Todo está conectado. Inicia Claude Code en cualquier directorio:
claude
Ahora háblale en lenguaje natural. Aquí tienes 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, Claude Code tiene acceso a más de 40 herramientas de automatización de navegador. Aquí están las más utilizadas:
- 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 marcas [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 IA
- browser_solve_captcha — Resolver automáticamente 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 recordar los nombres de las herramientas. Solo describe lo que quieres en español sencillo y Claude Code elegirá las herramientas adecuadas automáticamente.
Modos de interacción
Ornold MCP admite dos modos de interacción. Puedes elegirlo durante la configuración:
Modo DOM (predeterminado, gratuito)
La IA lee la estructura de la página mediante instantáneas DOM. Cada elemento recibe una marca [ref=N]. Rápido y sin coste en créditos de visión. Ideal para páginas estructuradas con HTML claro.
Modo Vision AI (de pago por análisis)
La IA toma una captura de pantalla y utiliza análisis visual para localizar elementos por su apariencia. Funciona en cualquier página, incluso en SPAs complejas o interfaces basadas en canvas. Cada análisis cuesta 1 crédito de visión.
# Enable both modes:
claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --mode both
Resolución de problemas
- "npx: command not found" — Node.js no está en el PATH. Reinicia la terminal tras instalar Node.js. En Windows, asegúrate de haber marcado "Add to PATH" durante la instalación.
- "Cannot connect to Linken Sphere" — Asegúrate de que Sphere está en ejecución y el puerto API es correcto (por defecto 40080). Comprueba que ningún cortafuegos bloquea el puerto.
- "Token invalid" — Copia el token de nuevo desde el panel de mcp.ornold.com. Los tokens son cadenas largas — asegúrate de haber copiado el valor completo.
- "MCP server not responding" — Ejecuta `claude mcp list` para verificar el registro. Prueba a eliminar y volver a añadir: `claude mcp remove ornold-browser` y luego vuelve a ejecutar el comando de adición.
- "CAPTCHA solve failed" — Comprueba tu saldo de créditos de captcha en el panel de Ornold. El plan gratuito incluye un número limitado de resoluciones.
- "Permission denied (npm install)" — En macOS, añade sudo al principio. En Windows, ejecuta PowerShell como Administrador.
¿Qué sigue?
- Lee la guía de automatización de Linken Sphere para la gestión avanzada de sesiones
- Aprende sobre la automatización de navegador en paralelo para ejecutar 10 o más sesiones a la vez
- Consulta la guía de resolución de CAPTCHA para gestionar reCAPTCHA, hCaptcha y Turnstile
- Explora el modo Vision AI para interactuar con interfaces visuales complejas