指南12 分钟阅读

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

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

2026年4月19日

你将构建什么

在本指南结束时，你将拥有 Cursor 控制真实的反检测浏览器会话 — 导航页面、填充表单、解决 CAPTCHA 并管理多个配置文件 — 所有这些都通过 Cursor 聊天中的自然语言完成。无需 Playwright 脚本。无需 CSS 选择器。只需告诉 AI 要做什么。

本指南涵盖 macOS 和 Windows。Linux 步骤与 macOS 相同（使用你的包管理器而不是 Homebrew）。

前置条件

运行 macOS 12+ 或 Windows 10/11 的计算机
已安装 Cursor（免费或 Pro 计划）
已安装反检测浏览器：Linken Sphere、Dolphin Anty、Wadex 或 Vision Browser
用于下载工具和包的互联网连接

步骤 1 — 安装 Node.js

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

macOS

最简单的方法是使用 Homebrew。如果你没有 Homebrew，请先从 brew.sh 安装。然后：

brew install node@22

Windows

从 nodejs.org 下载官方安装程序。选择 LTS 版本 (22.x)。运行安装程序并按照提示操作。确保选中"Add to PATH"。

Node.js download page showing LTS version selector

Download Node.js LTS from [nodejs.org](https://nodejs.org)

通过打开 Terminal (macOS) 或 PowerShell (Windows) 来验证安装：

node --version
# Expected output: v22.x.x or higher

npm --version
# Expected output: 10.x.x or higher

Terminal showing node --version output v22

Confirm Node.js is installed correctly

步骤 2 — 安装 Cursor

Cursor 是一个基于 VS Code 构建的 AI 驱动的代码编辑器。它原生支持 MCP（Model Context Protocol），允许你使用外部工具，如浏览器自动化。

从 cursor.com 下载 Cursor
安装并打开它
使用你的 Cursor 账户登录（免费计划适用于 MCP）

如果你已经安装了 Cursor，请确保它已更新到最新版本 — MCP 支持已在最近的版本中添加。

🖼️

Cursor after first launch — sign in with your account

Cursor Pro 每月给你更多的 AI 请求，但免费计划足以测试 MCP 浏览器自动化。

步骤 3 — 创建 Ornold 账户

Ornold 是 AI 代理和反检测浏览器之间的桥梁。你需要一个账户来获取 API 令牌。

转到 mcp.ornold.com
点击"Register"并使用你的电子邮件创建账户
使用发送到你收件箱的 6 位数代码验证你的电子邮件
你将登陆仪表板 — 完成！

Ornold MCP registration page with email and password fields

Create your Ornold account at [mcp.ornold.com](https://mcp.ornold.com)

步骤 4 — 创建 API 令牌

注册后，仪表板将提示你创建第一个 API 令牌。此令牌对你的 MCP 连接进行身份验证。

为你的令牌输入名称（例如"Cursor"）
点击"Create"
复制令牌并将其保存在安全的地方 — 你将在下一步中需要它

Ornold dashboard showing token creation modal with copy button

Create and copy your API token

免费账户获得 1 个座位、5 个 CAPTCHA 解决方案（完成教程后）和对标准浏览器的访问权限。升级你的计划以获得更多容量。

步骤 5 — 使用仪表板向导生成 MCP 配置

Ornold 仪表板有一个内置的连接向导，为你的设置生成确切的 MCP 配置。无需手动编写 JSON — 只需选择你的选项并复制结果。

转到仪表板中的"API Tokens"选项卡。找到你的令牌并点击它旁边的"Connect"按钮。

Ornold dashboard API Tokens page with Connect button highlighted next to a token

Click "Connect" on your token to open the wizard

向导步骤 1 — 选择你的 AI 代理

向导会询问你使用的是哪个 AI 代理。从列表中选择"Cursor"。向导将为 Cursor 的 mcp.json 生成 JSON 格式的配置。其他支持的代理包括 Claude Code、Codex、VS Code、Windsurf 和 Cline。

🖼️

Step 1: Select Cursor as your AI agent

向导步骤 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

Step 2: Choose DOM mode for most use cases

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

切换你使用的浏览器并填入其连接详情：

Linken Sphere — 只需设置 API 端口（默认：40080）。确保 Sphere 正在运行。
Dolphin Anty — 设置本地端口（默认：3001）并从 Settings → API 粘贴你的 Dolphin API 令牌。
Wadex — 设置 API 端口（默认：8080）。
Vision Browser — 粘贴你的 X-Token。可选地设置本地端口。

你可以同时启用多个浏览器。MCP 配置将包括所有浏览器，Cursor 将能够控制正在运行的任何浏览器。

Connect wizard step 3 showing browser toggles with Linken Sphere enabled and port field filled in

Step 3: Enable your antidetect browsers and fill in ports

向导步骤 4 — 复制配置

向导根据你的选择生成最终的 JSON 配置。点击"Copy"来获取它 — 你将在下一步中将其粘贴到 Cursor 的 MCP 设置中。

🖼️

Step 4: Copy the generated JSON config

向导预先填充你的实际令牌和端口值 — 只需点击"Copy"并粘贴。无需手动编辑。

步骤 6 — 将 Ornold MCP 添加到 Cursor

Cursor 通过 JSON 配置文件管理 MCP 服务器。你可以从 Cursor Settings → MCP → "Add new MCP server" 打开它 — 这会在编辑器中打开 mcp.json 文件。Cursor 将 MCP 设置存储在两个位置：

如果你更喜欢直接编辑配置文件，Cursor 将 MCP 设置存储在：

# Global (all projects)
~/.cursor/mcp.json

# Per-project (this project only)
.cursor/mcp.json

粘贴向导中的配置。以下是 Linken Sphere 的样子：

{
  "mcpServers": {
    "ornold-browser": {
      "command": "npx",
      "args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--linken-port", "40080"]
    }
  }
}

对于 Dolphin Anty：

{
  "mcpServers": {
    "ornold-browser": {
      "command": "npx",
      "args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--dolphin-port", "3001", "--dolphin-token", "YOUR_DOLPHIN_TOKEN"]
    }
  }
}

