Voltar ao blog
Tutorial5 min de leitura
Conectando o Dolphin Anty ao Ornold: configuração rápida de MCP
De habilitar a porta de debug a listar perfis conectados, este tutorial coloca seu primeiro lote real de navegadores no ar em poucos minutos.
28 de mar. 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 Dolphin Anty
- Abra Dolphin Anty
- Vá em Settings → API e copie seu **token API Dolphin**
- Anote a porta API local — padrão é `3001`
- Pelo menos um perfil deve existir
Ornold conecta a perfis Dolphin em execução via CDP. O token API Dolphin (diferente do token Ornold) permite Ornold iniciar/parar perfis programaticamente.
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 Ornold e `YOUR_DOLPHIN_TOKEN` pelo token API Dolphin.
Claude Code
Install Ornold MCP for Dolphin Anty automation.
Requirements: Node.js ≥ 18.
Ornold token: https://mcp.ornold.com → Tokens → Create token.
Dolphin token: Dolphin Anty → Settings → API.
Run:
claude mcp add --transport stdio ornold-browser -- npx mcp-ornold-browser --token YOUR_TOKEN --dolphin-port 3001 --dolphin-token YOUR_DOLPHIN_TOKEN --mode vision
npx mcp-ornold-browser --install-skill
After setup, verify by calling browser_list.
Cursor
Install Ornold MCP for Dolphin Anty automation.
Requirements: Node.js ≥ 18.
Ornold token: https://mcp.ornold.com → Tokens → Create token.
Dolphin token: Dolphin Anty → Settings → API.
Edit ~/.cursor/mcp.json and add:
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": ["mcp-ornold-browser", "--token", "YOUR_TOKEN", "--dolphin-port", "3001", "--dolphin-token", "YOUR_DOLPHIN_TOKEN", "--mode", "vision"]
}
}
}
Restart Cursor.
Codex
Install Ornold MCP for Dolphin Anty automation.
Requirements: Node.js ≥ 18.
Ornold token: https://mcp.ornold.com → Tokens → Create token.
Dolphin token: Dolphin Anty → Settings → API.
Edit ~/.codex/config.toml and add:
[mcp_servers.ornold-browser]
command = "npx"
args = ["-y", "mcp-ornold-browser", "--token", "YOUR_TOKEN", "--dolphin-port", "3001", "--dolphin-token", "YOUR_DOLPHIN_TOKEN", "--mode", "vision"]
Passo 4 — Verifique
Pergunte ao agente:
List my Dolphin Anty profiles using browser_list
Perfis iniciados aparecerão. Tente uma ação real:
Open google.com in all my Dolphin profiles and take a screenshot
Por que modo Vision para Dolphin?
O flag `--mode vision` diz ao Ornold para clicar via screenshots + coordenadas em vez de seletores CSS. Perfis Dolphin rodam Chrome real, mas sites alvo ainda detectam DOM scraping. Cliques por coordenadas (com curvas Bezier) parecem humanos.
Solução de problemas
- **browser_list vazio** — Inicie pelo menos um perfil Dolphin pelo app Dolphin.
- **Porta errada** — Porta padrão Dolphin é 3001. Verifique Dolphin → Settings se mudou.
- **Token Dolphin inválido** — Copie de novo de Dolphin Settings → API. Diferente do seu token Ornold.
- **Token Ornold 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ários perfis Dolphin ao mesmo tempo
- Guia de resolução CAPTCHA — reCAPTCHA, hCaptcha, Turnstile
- Vision AI vs seletores CSS — por que isso importa para antidetect