Guía3 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

La forma más fácil: pídele a tu agente IA que instale

Los agentes IA modernos (Claude Code, Cursor, Windsurf, Cline, Codex) pueden instalar Ornold MCP por sí mismos. Pega un prompt con tu token, el agente edita la config y conecta vía CDP. Sin editar JSON manualmente.

Paso 1 — Inicia Linken Sphere

Abre Linken Sphere
Asegúrate de que existe al menos una sesión (créala si es necesario)
Anota el puerto API — por defecto es `40080`

La API de Linken Sphere siempre está activa — sin interruptor. Ornold conecta vía CDP automáticamente cuando el puerto coincide.

Paso 2 — Obtén tu token Ornold

Regístrate en mcp.ornold.com
Abre la página Tokens
Click en Create token, copia el valor

Paso 3 — Pega el prompt de instalación en tu agente

Elige tu agente y pega el prompt correspondiente. Reemplaza `YOUR_TOKEN` con el token del paso 2.

Claude Code

Install Ornold MCP for Linken Sphere automation.

Requirements: Node.js ≥ 18.
Token: https://mcp.ornold.com → Tokens → Create token.

Run:
claude mcp add --transport stdio ornold-browser -- npx mcp-ornold-browser --token YOUR_TOKEN --linken-port 40080 --mode vision
npx mcp-ornold-browser --install-skill

After setup, verify by calling browser_list.

Cursor

Install Ornold MCP for Linken Sphere automation.

Requirements: Node.js ≥ 18.
Token: https://mcp.ornold.com → Tokens → Create token.

Edit ~/.cursor/mcp.json and add:
{
  "mcpServers": {
    "ornold-browser": {
      "command": "npx",
      "args": ["mcp-ornold-browser", "--token", "YOUR_TOKEN", "--linken-port", "40080", "--mode", "vision"]
    }
  }
}

Restart Cursor after saving.

Codex

Install Ornold MCP for Linken Sphere automation.

Requirements: Node.js ≥ 18.
Token: https://mcp.ornold.com → Tokens → Create token.

Edit ~/.codex/config.toml and add:

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

Paso 4 — Verifica

Pregunta al agente:

List my connected Linken Sphere sessions using browser_list

Si las sesiones aparecen, estás listo. Prueba:

Open google.com in all my sessions and take a screenshot

¿Por qué modo Vision para antidetección?

El flag `--mode vision` le dice a Ornold que interactúe vía screenshots + clics por coordenadas (con curvas Bezier) en vez de selectores CSS. Sitios antidetección marcan DOM scraping; los clics por coordenadas parecen humanos y evitan estos chequeos.

Solución de problemas

**browser_list vacío** — Asegúrate de que Linken Sphere está abierto con al menos una sesión corriendo.
**Puerto incorrecto** — Por defecto es 40080. Si lo cambiaste en Linken Sphere settings, actualiza el valor `--linken-port`.
**Token inválido** — Vuelve a copiar de la página Tokens en mcp.ornold.com.
**npx: command not found** — Instala Node.js 18+ desde nodejs.org.

¿Qué sigue?

Automatización paralela de navegadores — corre acciones en muchas sesiones Sphere a la vez
Guía de resolución de CAPTCHA — reCAPTCHA, hCaptcha, Turnstile en Linken Sphere
Vision AI vs selectores CSS — por qué importa para antidetección