对于多个浏览器同时：

{
  "mcpServers": {
    "ornold-browser": {
      "command": "npx",
      "args": [
        "ornold-mcp",
        "--token", "YOUR_TOKEN",
        "--linken-port", "40080",
        "--dolphin-port", "3001",
        "--dolphin-token", "DOLPHIN_KEY",
        "--wadex-port", "8080"
      ]
    }
  }
}

使用 ~/.cursor/mcp.json 进行全局设置（在所有项目中可用）。在项目根目录中使用 .cursor/mcp.json 通过版本控制与你的团队共享配置。

步骤 7 — 启动你的浏览器并测试

在使用 Cursor 的 AI 聊天之前，请确保你的反检测浏览器正在运行。快速检查清单：

Linken Sphere — 打开应用。如果你没有任何会话，请创建至少一个。
Dolphin Anty — 打开应用。确保在设置中启用了本地 API。
Wadex — 打开应用并验证 API 端口与你的配置匹配。

在 Cursor 中打开任何项目并开始与 AI 聊天（Cmd+L 或 Ctrl+L）。确保你使用的是 Agent 模式 — 这是 MCP 工具可用的地方。

🖼️

Switch to Agent mode in Cursor chat to use MCP tools

步骤 8 — 你的第一个 AI 浏览器命令

一切都已连接。打开 Cursor 聊天并用自然语言与其交谈。以下是一些要尝试的命令：

# Start a Linken Sphere session and navigate
> Start a new Linken Sphere session and open google.com

# Fill a form
> Go to example.com/signup, fill in email "test@mail.com" and password "SecurePass123", then click Sign Up

# Solve a CAPTCHA
> There's a CAPTCHA on this page, solve it

# Take a screenshot for visual analysis
> Take a screenshot of the current page and describe what you see

# Work with multiple sessions
> Start 3 Linken Sphere sessions and open google.com in all of them

🖼️

Cursor controlling Linken Sphere through Ornold MCP

可用的 MCP 工具

连接后，Cursor 可以访问 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 — 关闭会话

你不需要记住工具名称。只需用简单的英文描述你想要做什么，Cursor 将自动选择正确的工具。

交互模式

Ornold MCP 支持两种交互模式。你可以在设置时选择：

DOM 模式（默认，免费）

AI 通过 DOM 快照读取页面结构。每个元素都获得一个 [ref=N] 标记。快速且不花费任何 vision 信用。最适合具有清晰 HTML 的结构化页面。

Vision AI 模式（按分析付费）

AI 拍摄屏幕截图并使用视觉分析通过外观查找元素。适用于任何页面，甚至复杂的 SPA 或基于 canvas 的 UI。每次分析花费 1 个 vision 信用。

要启用两种模式，请将 --mode 标志添加到你的 MCP 配置参数：

{
  "mcpServers": {
    "ornold-browser": {
      "command": "npx",
      "args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--mode", "both", "--linken-port", "40080"]
    }
  }
}

Cursor Agent 模式 vs Ask 模式

Cursor 有两种聊天模式。MCP 工具仅在 Agent 模式中工作：

Agent 模式 — AI 可以使用 MCP 工具、运行终端命令和编辑文件。这是你进行浏览器自动化所需的。
Ask 模式 — AI 仅根据你的代码库回答问题。无工具访问权限。MCP 工具不会出现在这里。

在尝试浏览器命令之前，请确保你处于 Agent 模式（检查聊天面板顶部的下拉菜单）。如果你看不到 MCP 工具，请切换到 Agent 模式。

你也可以使用 Cursor 的 Composer（Cmd+I / Ctrl+I）进行多步浏览器自动化任务。Composer 在 Agent 模式中也支持 MCP 工具。

故障排除

"MCP server not showing" — 确保 mcp.json 是有效的 JSON。即使是尾部逗号也会破坏它。如果不确定，请使用 JSON 验证器。
"npx: command not found" — Node.js 不在 PATH 中。安装 Node.js 后重启 Cursor。在使用 nvm 的 macOS 上，你可能需要在命令字段中设置 npx 的完整路径。
"Cannot connect to Linken Sphere" — 确保 Sphere 正在运行且 API 端口正确（默认 40080）。检查防火墙是否阻止该端口。
"Token invalid" — 从 mcp.ornold.com 仪表板再次复制令牌。令牌是长字符串 — 确保你复制了整个值。
"Tools not appearing in chat" — 确保你处于 Agent 模式而不是 Ask 模式。检查 Cursor Settings → MCP 以验证服务器显示绿色"connected"状态。
"CAPTCHA solve failed" — 检查 Ornold 仪表板上的 CAPTCHA 信用余额。免费计划包括有限的解决方案。
"Server disconnected" — Cursor 可能在空闲时断开 MCP 服务器。重启聊天或在 Settings → MCP 中切换服务器。

接下来是什么？

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

解析