Guia12 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 2026

O que você obterá

Ao final deste guia, você terá agentes de IA (Claude Code, Cursor, Windsurf ou Cline) controlando sessões reais do Linken Sphere — abrindo páginas, preenchendo formulários, resolvendo CAPTCHAs e gerenciando múltiplas sessões — tudo através de comandos em linguagem natural. Sem scripts Playwright. Sem seletores CSS. Apenas diga à IA o que fazer.

Este guia cobre Linken Sphere especificamente. Se você estiver usando Dolphin Anty, Wadex ou Vision Browser, consulte os guias de configuração específicos do navegador.

Pré-requisitos

Linken Sphere instalado e em execução
Pelo menos uma sessão criada no Linken Sphere
Node.js 20+ instalado (nodejs.org)
Um agente de IA: Claude Code, Cursor, Windsurf ou Cline
Familiaridade básica com terminal/linha de comando

Passo 1 — Ativar API do Linken Sphere

Linken Sphere expõe uma API HTTP local que Ornold MCP usa para iniciar e controlar sessões. A API está ativada por padrão na porta 40080.

Abra Linken Sphere
Certifique-se de que o aplicativo está em execução
A API está automaticamente disponível em http://localhost:40080
Nenhuma configuração adicional necessária — a API do Linken Sphere está sempre ativada

Se você alterou a porta padrão nas configurações do Linken Sphere, anote-a — você precisará dela no Passo 4.

Passo 2 — Criar uma conta Ornold

Ornold é a ponte entre agentes de IA e navegadores anti-detecção. Você precisa de uma conta para obter um token de API.

Vá para mcp.ornold.com
Clique em "Inscrever-se" e crie uma conta com seu e-mail
Verifique seu e-mail com o código de 6 dígitos enviado para sua caixa de entrada
Você chegará ao painel de controle — pronto para o próximo passo

🖼️

Crie sua conta Ornold em mcp.ornold.com

Passo 3 — Criar um token de API

Após o registro, o painel de controle solicitará que você crie seu primeiro token de API. Este token autentica a conexão MCP.

Digite um nome para o token (por exemplo, "Linken Sphere")
Clique em "Criar"
Copie o token e salve-o em um local seguro — você precisará dele no próximo passo

🖼️

Crie e copie seu token de API

O plano gratuito inclui 1 slot, 5 resoluções de CAPTCHA (após integração) e acesso a navegadores padrão. Atualize para mais capacidade.

Passo 4 — Gerar configuração MCP via assistente de configuração

O painel de controle Ornold possui um assistente de conexão integrado que gera a configuração MCP exata para sua configuração. Sem digitação manual — apenas selecione suas opções e copie o resultado.

Vá para a aba "API Tokens" no painel de controle. Encontre seu token e clique no botão "Conectar" ao lado dele.

🖼️

Clique em "Conectar" no seu token para abrir o assistente

Passo do assistente 1 — Selecione seu agente de IA

O assistente perguntará qual agente de IA você está usando. Selecione seu agente da lista (Claude Code, Cursor, Windsurf, Cline ou Codex). Cada agente obtém seu próprio formato de configuração.

🖼️

Passo 1: Selecione seu agente de IA

Passo do assistente 2 — Escolha o modo de interação

Escolha como a IA deve interagir com as páginas do navegador:

Modo DOM (padrão) — A IA lê a estrutura HTML. Cada elemento obtém um marcador [ref=N]. Gratuito e rápido. Melhor para formulários, páginas estruturadas e sites padrão.
Modo Vision IA — A IA tira uma captura de tela e encontra elementos visualmente por aparência. Funciona em qualquer página, incluindo interfaces canvas. Cada análise custa 1 crédito de visão.
Ambos os modos — Todas as ferramentas disponíveis. A IA escolhe automaticamente a melhor abordagem para cada ação.

Comece com o modo DOM. É gratuito, rápido e lida com 90% das tarefas. Você sempre pode mudar para "Ambos os modos" se precisar de análise visual.

🖼️

Passo 2: Escolha o modo DOM para a maioria dos casos

Passo do assistente 3 — Ativar Linken Sphere

Ative Linken Sphere e preencha os detalhes de conexão:

Porta de API (padrão: 40080) — use o padrão a menos que você o tenha alterado nas configurações do Linken Sphere

Você pode ativar múltiplos navegadores ao mesmo tempo. A configuração MCP incluirá todos eles, e o agente de IA pode controlar qualquer um que esteja em execução.

🖼️

Passo 3: Ative Linken Sphere e confirme a porta

Passo do assistente 4 — Copiar e aplicar configuração

O assistente gera a configuração final com base em suas escolhas. Para a maioria dos agentes de IA, você tem duas opções:

Opção A: Comando de terminal (recomendado)

