Ornold
首页
什么是 MCP
价格
博客
应用场景
浏览器
开始使用
返回博客
指南14 分钟阅读

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

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

你将构建什么

完成本指南后，你将让 OpenAI Codex——CLI 和桌面应用——通过 Ornold MCP 控制真实的反检测浏览器会话。导航页面、填写表单、解决 CAPTCHA，并管理多个配置文件，全部通过自然语言实现。无需脚本，无需选择器。
本指南涵盖 Codex CLI（macOS、Windows、Linux）和 Codex 桌面应用（macOS Apple Silicon）。Codex Cloud（ChatGPT 网页版）使用不同的工作流，不需要 MCP——本指南不涉及此内容。

Codex CLI vs Codex App vs Codex Cloud

OpenAI 以三种形式提供 Codex。以下是你需要了解的：
  • Codex CLI — 基于终端的代理。通过 `codex` 命令在本地运行。通过 config.toml 支持 MCP。适用于 macOS、Windows 和 Linux。
  • Codex App — 适用于 macOS（Apple Silicon）的桌面应用程序。可视化界面，MCP 支持与 CLI 相同。
  • Codex Cloud — 在 ChatGPT 内运行的基于浏览器的代理。直接连接到 GitHub 仓库。不使用 MCP——任务在 OpenAI 的云沙盒中运行。
本指南涵盖 CLI 和 App。两者通过相同方式连接到 Ornold MCP——通过 config.toml。

前提条件

  • 运行 macOS 12+、Windows 10/11 或 Linux 的计算机
  • OpenAI API 密钥或 ChatGPT Plus/Pro/Team 订阅
  • 已安装反检测浏览器：Linken Sphere、Dolphin Anty、Wadex 或 Vision Browser
  • 已安装 Node.js 20+（见第 1 步）

第 1 步 — 安装 Node.js

Ornold MCP 作为 Node.js 包运行。你需要 Node.js 版本 20 或更高。

macOS

最简单的方式是使用 Homebrew：
brew install node@22

Windows

从 nodejs.org 下载 LTS 安装程序（22.x）。运行后确保勾选"Add to PATH"。

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
验证：
node --version # v22.x.x or higher npm --version # 10.x.x or higher
Terminal showing node --version output v22
确认 Node.js 已正确安装

第 2 步 — 安装 Codex

选项 A：Codex CLI

通过 npm 全局安装 Codex CLI：
npm install -g codex
启动以验证并进行身份验证：
codex # Sign in with your OpenAI API key when prompted
你也可以设置 OPENAI_API_KEY 环境变量，而不是交互式登录。
🖼️
在终端中运行的 Codex CLI

选项 B：Codex 桌面应用

从 openai.com/codex 下载 Codex 应用（仅限 macOS Apple Silicon）。安装后打开，使用你的 ChatGPT 账户或 OpenAI API 密钥登录。出现提示时选择一个项目文件夹。
Codex 应用读取与 CLI 相同的 config.toml，因此 MCP 设置对两者完全相同。

第 3 步 — 创建 Ornold 账户

Ornold 是 AI 代理与反检测浏览器之间的桥梁。
  • 访问 mcp.ornold.com
  • 点击"Register"，使用你的邮箱创建账户
  • 用 6 位数字验证码验证你的邮箱
  • 进入仪表盘
