Voltar ao blog
Guia14 min de leitura
Codex + Ornold MCP: guia de automação de navegadores
Conecte o Codex CLI ou app ao Ornold MCP. Configure o config.toml e automatize navegadores antidetect com IA.
17 de abr. de 2026O que você vai construir
Ao final deste guia, você terá o OpenAI Codex — tanto a CLI quanto o aplicativo desktop — controlando sessões reais de navegador antidetect pelo Ornold MCP. Navegue em páginas, preencha formulários, resolva CAPTCHAs e gerencie múltiplos perfis, tudo por linguagem natural. Sem scripts, sem seletores.
Este guia cobre a Codex CLI (macOS, Windows, Linux) e o aplicativo desktop Codex (macOS Apple Silicon). O Codex Cloud (ChatGPT web) usa um fluxo diferente e não precisa de MCP — não está coberto aqui.
Codex CLI vs Codex App vs Codex Cloud
A OpenAI oferece o Codex em três formas. Veja qual você precisa:
- Codex CLI — Agente baseado em terminal. Executa localmente via comando `codex`. Suporta MCP via config.toml. Funciona no macOS, Windows e Linux.
- Codex App — Aplicativo desktop para macOS (Apple Silicon). Interface visual com o mesmo suporte a MCP da CLI.
- Codex Cloud — Agente baseado em navegador dentro do ChatGPT. Conecta-se diretamente a repositórios GitHub. NÃO usa MCP — as tarefas são executadas no sandbox na nuvem da OpenAI.
Este guia cobre a CLI e o App. Ambos se conectam ao Ornold MCP da mesma forma — por meio do config.toml.
Pré-requisitos
- Um computador com macOS 12+, Windows 10/11 ou Linux
- Uma chave API da OpenAI ou assinatura ChatGPT Plus/Pro/Team
- Um navegador antidetect instalado: Linken Sphere, Dolphin Anty, Wadex ou Vision Browser
- Node.js 20+ instalado (veja o Passo 1)
Passo 1 — Instalar o Node.js
O Ornold MCP é executado como um pacote Node.js. Você precisa do Node.js versão 20 ou superior.
macOS
A maneira mais fácil é pelo Homebrew:
brew install node@22
Windows
Baixe o instalador LTS em nodejs.org (22.x). Execute-o e certifique-se de que "Adicionar ao PATH" está marcado.
Linux
# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
# Or use nvm
nvm install 22
Verificar:
node --version # v22.x.x or higher
npm --version # 10.x.x or higher
Passo 2 — Instalar o Codex
Opção A: Codex CLI
Instale a Codex CLI globalmente via npm:
npm install -g codex
Execute-o para verificar e autenticar:
codex
# Sign in with your OpenAI API key when prompted
Você também pode definir a variável de ambiente OPENAI_API_KEY em vez de fazer login interativamente.
Opção B: Aplicativo desktop Codex
Baixe o aplicativo Codex em openai.com/codex (apenas macOS Apple Silicon). Instale-o, abra-o e faça login com sua conta ChatGPT ou chave API da OpenAI. Selecione uma pasta de projeto quando solicitado.
O aplicativo Codex lê o mesmo config.toml que a CLI, portanto a configuração do MCP funciona de forma idêntica para ambos.
Passo 3 — Criar uma conta Ornold
O Ornold é a ponte entre agentes de IA e navegadores antidetect.
- 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
- Você será direcionado ao painel
Passo 4 — Criar um token de API
No painel, crie seu primeiro token de API:
- Digite um nome para o seu token (ex.: "Codex")
- Clique em "Criar"
- Copie o token — você vai precisar dele em seguida
Contas gratuitas recebem 1 assento, 5 resoluções de CAPTCHA (após o tour do painel) e acesso a navegadores padrão.
Passo 5 — Gerar configuração MCP com o assistente do painel
O painel Ornold tem um assistente de conexão integrado que gera a configuração MCP exata para sua configuração. Não é necessário criar comandos manualmente — apenas escolha suas opções e copie o resultado.
Vá para 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 "Codex" da lista. O assistente gerará a configuração no formato TOML (config.toml) em vez de JSON. Outros agentes suportados incluem Claude Code, Cursor, VS Code, Windsurf e Cline.
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. Melhor 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. 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ê sempre pode mudar para "Ambos" mais tarde se precisar de análise visual.
Assistente Passo 3 — Ative 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 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 qualquer um que esteja em execução.
Assistente Passo 4 — Copie a configuração
O assistente gera a configuração final com base em suas escolhas. Para Codex, você obtém um bloco TOML pronto para colar no config.toml. Clique em "Copiar" para obtê-lo.
O assistente preenche previamente seu token real e valores de porta — apenas clique em "Copiar" e cole no config.toml. Nenhuma edição manual necessária.
Passo 6 — Adicionar o Ornold MCP ao Codex
Você tem duas formas de adicionar o servidor MCP — pela GUI do Codex App ou editando o config.toml manualmente. Ambos os métodos produzem o mesmo resultado.
Opção A: Pela interface do Codex App (recomendado)
Se você usa o aplicativo desktop Codex, pode adicionar servidores MCP diretamente pela interface de configurações — sem precisar editar arquivos.
- Abra o aplicativo Codex e clique no ícone de engrenagem (⚙️) no canto superior direito
- Vá para a seção Integrations & MCP
- Clique em "Add Server" ou "Add Custom Server"
No formulário de configuração do servidor, preencha:
- Server name: ornold-browser
- Transport: stdio
- Command: npx
- Arguments: ornold-mcp --token YOUR_TOKEN --linken-port 40080 (ajuste para o seu navegador)
Clique em "Save" ou "Add". O servidor Ornold MCP aparecerá na sua lista de servidores. O Codex o carrega automaticamente na próxima sessão.
As configurações são armazenadas no config.toml por baixo dos panos, então sincronizam automaticamente entre o Codex App, CLI e extensão de IDE.
Opção B: Editar o config.toml manualmente (usuários de CLI)
Se você prefere a CLI ou quer configurar o Codex em um servidor headless, edite o arquivo de configuração diretamente:
# macOS / Linux
~/.codex/config.toml
# Windows
%USERPROFILE%\.codex\config.toml
Cole o bloco de servidor MCP do assistente. Veja como fica para o Linken Sphere:
# ~/.codex/config.toml
[mcp_servers.ornold-browser]
command = "npx"
args = ["ornold-mcp", "--token", "YOUR_TOKEN", "--linken-port", "40080"]
Para o Dolphin Anty, os args incluem o token do Dolphin:
[mcp_servers.ornold-browser]
command = "npx"
args = ["ornold-mcp", "--token", "YOUR_TOKEN", "--dolphin-port", "3001", "--dolphin-token", "YOUR_DOLPHIN_TOKEN"]
Para múltiplos navegadores ao mesmo tempo:
[mcp_servers.ornold-browser]
command = "npx"
args = ["ornold-mcp", "--token", "YOUR_TOKEN", "--linken-port", "40080", "--dolphin-port", "3001", "--dolphin-token", "DOLPHIN_KEY", "--wadex-port", "8080"]
Opção C: One-liner via CLI
Você também pode adicionar o servidor com um único comando no terminal:
codex mcp add ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --linken-port 40080
Os três métodos escrevem no mesmo config.toml. Escolha o que for mais confortável para você — o resultado é idêntico.
Passo 7 — Iniciar seu navegador e lançar o Codex
Certifique-se de que seu navegador antidetect está em execução e depois lance o Codex:
CLI
codex
Aplicativo desktop
Abra o aplicativo Codex. Selecione o modo "Local". Os servidores MCP do config.toml são carregados automaticamente.
O Codex vai detectar o servidor Ornold MCP e mostrar os tools de navegador disponíveis. Agora converse com ele:
# Start a Linken Sphere session
> Start a new Linken Sphere session and open google.com
# Fill a form
> Navigate to example.com/signup, fill email "test@mail.com" and password "Pass123", click Sign Up
# Solve a CAPTCHA
> There's a CAPTCHA on this page, solve it
# Multi-session
> Start 3 Linken Sphere sessions and open google.com in all of them
# Visual analysis
> Take a screenshot and describe what you see on the page
Tools MCP disponíveis
Uma vez conectado, o Codex tem acesso a mais de 40 tools de automação de navegador:
- 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 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 com 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 — Encerrar sessões
Você não precisa memorizar nomes de tools. Apenas descreva o que quer em linguagem simples — o Codex escolhe os tools certos automaticamente.
Política de aprovação de tools
O Codex tem três modos de aprovação que controlam como ele executa os tools:
- "untrusted" — Codex pede permissão antes de cada chamada de tool (mais seguro, padrão)
- "on-request" — Codex pede apenas para tools destrutivos ou desconhecidos
- "never" — Codex executa todos os tools sem perguntar (mais rápido, use com cuidado)
Defina o padrão no config.toml:
# ~/.codex/config.toml
approval_policy = "on-request"
Ou substitua por tool para o Ornold:
[mcp_servers.ornold-browser.tools.browser_parallel_navigate]
approval_mode = "approve"
[mcp_servers.ornold-browser.tools.browser_solve_captcha]
approval_mode = "approve"
Solução de problemas
- "npx: comando não encontrado" — Node.js não está no PATH. Reinicie o terminal após a instalação.
- "MCP handshake failed" no aplicativo Codex Desktop — O aplicativo desktop não herda o PATH do terminal (caminhos nvm/fnm estão ausentes). Solução: execute `which npx` no terminal, depois use o caminho completo no config.toml: `command = "/Users/you/.nvm/versions/node/v22.x.x/bin/npx"` em vez de apenas `"npx"`.
- "codex: comando não encontrado" — Execute `npm install -g codex` novamente. No macOS, pode ser necessário usar `sudo`.
- "Não é possível conectar ao Linken Sphere" — Certifique-se de que o Sphere está em execução e que a porta API está correta (padrão 40080).
- "Token inválido" — Copie o token novamente em mcp.ornold.com. Certifique-se de ter copiado a string completa.
- "Servidor MCP não carrega" — Verifique a sintaxe do config.toml. TOML é sensível à formatação. Use um validador TOML se necessário.
- "Falha ao resolver CAPTCHA" — Verifique seu saldo de créditos de CAPTCHA no painel Ornold.
- O aplicativo Codex não encontra a config — Certifique-se de que o config.toml está em ~/.codex/config.toml (não dentro de uma pasta de projeto).
O que vem a seguir?
- Leia o guia Claude Code + Ornold MCP se você também usa o Claude Code
- Aprenda sobre automação paralela de navegadores 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