指南3 分钟阅读

Codex + Ornold MCP：浏览器自动化配置指南

将 Codex CLI 或桌面应用连接到 Ornold MCP。配置 config.toml，用 AI 自动化指纹浏览器。

2026年4月17日

最简单的方式：让 Codex 自动安装

OpenAI Codex（CLI 和桌面应用）可以自动安装 Ornold MCP。粘贴带 token 的 prompt，Codex 会编辑 `~/.codex/config.toml` 并重新加载。无需手动写 TOML。

Codex CLI 支持 macOS、Windows、Linux。Codex 桌面应用仅支持 macOS Apple Silicon。两者使用同一个 `~/.codex/config.toml`，所以 MCP 设置完全一样。

步骤 1 — 获取你的 token

在 mcp.ornold.com 注册
打开 Tokens 页面
点击 Create token，复制值

步骤 2 — 把这个 prompt 粘贴到 Codex

打开 Codex（CLI：`codex`，或桌面应用），然后粘贴：

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.

发送前请把 `YOUR_TOKEN` 替换为你的真实 token。Codex 写入 TOML，下次会话加载 MCP。

步骤 3 — 验证

在 Codex 中询问：

List my connected browsers using browser_list

如果你的反检测浏览器正在运行，你会看到它的 profile。完成。

反检测浏览器标志

告诉 Codex 你用什么浏览器 —— 它会向 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`

为了反检测隐身，添加 `--mode vision`，让 AI 通过截图和坐标点击，而不是 DOM 选择器。

Codex 桌面应用 vs CLI

两者都读取 `~/.codex/config.toml`。桌面应用还有添加 MCP 服务器的 UI（设置 → Integrations & MCP），但它写入同一个文件。CLI 用户直接编辑 TOML 或使用：

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

工具批准策略

Codex 默认在运行工具前请求批准。要在不每次确认的情况下运行浏览器工具，添加到 config.toml：

approval_policy = "on-request"

故障排除

**MCP 服务器未加载** —— 检查 config.toml 语法。TOML 对格式敏感。使用 TOML 验证器。
**Codex 应用找不到配置** —— 确保 `config.toml` 在 `~/.codex/config.toml`，不在项目文件夹。
**桌面应用：找不到 npx** —— 应用不继承终端 PATH。使用完整路径：`which npx` → 把结果放入 `command`。
**Token 无效** —— 从 mcp.ornold.com 重新复制。
**无法连接到浏览器** —— 确保反检测浏览器正在运行，端口匹配。

下一步是什么？

Claude Code + Ornold MCP 指南如果你也用 Claude Code
并行浏览器自动化 —— 同时运行 10+ 会话
CAPTCHA 解决指南 —— reCAPTCHA、hCaptcha、Turnstile
Vision AI vs CSS 选择器 —— 为什么坐标点击优于 DOM 抓取

解析