Ornold MCP registration page with email and password fields
在 [mcp.ornold.com](https://mcp.ornold.com) 创建你的 Ornold 账户

第 4 步 — 创建 API 令牌

在仪表盘中创建你的第一个 API 令牌：
  • 为你的令牌输入名称（例如"Codex"）
  • 点击"Create"
  • 复制令牌——下一步需要用到
Ornold dashboard showing token creation modal with copy button
创建并复制你的 API 令牌
免费账户提供 1 个席位、5 次 CAPTCHA 解决（完成仪表盘引导后）以及访问标准浏览器的权限。

第 5 步 — 使用仪表盘向导生成 MCP 配置

Ornold 仪表盘内置了连接向导，可为你的配置生成精确的 MCP 配置。无需手动编写命令——只需选择选项并复制结果。
进入仪表盘的"API Tokens"选项卡，找到你的令牌，点击旁边的"Connect"按钮。
Ornold dashboard API Tokens page with Connect button highlighted next to a token
点击令牌上的"Connect"打开向导

向导第 1 步 — 选择 AI 代理

向导会询问你使用的是哪个 AI 代理。从列表中选择"Codex"。向导将生成 TOML 格式的配置（config.toml），而非 JSON。其他支持的代理包括 Claude Code、Cursor、VS Code、Windsurf 和 Cline。
🖼️
第 1 步：选择 Codex 作为你的 AI 代理

向导第 2 步 — 选择交互模式

选择 AI 与浏览器页面的交互方式：
  • DOM 模式（默认）——AI 读取页面 HTML 结构。每个元素获得 [ref=N] 标记。免费且快速。适合表单、结构化页面和标准网站。
  • Vision AI 模式——AI 截图并通过视觉外观定位元素。适用于任何页面，包括基于 canvas 的 UI。每次分析消耗 1 个 vision 点数。
  • 两种模式——所有工具均可用。AI 自动为每个操作选择最佳方式。
从 DOM 模式开始。它是免费的、快速的，能处理 90% 的使用场景。如果需要视觉分析，随时可以切换到"两种模式"。
Connect wizard step 2 showing three interaction mode options: DOM, Vision AI, Both
第 2 步：大多数场景选择 DOM 模式

向导第 3 步 — 启用反检测浏览器

开启你使用的浏览器并填写连接详情：
  • Linken Sphere — 只需设置 API 端口（默认：40080）。确保 Sphere 正在运行。
  • Dolphin Anty — 设置本地端口（默认：3001）并从设置 → API 粘贴你的 Dolphin API 令牌。
  • Wadex — 设置 API 端口（默认：8080）。
  • Vision Browser — 粘贴你的 X-Token。可选设置本地端口。
你可以同时启用多个浏览器。MCP 配置将包含所有浏览器，AI 代理将能控制任何正在运行的浏览器。
Connect wizard step 3 showing browser toggles with Linken Sphere enabled and port field filled in
第 3 步：启用你的反检测浏览器并填写端口

向导第 4 步 — 复制配置

向导根据你的选择生成最终配置。对于 Codex，你会得到一个可直接粘贴到 config.toml 的 TOML 块。点击"Copy"复制它。
🖼️
第 4 步：复制生成的 TOML 配置
向导会预先填写你的实际令牌和端口值——只需点击"Copy"并粘贴到 config.toml 中，无需手动编辑。

第 6 步 — 将 Ornold MCP 添加到 Codex

你有两种方式添加 MCP 服务器——通过 Codex App GUI 或手动编辑 config.toml。两种方法产生相同的结果。

选项 A：通过 Codex App 界面（推荐）

如果你使用 Codex 桌面应用，可以直接从设置 UI 添加 MCP 服务器——无需编辑文件。
  • 打开 Codex 应用，点击右上角的齿轮图标（⚙️）
  • 进入 Integrations & MCP 部分
  • 点击"Add Server"或"Add Custom Server"
🖼️
打开 Settings → Integrations & MCP
在服务器配置表单中填写：
  • Server name: ornold-browser
  • Transport: stdio
  • Command: npx
  • Arguments: ornold-mcp --token YOUR_TOKEN --linken-port 40080（根据你的浏览器调整）
🖼️
填写 MCP 服务器详情——名称、命令和参数
点击"Save"或"Add"。Ornold MCP 服务器将出现在你的服务器列表中。Codex 会在下次会话时自动加载它。
🖼️
Ornold MCP 服务器已添加并就绪
设置存储在 config.toml 中，因此会在 Codex App、CLI 和 IDE 扩展之间自动同步。

选项 B：手动编辑 config.toml（CLI 用户）

如果你更喜欢 CLI 或想在无头服务器上设置 Codex，可以直接编辑配置文件：
# macOS / Linux ~/.codex/config.toml # Windows %USERPROFILE%\.codex\config.toml
从向导粘贴 MCP 服务器块。以 Linken Sphere 为例：
# ~/.codex/config.toml [mcp_servers.ornold-browser] command = "npx" args = ["ornold-mcp", "--token", "YOUR_TOKEN", "--linken-port", "40080"]
对于 Dolphin Anty，args 中包含 Dolphin 令牌：
[mcp_servers.ornold-browser] command = "npx" args = ["ornold-mcp", "--token", "YOUR_TOKEN", "--dolphin-port", "3001", "--dolphin-token", "YOUR_DOLPHIN_TOKEN"]
同时使用多个浏览器：
[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"]

选项 C：通过 CLI 一行命令

你也可以用一条终端命令添加服务器：
codex mcp add ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --linken-port 40080
三种方法都写入同一个 config.toml。选择你觉得最舒适的方式——结果是相同的。

第 7 步 — 启动浏览器并运行 Codex

确保你的反检测浏览器正在运行，然后启动 Codex：

CLI

codex

桌面应用

打开 Codex 应用。选择"Local"模式。config.toml 中的 MCP 服务器会自动加载。
Codex 将检测到 Ornold MCP 服务器并显示可用的浏览器工具。现在可以向它发出指令：
# 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
🖼️
Codex 通过 Ornold MCP 控制 Linken Sphere

可用的 MCP 工具

连接后，Codex 可以访问 40+ 个浏览器自动化工具：
  • linken_start_instances / dolphin_start_profiles — 启动浏览器会话
  • browser_parallel_navigate — 在所有活跃浏览器中打开 URL
  • browser_parallel_snapshot — 获取带有可点击 [ref=N] 标记的页面 DOM
  • browser_parallel_click — 通过 ref 或选择器点击元素
  • browser_parallel_fill — 在输入框中输入文本
  • browser_parallel_screenshot — 捕获所有会话的截图
  • browser_parallel_vision_analyze_grouped — AI 驱动的视觉页面分析
  • browser_solve_captcha — 自动解决 reCAPTCHA、hCaptcha、Turnstile 等
  • browser_parallel_evaluate — 在页面上下文中运行 JavaScript
  • linken_stop_instances / dolphin_stop_profiles — 关闭会话
你不需要记住工具名称。只需用自然语言描述你想要做的事——Codex 会自动选择正确的工具。

工具审批策略

Codex 有三种审批模式来控制工具的运行方式：
  • "untrusted" — Codex 在每次调用工具前都会请求许可（最安全，默认）
  • "on-request" — Codex 仅对破坏性或未知工具请求许可
  • "never" — Codex 运行所有工具时不询问（最快，谨慎使用）
在 config.toml 中设置默认值：
# ~/.codex/config.toml approval_policy = "on-request"
或为 Ornold 按工具单独覆盖：
[mcp_servers.ornold-browser.tools.browser_parallel_navigate] approval_mode = "approve" [mcp_servers.ornold-browser.tools.browser_solve_captcha] approval_mode = "approve"

故障排除

  • "npx: command not found" — Node.js 不在 PATH 中。安装后重启终端。
  • "MCP handshake failed" 在 Codex 桌面应用中 — 桌面应用不会继承终端的 PATH（缺少 nvm/fnm 路径）。解决方法：在终端运行 `which npx`，然后在 config.toml 中使用完整路径：`command = "/Users/you/.nvm/versions/node/v22.x.x/bin/npx"` 而不是 `"npx"`。
  • "codex: command not found" — 重新运行 `npm install -g codex`。在 macOS 上可能需要 `sudo`。
  • "Cannot connect to Linken Sphere" — 确保 Sphere 正在运行且 API 端口正确（默认 40080）。
  • "Token invalid" — 从 mcp.ornold.com 重新复制令牌。确保你复制了完整的字符串。
  • "MCP server not loading" — 检查 config.toml 语法。TOML 对格式敏感。如不确定，请使用 TOML 验证器。
  • "CAPTCHA solve failed" — 检查你在 Ornold 仪表盘上的 CAPTCHA 点数余额。
  • Codex App 找不到配置 — 确保 config.toml 位于 ~/.codex/config.toml（不在项目文件夹内）。

下一步是什么？

  • 如果你也使用 Claude Code，请阅读 Claude Code + Ornold MCP 指南
  • 了解并行浏览器自动化，同时运行 10+ 个会话
  • 查阅 CAPTCHA 解决指南，了解如何处理 reCAPTCHA、hCaptcha 和 Turnstile
  • 探索 Vision AI 模式，用于与复杂的视觉界面交互

相关文章

解析

什么是 MCP（模型上下文协议），它是如何工作的？

MCP 是一个开放标准，让 AI 代理通过统一接口连接外部工具。一个服务器，任意代理——无需自定义插件。
2026年4月17日
指南

Cursor + Ornold MCP：浏览器自动化完整配置指南

将 Cursor 连接到 Ornold MCP，用 AI 自动化指纹浏览器。逐步配置 Linken Sphere、Dolphin Anty 等。
2026年4月19日
指南

Linken Sphere MCP 配置：将 AI 代理连接到指纹浏览器

逐步指南：将 Claude Code、Cursor、Windsurf 或 Cline 连接到 Linken Sphere。用自然语言控制会话，无需脚本。
2026年4月18日