Copie o comando de uma linha e cole-o em seu terminal. Esta é uma configuração única — MCP iniciará automaticamente com seu agente de IA a cada vez depois.

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

🖼️

Passo 4: Copie o comando de terminal e execute-o

Opção B: Arquivo .mcp.json do projeto

Se você deseja compartilhar a configuração MCP com sua equipe via controle de versão, copie o JSON e salve-o como .mcp.json na raiz do seu projeto:

{
  "mcpServers": {
    "ornold-browser": {
      "command": "npx",
      "args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--linken-port", "40080"]
    }
  }
}

O assistente preenche automaticamente seus valores de token e porta — apenas clique em "Copiar" e cole. Nenhuma edição manual necessária.

Verifique se o servidor MCP está registrado:

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

🖼️

Servidor MCP Ornold registrado com sucesso

Passo 5 — Inicie Linken Sphere e teste

Antes de executar seu agente de IA, certifique-se de que Linken Sphere está aberto e você tem pelo menos uma sessão criada.

Abra Linken Sphere
Certifique-se de ter pelo menos uma sessão na lista
Mantenha Linken Sphere em execução em segundo plano

Passo 6 — Primeiro comando de navegador de IA

Tudo está conectado. Inicie seu agente de IA (Claude Code, Cursor, Windsurf ou Cline) e fale com ele em linguagem natural. Aqui estão alguns comandos para começar:

# 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 via linguagem natural

Ferramentas MCP disponíveis

Após conectar, seu agente de IA obtém acesso a 40+ ferramentas de automação de navegador. Aqui estão as mais comumente usadas:

browser_list — Listar todas as sessões disponíveis do Linken Sphere
browser_parallel_navigate — Abrir uma URL em todos os navegadores ativos
browser_parallel_snapshot — Obter DOM da página com marcadores clicáveis [ref=N]
browser_parallel_click — Clicar em elementos por ref ou seletor
browser_parallel_fill — Digitar texto em campos de entrada
browser_parallel_screenshot — Tirar capturas de tela de todas as sessões
browser_parallel_vision_analyze_grouped — Análise visual de páginas com IA
browser_solve_captcha — Resolver automaticamente reCAPTCHA, hCaptcha, Turnstile e mais
browser_parallel_evaluate — Executar JavaScript no contexto da página
browser_status — Verificar quais sessões estão em execução

Você não precisa memorizar nomes de ferramentas. Apenas descreva o que deseja em linguagem simples, e o agente de IA escolherá automaticamente as ferramentas corretas.

Áreas de trabalho do Linken Sphere

Linken Sphere organiza sessões em "áreas de trabalho" — espaços de trabalho isolados que agrupam sessões relacionadas. Quando você inicia uma sessão via MCP, ela usa a área de trabalho ativa no Linken Sphere.

Para controlar qual área de trabalho é usada, alterne para ela no Linken Sphere antes de executar comandos de IA. A ponte MCP respeita sua seleção de área de trabalho ativa.

Modos de interação

Ornold MCP suporta dois modos de interação. Você escolheu um durante a configuração:

Modo DOM (padrão, gratuito)

A IA lê a estrutura da página através de snapshots DOM. Cada elemento obtém um marcador [ref=N]. Rápido e não consome créditos de visão. Melhor para páginas estruturadas com HTML claro.

Modo Vision IA (pago, por análise)

A IA tira uma captura de tela e usa análise visual para encontrar elementos por aparência. Funciona em qualquer página, incluindo SPAs complexas ou interfaces canvas. Cada análise custa 1 crédito de visão.

# Enable both modes:
claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --mode both --linken-port 40080

Solução de problemas

"No sessions found" — Certifique-se de que Linken Sphere está em execução e você tem pelo menos uma sessão criada.
"Connection refused" — Verifique se o número da porta (padrão: 40080) corresponde à sua porta de API do Linken Sphere. Certifique-se de que o firewall não está bloqueando conexões localhost.
"MCP server not found" — Execute `claude mcp list` para verificar se ornold-browser está registrado. Se não, execute novamente o comando de configuração do Passo 4.
"Permission denied (npm install)" — No macOS, adicione o prefixo sudo. No Windows, execute PowerShell como administrador.
"Session launch timeout" — Linken Sphere pode ser lento ao iniciar sessões na primeira execução. Aguarde 10-15 segundos e tente novamente.

E agora?

Leia o guia de automação do Dolphin Anty (/blog/dolphin-anty-mcp-setup) para comparar com outro navegador anti-detecção popular
Aprenda sobre automação paralela de navegadores (/blog/parallel-browser-automation) para executar 10+ sessões simultaneamente
Consulte o guia de resolução de CAPTCHA (/blog/captcha-solving-guide) para lidar com reCAPTCHA, hCaptcha e Turnstile
Explore o modo Vision IA (/blog/vision-vs-selectors) para interagir com interfaces visuais complexas