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

A maneira mais fácil: peça ao Codex para se instalar

OpenAI Codex (CLI e app desktop) pode instalar Ornold MCP sozinho. Cole um prompt com seu token, Codex edita `~/.codex/config.toml` e recarrega. Sem TOML manual.

Codex CLI funciona em macOS, Windows, Linux. App desktop Codex é só macOS Apple Silicon. Ambos usam o mesmo `~/.codex/config.toml`, então o setup MCP é idêntico.

Passo 1 — Obtenha seu token

Cadastre-se em mcp.ornold.com
Abra a página Tokens
Clique em Create token, copie o valor

Passo 2 — Cole este prompt no Codex

Abra o Codex (CLI: `codex`, ou app desktop), e cole:

Install Ornold MCP — browser automation for antidetect browsers.

Requirements: Node.js ≥ 18 (https://nodejs.org)
Token: get one at https://mcp.ornold.com (sign up → Tokens page → Create token)

Create or edit ~/.codex/config.toml and add:

[mcp_servers.ornold-browser]
command = "npx"
args = ["-y", "mcp-ornold-browser", "--token", "YOUR_TOKEN"]

Replace YOUR_TOKEN with the token from the dashboard.

Note: Desktop apps don't inherit terminal PATH. If MCP fails to start, find your npx path with `which npx` and use the full path in the command field.

Substitua `YOUR_TOKEN` pelo seu token real antes de enviar. Codex grava o TOML, depois carrega MCP na próxima sessão.

Passo 3 — Verifique

No Codex, pergunte:

List my connected browsers using browser_list

Se seu navegador antidetect estiver rodando, você verá seus perfis. Pronto.

Flags de navegadores antidetect

Diga ao Codex qual navegador você usa — ele adiciona o flag certo aos args:

Linken Sphere — `--linken-port 40080`
Dolphin Anty — `--dolphin-port 3001 --dolphin-token YOUR_DOLPHIN_TOKEN`
Vision Browser — `--vision-token vx_...`
Wadex — `--wadex-port 8080`

Para furtividade antidetect, adicione `--mode vision` para a IA clicar via screenshots e coordenadas em vez de seletores DOM.

App Codex vs CLI

Ambos leem `~/.codex/config.toml`. O app desktop também tem UI para adicionar servidores MCP (Settings → Integrations & MCP), mas grava no mesmo arquivo. Usuários CLI editam o TOML diretamente ou usam:

codex mcp add ornold-browser -- npx mcp-ornold-browser --token YOUR_TOKEN

Política de aprovação de ferramentas

Codex pede aprovação antes de cada chamada de ferramenta por padrão. Para executar ferramentas de navegador sem confirmar toda vez, adicione ao config.toml:

approval_policy = "on-request"

Solução de problemas

**Servidor MCP não carrega** — Verifique sintaxe config.toml. TOML é sensível a formatação. Use validador TOML.
**App Codex não acha config** — Garanta que `config.toml` está em `~/.codex/config.toml`, não em pasta de projeto.
**Desktop: npx not found** — Apps não herdam PATH do terminal. Use caminho completo: `which npx` → resultado em `command`.
**Token inválido** — Copie de novo de mcp.ornold.com.
**Não conecta ao navegador** — Navegador antidetect deve estar rodando, portas combinando.

Próximos passos?

Guia Claude Code + Ornold MCP se você também usa Claude Code
Automação paralela de navegadores — rode 10+ sessões ao mesmo tempo
Guia de resolução CAPTCHA — reCAPTCHA, hCaptcha, Turnstile
Vision AI vs seletores CSS — por que cliques por coordenadas vencem DOM scraping