Voltar ao blog
Guia3 min de leitura
Linken Sphere MCP Setup: conecte agentes IA ao seu navegador antidetect
Guia passo a passo para conectar Claude Code, Cursor, Windsurf ou Cline ao Linken Sphere. Controle sessões com linguagem natural, sem scripts.
18 de abr. de 2026A maneira mais fácil: peça ao seu agente IA para instalar
Agentes IA modernos (Claude Code, Cursor, Windsurf, Cline, Codex) podem instalar Ornold MCP sozinhos. Cole um prompt com seu token, o agente edita a config e conecta via CDP. Sem JSON manual.
Passo 1 — Iniciar Linken Sphere
- Abra Linken Sphere
- Pelo menos uma sessão deve existir (crie se necessário)
- Anote a porta API — padrão é `40080`
A API do Linken Sphere está sempre ativa — sem interruptor. Ornold conecta via CDP automaticamente quando a porta API combina.
Passo 2 — Obtenha seu token Ornold
- Cadastre-se em mcp.ornold.com
- Abra a página Tokens
- Clique em Create token, copie o valor
Passo 3 — Cole o prompt de instalação no seu agente
Escolha seu agente e cole o prompt correspondente. Substitua `YOUR_TOKEN` pelo token do passo 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"]
Passo 4 — Verifique
Pergunte ao agente:
List my connected Linken Sphere sessions using browser_list
Se as sessões aparecerem, você está pronto. Tente:
Open google.com in all my sessions and take a screenshot
Por que modo Vision para antidetect?
O flag `--mode vision` diz ao Ornold para interagir via screenshots + cliques por coordenadas (com curvas Bezier) em vez de seletores CSS. Sites antidetect detectam DOM scraping; cliques por coordenadas parecem humanos e burlam essas verificações.
Solução de problemas
- **browser_list vazio** — Garanta que Linken Sphere está aberto com pelo menos uma sessão rodando.
- **Porta errada** — Padrão é 40080. Se mudou nas settings do Linken Sphere, atualize `--linken-port`.
- **Token inválido** — Copie de novo da página Tokens em mcp.ornold.com.
- **npx: command not found** — Instale Node.js 18+ de nodejs.org.
Próximos passos?
- Automação paralela de navegadores — ações em várias sessões Sphere ao mesmo tempo
- Guia de resolução CAPTCHA — reCAPTCHA, hCaptcha, Turnstile no Linken Sphere
- Vision AI vs seletores CSS — por que isso importa para antidetect