Guía12 min de lectura

Linken Sphere MCP Setup: conecta agentes IA a tu navegador antidetección

Guía paso a paso para conectar Claude Code, Cursor, Windsurf o Cline a Linken Sphere. Controla sesiones con lenguaje natural, sin scripts.

18 abr 2026

Lo que obtendrás

Al final de esta guía, tendrás agentes de IA (Claude Code, Cursor, Windsurf o Cline) controlando sesiones reales de Linken Sphere — abriendo páginas, rellenando formularios, resolviendo CAPTCHA y gestionando múltiples sesiones — todo a través de comandos en lenguaje natural. Sin scripts de Playwright. Sin selectores CSS. Solo dile a la IA qué hacer.

Esta guía cubre Linken Sphere específicamente. Si estás usando Dolphin Anty, Wadex o Vision Browser, consulta las guías de configuración específicas del navegador.

Requisitos previos

Linken Sphere instalado y en ejecución
Al menos una sesión creada en Linken Sphere
Node.js 20+ instalado (nodejs.org)
Un agente de IA: Claude Code, Cursor, Windsurf o Cline
Familiaridad básica con terminal/línea de comandos

Paso 1 — Habilitar API de Linken Sphere

Linken Sphere expone una API HTTP local que Ornold MCP utiliza para lanzar y controlar sesiones. La API está habilitada por defecto en el puerto 40080.

Abre Linken Sphere
Asegúrate de que la aplicación está en ejecución
La API está disponible automáticamente en http://localhost:40080
No se requiere configuración adicional — la API de Linken Sphere siempre está activada

Si cambiaste el puerto predeterminado en la configuración de Linken Sphere, anótalo — lo necesitarás en el Paso 4.

Paso 2 — Crear una cuenta Ornold

Ornold es el puente entre agentes de IA y navegadores antidetección. Necesitas una cuenta para obtener un token de API.

Ve a mcp.ornold.com
Haz clic en "Registrarse" 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
Llegarás al panel de control — listo para el siguiente paso

🖼️

Crea tu cuenta Ornold en mcp.ornold.com

Paso 3 — 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 la conexión MCP.

Ingresa un nombre para el token (por ejemplo, "Linken Sphere")
Haz clic en "Crear"
Copia el token y guárdalo en un lugar seguro — lo necesitarás en el siguiente paso

🖼️

Crea y copia tu token de API

El plan gratuito incluye 1 ranura, 5 resoluciones de CAPTCHA (después de la incorporación) y acceso a navegadores estándar. Actualiza para más capacidad.

Paso 4 — Generar configuración MCP a través del asistente de configuración

El panel de control de Ornold tiene un asistente de conexión integrado que genera la configuración MCP exacta para tu configuración. Sin escritura manual — solo selecciona tus opciones y copia el resultado.

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

🖼️

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

Paso del asistente 1 — Selecciona tu agente de IA

El asistente te preguntará qué agente de IA estás usando. Selecciona tu agente de la lista (Claude Code, Cursor, Windsurf, Cline o Codex). Cada agente obtiene su propio formato de configuración.

🖼️

Paso 1: Selecciona tu agente de IA

Paso del asistente 2 — Elige modo de interacción

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

Modo DOM (predeterminado) — La IA lee la estructura HTML. 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 — La IA toma una captura de pantalla y encuentra elementos visualmente por apariencia. Funciona en cualquier página, incluyendo interfaces 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.

Comienza con modo DOM. Es gratis, rápido y maneja el 90% de las tareas. Siempre puedes cambiar a "Ambos modos" si necesitas análisis visual.

🖼️

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

Paso del asistente 3 — Habilitar Linken Sphere

Activa Linken Sphere y completa los detalles de conexión:

Puerto de API (predeterminado: 40080) — usa el predeterminado a menos que lo hayas cambiado en la configuración de Linken Sphere

Puedes habilitar múltiples navegadores a la vez. La configuración MCP incluirá todos ellos, y el agente de IA puede controlar cualquiera que esté en ejecución.

🖼️

Paso 3: Habilita Linken Sphere y confirma el puerto

Paso del asistente 4 — Copiar y aplicar configuración

El asistente genera la configuración final basada en tus opciones. Para la mayoría de agentes de IA, tienes dos opciones:

Opción A: Comando de terminal (recomendado)

Copia el comando de una línea y pégalo en tu terminal. Esta es una configuración única — MCP se iniciará automáticamente con tu agente de IA cada vez después.

claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --linken-port 40080

🖼️

Paso 4: Copia el comando de terminal y ejecútalo

