Voltar ao blog
Guia12 min de leitura
Cursor + Ornold MCP: guia completo de automação de navegadores
Conecte o Cursor ao Ornold MCP e automatize navegadores antidetect com IA. Configuração passo a passo para Linken Sphere, Dolphin Anty e mais.
19 de abr. de 2026O que você vai construir
Ao final deste guia, você terá o Cursor controlando sessões reais de navegador antidetect — navegando em páginas, preenchendo formulários, resolvendo CAPTCHAs e gerenciando vários perfis — tudo através de linguagem natural no chat do Cursor. Sem scripts Playwright. Sem seletores CSS. Apenas diga à IA o que fazer.
Este guia cobre macOS e Windows. As etapas do Linux são as mesmas do macOS (use seu gerenciador de pacotes em vez do Homebrew).
Pré-requisitos
- Um computador executando macOS 12+ ou Windows 10/11
- Cursor instalado (plano gratuito ou Pro)
- Um navegador antidetect instalado: Linken Sphere, Dolphin Anty, Wadex ou Vision Browser
- Uma conexão com a Internet para baixar ferramentas e pacotes
Etapa 1 — Instalar Node.js
Ornold MCP é executado como um pacote Node.js. Você precisa da versão 20 ou superior do Node.js.
macOS
A maneira mais fácil é o Homebrew. Se você não tiver o Homebrew, instale-o primeiro em brew.sh. Depois:
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 "Add to PATH" está marcado.
Verifique a instalação abrindo 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
Etapa 2 — Instalar Cursor
Cursor é um editor de código alimentado por IA construído no VS Code. Ele suporta MCP (Model Context Protocol) nativamente, o que permite usar ferramentas externas como automação de navegador.
- Baixe o Cursor em cursor.com
- Instale e abra-o
- Faça login com sua conta Cursor (o plano gratuito funciona para MCP)
Se você já tem o Cursor instalado, certifique-se de que está atualizado para a versão mais recente — o suporte a MCP foi adicionado em versões recentes.
Cursor Pro oferece mais solicitações de IA por mês, mas o plano gratuito é suficiente para testar a automação de navegador MCP.
Etapa 3 — Criar uma conta Ornold
Ornold é a ponte entre agentes de IA e navegadores antidetect. Você precisa de uma conta para obter um token de API.
- Vá para mcp.ornold.com
- Clique em "Register" 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 — você está dentro!
Etapa 4 — Criar um token de API
Após o registro, o painel solicitará que você crie seu primeiro token de API. Este token autentica sua conexão MCP.
- Digite um nome para seu token (por exemplo, "Cursor")
- Clique em "Create"
- Copie o token e salve-o em um local seguro — você precisará dele na próxima etapa
Contas gratuitas recebem 1 assento, 5 resoluções de captcha (após concluir o tour) e acesso a navegadores padrão. Atualize seu plano para mais capacidade.
Etapa 5 — Gerar configuração MCP com o assistente do painel
O painel Ornold possui um assistente Connect integrado que gera a configuração MCP exata para sua configuração. Nenhuma criação manual de JSON necessária — apenas escolha suas opções e copie o resultado.
Vá para a guia API Tokens no painel. Encontre seu token e clique no botão "Connect" ao lado dele.
Etapa do assistente 1 — Escolha seu agente de IA
O assistente pergunta qual agente de IA você está usando. Selecione "Cursor" na lista. O assistente gerará a configuração em formato JSON para o mcp.json do Cursor. Outros agentes suportados incluem Claude Code, Codex, VS Code, Windsurf e Cline.
Etapa 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 da página. Cada elemento recebe um marcador [ref=N]. Gratuito e rápido. Melhor para formulários, páginas estruturadas e sites padrão.
- Modo Vision AI — A IA tira uma captura de tela e encontra visualmente elementos por sua aparência. Funciona em qualquer página, até mesmo UIs 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 lida com 90% dos casos de uso. Você sempre pode mudar para "Both" mais tarde se precisar de análise visual.
Etapa do assistente 3 — Ativar navegadores Antidetect
Ative os navegadores que você usa e preencha seus detalhes de conexão:
- Linken Sphere — Apenas defina a porta da API (padrão: 40080). Certifique-se de que Sphere está em execução.
- Dolphin Anty — Defina a porta local (padrão: 3001) e cole seu token de API Dolphin em Settings → 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 Cursor poderá controlar qualquer um que esteja em execução.
Etapa do assistente 4 — Copie a configuração
O assistente gera a configuração JSON final com base em suas escolhas. Clique em "Copy" para obtê-la — você a colará nas configurações MCP do Cursor na próxima etapa.
O assistente pré-preenche seus valores reais de token e porta — apenas clique em "Copy" e cole. Nenhuma edição manual necessária.
Etapa 6 — Adicionar Ornold MCP ao Cursor
O Cursor gerencia servidores MCP através de um arquivo de configuração JSON. Você pode abri-lo em Cursor Settings → MCP → "Add new MCP server" — isso abre o arquivo mcp.json no editor. O Cursor armazena as configurações MCP em dois locais:
Se você preferir editar o arquivo de configuração diretamente, o Cursor armazena as configurações MCP em:
# Global (todos os projetos)
~/.cursor/mcp.json
# Por projeto (apenas este projeto)
.cursor/mcp.json
Cole a configuração do assistente. Aqui está como fica para Linken Sphere:
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--linken-port", "40080"]
}
}
}
Para Dolphin Anty:
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--dolphin-port", "3001", "--dolphin-token", "YOUR_DOLPHIN_TOKEN"]
}
}
}
Para vários navegadores ao mesmo tempo:
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": [
"ornold-mcp",
"--token", "YOUR_TOKEN",
"--linken-port", "40080",
"--dolphin-port", "3001",
"--dolphin-token", "DOLPHIN_KEY",
"--wadex-port", "8080"
]
}
}
}
Use ~/.cursor/mcp.json para configuração global (disponível em todos os projetos). Use .cursor/mcp.json na raiz do projeto para compartilhar a configuração com sua equipe via controle de versão.
Etapa 7 — Inicie seu navegador e teste
Certifique-se de que seu navegador antidetect está em execução antes de usar o chat de IA do Cursor. Lista de verificação rápida:
- Linken Sphere — Abra o aplicativo. Crie pelo menos uma sessão se você não tiver nenhuma.
- Dolphin Anty — Abra o aplicativo. Certifique-se de que a API local está ativada em Configurações.
- Wadex — Abra o aplicativo e verifique se a porta da API corresponde à sua configuração.
Abra qualquer projeto no Cursor e inicie um chat com a IA (Cmd+L ou Ctrl+L). Certifique-se de que está usando o modo Agent — é onde as ferramentas MCP estão disponíveis.
Etapa 8 — Seu primeiro comando de navegador de IA
Tudo está conectado. Abra o chat do Cursor e fale com ele em linguagem natural. Aqui estão alguns comandos para tentar:
# Inicie uma sessão Linken Sphere e navegue
> Start a new Linken Sphere session and open google.com
# Preencha um formulário
> Go to example.com/signup, fill in email "test@mail.com" and password "SecurePass123", then click Sign Up
# Resolva um CAPTCHA
> There's a CAPTCHA on this page, solve it
# Tire uma captura de tela para análise visual
> Take a screenshot of the current page and describe what you see
# Trabalhe com várias sessões
> Start 3 Linken Sphere sessions and open google.com in all of them
Ferramentas MCP disponíveis
Uma vez conectado, o Cursor tem acesso a 40+ ferramentas de automação de navegador. Aqui estão as mais comumente usadas:
- linken_start_instances / dolphin_start_profiles — Inicie sessões de navegador
- browser_parallel_navigate — Abra URLs em todos os navegadores ativos
- browser_parallel_snapshot — Obtenha DOM da página com marcadores [ref=N] clicáveis
- browser_parallel_click — Clique em elementos por ref ou seletor
- browser_parallel_fill — Digite texto em campos de entrada
- browser_parallel_screenshot — Capture capturas de tela de todas as sessões
- browser_parallel_vision_analyze_grouped — Análise de página visual alimentada por IA
- browser_solve_captcha — Resolva automaticamente reCAPTCHA, hCaptcha, Turnstile e mais
- browser_parallel_evaluate — Execute JavaScript no contexto da página
- linken_stop_instances / dolphin_stop_profiles — Feche sessões
Você não precisa memorizar nomes de ferramentas. Apenas descreva o que deseja em inglês simples e o Cursor escolherá automaticamente as ferramentas certas.
Modos de interaçã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 através de snapshots DOM. Cada elemento recebe um marcador [ref=N]. Rápido e não custa nenhum crédito de visão. Melhor 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 por sua aparência. Funciona em qualquer página, até mesmo SPAs complexas ou UIs baseadas em canvas. Cada análise custa 1 crédito de visão.
Para ativar ambos os modos, adicione o sinalizador --mode aos seus argumentos de configuração MCP:
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--mode", "both", "--linken-port", "40080"]
}
}
}
Modo Agent do Cursor vs Modo Ask
Cursor possui dois modos de chat. As ferramentas MCP funcionam apenas no modo Agent:
- Modo Agent — A IA pode usar ferramentas MCP, executar comandos de terminal e editar arquivos. Isso é o que você precisa para automação de navegador.
- Modo Ask — A IA apenas responde perguntas com base em sua base de código. Sem acesso a ferramentas. As ferramentas MCP não aparecerão aqui.
Certifique-se de que está no modo Agent (verifique o menu suspenso no topo do painel de chat) antes de tentar comandos de navegador. Se você não vir as ferramentas MCP, mude para o modo Agent.
Você também pode usar o Composer do Cursor (Cmd+I / Ctrl+I) para tarefas de automação de navegador em várias etapas. O Composer também suporta ferramentas MCP no modo Agent.
Solução de problemas
- "MCP server not showing" — Certifique-se de que mcp.json é JSON válido. Até uma vírgula à direita o quebrará. Use um validador JSON se não tiver certeza.
- "npx: command not found" — Node.js não está em PATH. Reinicie o Cursor após instalar Node.js. No macOS com nvm, você pode precisar definir o caminho completo para npx no campo de comando.
- "Cannot connect to Linken Sphere" — Certifique-se de que Sphere está em execução e a porta da API está correta (padrão 40080). Verifique se nenhum firewall bloqueia a porta.
- "Token invalid" — Copie o token novamente do painel mcp.ornold.com. Tokens são strings longas — certifique-se de ter copiado o valor inteiro.
- "Tools not appearing in chat" — Certifique-se de que está no modo Agent, não no modo Ask. Verifique Cursor Settings → MCP para verificar se o servidor mostra um status "connected" verde.
- "CAPTCHA solve failed" — Verifique seu saldo de créditos de captcha no painel Ornold. O plano gratuito inclui resoluções limitadas.
- "Server disconnected" — Cursor pode desconectar servidores MCP após tempo ocioso. Reinicie o chat ou alterne o servidor em Settings → MCP.
E agora?
- Leia o guia Claude Code + Ornold MCP se você também usar Claude Code
- Leia o guia Codex + Ornold MCP se você também usar OpenAI Codex
- Aprenda sobre automação paralela de navegador para executar 10+ sessões ao mesmo tempo
- Verifique 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