Voltar ao blog
Guia15 min de leitura
Claude Code + Ornold MCP: guia completo de configuração
Instale o Node.js, configure o Claude Code, conecte o Ornold MCP e automatize navegadores antidetect com IA. macOS e Windows.
17 de abr. de 2026O que você vai construir
Ao final deste guia, você terá o Claude Code controlando sessões reais de navegador antidetect — navegando em páginas, preenchendo formulários, resolvendo CAPTCHAs e gerenciando múltiplos perfis — tudo por meio de comandos em linguagem natural. Sem scripts do Playwright. Sem seletores CSS. Basta dizer à IA o que fazer.
Este guia cobre macOS e Windows. As etapas do Linux são as mesmas que as do macOS (use seu gerenciador de pacotes em vez do Homebrew).
Pré-requisitos
- Um computador com macOS 12+ ou Windows 10/11
- Um navegador antidetect instalado: Linken Sphere, Dolphin Anty, Wadex ou Vision Browser
- Uma conexão com a internet para baixar ferramentas e pacotes
- Familiaridade básica com o terminal (macOS) ou PowerShell (Windows)
Passo 1 — Instalar o Node.js
O Ornold MCP funciona como um pacote Node.js. Você precisa do Node.js versão 20 ou superior.
macOS
A forma mais fácil é usar o Homebrew. Se você não tem o Homebrew, instale-o primeiro em brew.sh. Em seguida:
brew install node@22
Windows
Baixe o instalador oficial em nodejs.org. Escolha a versão LTS (22.x). Execute o instalador e siga as instruções. Certifique-se de que "Adicionar ao PATH" está marcado.
Verifique a instalação abrindo o Terminal (macOS) ou PowerShell (Windows):
node --version
# Saída esperada: v22.x.x ou superior
npm --version
# Saída esperada: 10.x.x ou superior
Passo 2 — Instalar o Claude Code
O Claude Code é o agente de codificação IA da Anthropic que roda no seu terminal. Ele suporta MCP (Model Context Protocol), que permite usar ferramentas externas — como automação de navegador.
macOS
npm install -g @anthropic-ai/claude-code
Windows
Abra o PowerShell como Administrador e execute:
npm install -g @anthropic-ai/claude-code
Após a instalação, inicie o Claude Code para concluir a autenticação:
claude
# Siga as instruções para entrar com sua conta Anthropic
O Claude Code requer uma chave de API da Anthropic ou uma assinatura Claude Pro/Team. Se você ainda não tem uma, cadastre-se em console.anthropic.com.
Passo 3 — Criar uma conta no Ornold
O Ornold é a ponte entre agentes de IA e navegadores antidetect. Você precisa de uma conta para obter um token de API.
- Acesse mcp.ornold.com
- Clique em "Registrar" 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 — está dentro!
Passo 4 — Criar um token de API
Após o registro, o painel solicitará que você crie seu primeiro token de API. Esse token autentica sua conexão MCP.
- Digite um nome para o seu token (ex.: "Claude Code")
- Clique em "Criar"
- Copie o token e salve-o em um lugar seguro — você precisará dele no próximo passo
Contas gratuitas recebem 1 vaga, 5 resoluções de CAPTCHA (após concluir o tour) e acesso a navegadores padrão. Faça upgrade do seu plano para mais capacidade.
Passo 5 — Gerar a configuração MCP com o assistente do painel
O painel do Ornold tem um assistente de conexão integrado que gera a configuração MCP exata para o seu setup. Sem necessidade de criar comandos manualmente — basta escolher suas opções e copiar o resultado.
Vá até a aba Tokens de API no painel. Encontre seu token e clique no botão "Conectar" ao lado dele.
Assistente Passo 1 — Escolha seu agente de IA
O assistente pergunta qual agente de IA você está usando. Selecione "Claude Code" na lista. Outros agentes suportados incluem Cursor, VS Code, Windsurf, Cline e Codex — cada um recebe um formato de configuração personalizado.
Assistente Passo 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 da página. Cada elemento recebe um marcador [ref=N]. Gratuito e rápido. Ideal para formulários, páginas estruturadas e sites padrão.
- Modo Vision AI — A IA tira uma captura de tela e encontra elementos visualmente pela aparência deles. Funciona em qualquer página, até interfaces baseadas em 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 cobre 90% dos casos de uso. Você pode sempre mudar para "Ambos" mais tarde se precisar de análise visual.
Assistente Passo 3 — Ativar navegadores antidetect
Ative os navegadores que você usa e preencha os detalhes de conexão deles:
- Linken Sphere — Basta definir a porta da API (padrão: 40080). Certifique-se de que o Sphere está em execução.
- Dolphin Anty — Defina a porta local (padrão: 3001) e cole seu token de API do Dolphin em Configurações → API.
- Wadex — Defina a porta da API (padrão: 8080).
- Vision Browser — Cole seu X-Token. Opcionalmente defina uma porta local.
Você pode ativar vários navegadores ao mesmo tempo. A configuração MCP incluirá todos eles, e o agente de IA poderá controlar o que estiver em execução.
Assistente Passo 4 — Copiar e aplicar a configuração
O assistente gera a configuração final com base nas suas escolhas. Para o Claude Code, você tem duas opções:
Opção A: Comando de terminal (recomendado)
Copie o comando de uma linha e cole no seu terminal. Esta é uma configuração única — o MCP inicia automaticamente com o Claude Code todas as vezes depois disso.
claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --linken-port 40080
Opção B: Arquivo .mcp.json do projeto
Se você quiser 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 reais de token e porta — basta clicar em "Copiar" e colar. Sem necessidade de edição manual.
Verifique se o servidor MCP foi registrado:
claude mcp list
# Você deve ver "ornold-browser" na lista
Passo 6 — Iniciar seu navegador e testar
Certifique-se de que seu navegador antidetect está em execução antes de iniciar o Claude Code. Lista de verificação rápida:
- Linken Sphere — Abra o aplicativo. Crie pelo menos uma sessão se não tiver nenhuma.
- Dolphin Anty — Abra o aplicativo. Certifique-se de que a API local está habilitada nas Configurações.
- Wadex — Abra o aplicativo e verifique se a porta da API corresponde à sua configuração.
Passo 7 — Seu primeiro comando de navegador com IA
Tudo está conectado. Inicie o Claude Code em qualquer diretório:
claude
Agora fale com ele em linguagem natural. Aqui estão alguns comandos para experimentar:
# Iniciar uma sessão do Linken Sphere e navegar
> Inicie uma nova sessão do Linken Sphere e abra google.com
# Preencher um formulário
> Vá para example.com/signup, preencha o e-mail "test@mail.com" e a senha "SecurePass123", depois clique em Cadastrar
# Resolver um CAPTCHA
> Há um CAPTCHA nesta página, resolva-o
# Tirar uma captura de tela para análise visual
> Tire uma captura de tela da página atual e descreva o que você vê
# Trabalhar com múltiplas sessões
> Inicie 3 sessões do Linken Sphere e abra google.com em todas elas
Ferramentas MCP disponíveis
Uma vez conectado, o Claude Code tem acesso a mais de 40 ferramentas de automação de navegador. Aqui estão as mais usadas:
- linken_start_instances / dolphin_start_profiles — Iniciar sessões de navegador
- browser_parallel_navigate — Abrir URLs em todos os navegadores ativos
- browser_parallel_snapshot — Obter o DOM da página com marcadores [ref=N] clicáveis
- browser_parallel_click — Clicar em elementos por ref ou seletor
- browser_parallel_fill — Digitar texto em campos de entrada
- browser_parallel_screenshot — Capturar screenshots de todas as sessões
- browser_parallel_vision_analyze_grouped — Análise visual de página assistida por IA
- browser_solve_captcha — Resolver automaticamente reCAPTCHA, hCaptcha, Turnstile e mais
- browser_parallel_evaluate — Executar JavaScript no contexto da página
- linken_stop_instances / dolphin_stop_profiles — Fechar sessões
Você não precisa memorizar os nomes das ferramentas. Basta descrever o que quer em inglês simples e o Claude Code escolherá as ferramentas certas automaticamente.
Modos de interação
O Ornold MCP suporta dois modos de interação. Você pode escolher ao configurar:
Modo DOM (padrão, gratuito)
A IA lê a estrutura da página via snapshots DOM. Cada elemento recebe um marcador [ref=N]. Rápido e não consome créditos de visão. Ideal para páginas estruturadas com HTML claro.
Modo Vision AI (pago por análise)
A IA tira uma captura de tela e usa análise visual para encontrar elementos pela aparência deles. Funciona em qualquer página, até SPAs complexos ou interfaces baseadas em canvas. Cada análise custa 1 crédito de visão.
# Ativar ambos os modos:
claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --mode both
Solução de problemas
- "npx: comando não encontrado" — Node.js não está no PATH. Reinicie o terminal após instalar o Node.js. No Windows, certifique-se de ter marcado "Adicionar ao PATH" durante a instalação.
- "Não é possível conectar ao Linken Sphere" — Certifique-se de que o Sphere está em execução e que a porta da API está correta (padrão 40080). Verifique se nenhum firewall está bloqueando a porta.
- "Token inválido" — Copie o token novamente do painel mcp.ornold.com. Tokens são strings longas — certifique-se de ter copiado o valor completo.
- "Servidor MCP não está respondendo" — Execute `claude mcp list` para verificar o registro. Tente remover e adicionar novamente: `claude mcp remove ornold-browser` e depois execute o comando de adição novamente.
- "Falha ao resolver CAPTCHA" — Verifique seu saldo de créditos de CAPTCHA no painel do Ornold. O plano gratuito inclui resoluções limitadas.
- "Permissão negada (npm install)" — No macOS, adicione sudo como prefixo. No Windows, execute o PowerShell como Administrador.
O que vem a seguir?
- Leia o guia de automação do Linken Sphere para gerenciamento avançado de sessões
- Aprenda sobre automação de navegador em paralelo para executar 10+ sessões ao mesmo tempo
- Confira o guia de resolução de CAPTCHA para lidar com reCAPTCHA, hCaptcha e Turnstile
- Explore o modo Vision AI para interagir com interfaces visuais complexas