Opción B: Archivo .mcp.json del proyecto

Si deseas compartir la configuración MCP con tu equipo a través del 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 tus valores de token y puerto — solo haz clic en "Copiar" y pega. No se requiere edición manual.

Verifica que el servidor MCP esté registrado:

claude mcp list
# You should see "ornold-browser" in the list

🖼️

Servidor MCP de Ornold registrado exitosamente

Paso 5 — Lanza Linken Sphere y prueba

Antes de ejecutar tu agente de IA, asegúrate de que Linken Sphere esté abierto y tengas al menos una sesión creada.

Abre Linken Sphere
Asegúrate de tener al menos una sesión en la lista
Mantén Linken Sphere ejecutándose en segundo plano

Paso 6 — Primer comando de navegador de IA

Todo está conectado. Lanza tu agente de IA (Claude Code, Cursor, Windsurf o Cline) y habla con él en lenguaje natural. Aquí hay algunos comandos para comenzar:

# Start a Linken Sphere session and navigate
> Start a 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

🖼️

Agente de IA controlando Linken Sphere a través de lenguaje natural

Herramientas MCP disponibles

Después de conectar, tu agente de IA obtiene acceso a 40+ herramientas de automatización de navegador. Aquí están las más comúnmente usadas:

browser_list — Lista todas las sesiones disponibles de Linken Sphere
browser_parallel_navigate — Abre una URL en todos los navegadores activos
browser_parallel_snapshot — Obtiene DOM de página con marcadores clicables [ref=N]
browser_parallel_click — Haz clic en elementos por ref o selector
browser_parallel_fill — Escribe texto en campos de entrada
browser_parallel_screenshot — Toma capturas de pantalla de todas las sesiones
browser_parallel_vision_analyze_grouped — Análisis visual de páginas con IA
browser_solve_captcha — Resuelve automáticamente reCAPTCHA, hCaptcha, Turnstile y más
browser_parallel_evaluate — Ejecuta JavaScript en contexto de página
browser_status — Verifica qué sesiones están en ejecución

No necesitas memorizar nombres de herramientas. Solo describe lo que quieres en lenguaje simple, y el agente de IA elegirá automáticamente las herramientas correctas.

Escritorios de Linken Sphere

Linken Sphere organiza sesiones en "escritorios" — espacios de trabajo aislados que agrupan sesiones relacionadas. Cuando inicias una sesión a través de MCP, utiliza el escritorio actualmente activo en Linken Sphere.

Para controlar qué escritorio se usa, cambia a él en Linken Sphere antes de ejecutar comandos de IA. El puente MCP respeta tu selección de escritorio activo.

Modos de interacción

Ornold MCP soporta dos modos de interacción. Elegiste uno durante la configuración:

Modo DOM (predeterminado, gratis)

La IA lee la estructura de la página a través de snapshots DOM. Cada elemento obtiene un marcador [ref=N]. Rápido y no consume créditos de visión. Mejor para páginas estructuradas con HTML claro.

Modo Vision AI (pagado, por análisis)

La IA toma una captura de pantalla y usa análisis visual para encontrar elementos por apariencia. Funciona en cualquier página, incluyendo SPA complejas o interfaces 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 --linken-port 40080

Solución de problemas

"No sessions found" — Asegúrate de que Linken Sphere está en ejecución y tienes al menos una sesión creada.
"Connection refused" — Verifica que el número de puerto (predeterminado: 40080) coincida con tu puerto de API de Linken Sphere. Asegúrate de que el firewall no bloquea conexiones localhost.
"MCP server not found" — Ejecuta `claude mcp list` para verificar que ornold-browser está registrado. Si no, vuelve a ejecutar el comando de configuración del Paso 4.
"Permission denied (npm install)" — En macOS, añade prefijo sudo. En Windows, ejecuta PowerShell como administrador.
"Session launch timeout" — Linken Sphere puede ser lento al lanzar sesiones en la primera ejecución. Espera 10-15 segundos e intenta de nuevo.

¿Qué sigue?

Lee la guía de automatización de Dolphin Anty (/blog/dolphin-anty-mcp-setup) para comparar con otro navegador antidetección popular
Aprende sobre automatización paralela de navegadores (/blog/parallel-browser-automation) para ejecutar 10+ sesiones a la vez
Consulta la guía de resolución de CAPTCHA (/blog/captcha-solving-guide) para manejar reCAPTCHA, hCaptcha y Turnstile
Explora el modo Vision AI (/blog/vision-vs-selectors) para interactuar con interfaces visuales complejas