返回博客
指南15 分钟阅读
Claude Code + Ornold MCP：完整配置指南
安装 Node.js，配置 Claude Code，连接 Ornold MCP，用 AI 自动化指纹浏览器。macOS 和 Windows。
2026年4月17日你将构建什么
完成本指南后，你将让 Claude Code 控制真实的反检测浏览器会话——导航页面、填写表单、解决 CAPTCHA，并通过自然语言命令管理多个配置文件。无需 Playwright 脚本，无需 CSS 选择器，只需告诉 AI 要做什么。
本指南涵盖 macOS 和 Windows。Linux 步骤与 macOS 相同（使用你的包管理器代替 Homebrew）。
前提条件
- 运行 macOS 12+ 或 Windows 10/11 的计算机
- 已安装反检测浏览器：Linken Sphere、Dolphin Anty、Wadex 或 Vision Browser
- 用于下载工具和软件包的网络连接
- 基本熟悉终端（macOS）或 PowerShell（Windows）
第 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"。
打开终端（macOS）或 PowerShell（Windows）验证安装：
node --version
# Expected output: v22.x.x or higher
npm --version
# Expected output: 10.x.x or higher
第 2 步 — 安装 Claude Code
Claude Code 是 Anthropic 的 AI 编码代理，运行在你的终端中。它支持 MCP（Model Context Protocol），允许其使用外部工具——例如浏览器自动化。
macOS
npm install -g @anthropic-ai/claude-code
Windows
以管理员身份打开 PowerShell 并运行：
npm install -g @anthropic-ai/claude-code
安装完成后，启动 Claude Code 完成身份验证：
claude
# Follow the prompts to sign in with your Anthropic account
Claude Code 需要 Anthropic API 密钥或 Claude Pro/Team 订阅。如果你还没有，请在 console.anthropic.com 注册。
第 3 步 — 创建 Ornold 账户
Ornold 是 AI 代理与反检测浏览器之间的桥梁，你需要一个账户来获取 API 令牌。
- 访问 mcp.ornold.com
- 点击"Register"并用邮箱创建账户
- 用发送到邮箱的 6 位验证码验证邮箱
- 进入仪表盘——你已成功登录！
第 4 步 — 创建 API 令牌
注册后，仪表盘会提示你创建第一个 API 令牌。该令牌用于验证你的 MCP 连接。
- 输入令牌名称（例如"Claude Code"）
- 点击"Create"
- 复制令牌并妥善保存——下一步会用到
免费账户可获得 1 个席位、5 次 captcha 解决（完成教程后）以及标准浏览器访问权限。升级套餐可获得更多配额。
第 5 步 — 使用仪表盘向导生成 MCP 配置
Ornold 仪表盘内置了连接向导，可为你的配置生成精确的 MCP 配置。无需手动编写命令——只需选择选项并复制结果即可。
进入仪表盘的 API Tokens 标签页，找到你的令牌，点击旁边的"Connect"按钮。
向导第 1 步 — 选择 AI 代理
向导询问你使用哪个 AI 代理。从列表中选择"Claude Code"。其他支持的代理包括 Cursor、VS Code、Windsurf、Cline 和 Codex——每个都有专属配置格式。
向导第 2 步 — 选择交互模式
选择 AI 与浏览器页面的交互方式：
- DOM 模式（默认）— AI 读取页面 HTML 结构，每个元素获得 [ref=N] 标记。免费且快速，最适合表单、结构化页面和标准网站。
- Vision AI 模式 — AI 截取页面截图，根据视觉外观查找元素。适用于任何页面，包括基于 canvas 的 UI。每次分析消耗 1 个视觉点数。
- 两种模式 — 所有工具均可使用，AI 会自动为每个操作选择最佳方式。
从 DOM 模式开始。它免费、快速，可处理 90% 的使用场景。如果需要视觉分析，随时可以切换到"两种模式"。
向导第 3 步 — 启用反检测浏览器
开启你使用的浏览器并填写连接详情：
- Linken Sphere — 只需设置 API 端口（默认：40080）。确保 Sphere 正在运行。
- Dolphin Anty — 设置本地端口（默认：3001），并从设置 → API 粘贴你的 Dolphin API 令牌。
- Wadex — 设置 API 端口（默认：8080）。
- Vision Browser — 粘贴你的 X-Token，可选填本地端口。
你可以同时启用多个浏览器。MCP 配置将包含所有已启用的浏览器，AI 代理将能够控制任何正在运行的浏览器。
向导第 4 步 — 复制并应用配置
向导根据你的选择生成最终配置。对于 Claude Code，你有两个选项：
选项 A：终端命令（推荐）
复制单行命令并粘贴到终端中。这是一次性设置——之后每次 MCP 都会随 Claude Code 自动启动。
claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --linken-port 40080
选项 B：项目 .mcp.json 文件
如果你希望通过版本控制与团队共享 MCP 配置，复制 JSON 并将其保存为项目根目录下的 .mcp.json 文件：
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--linken-port", "40080"]
}
}
}
向导会预填你实际的令牌和端口值——只需点击"Copy"并粘贴，无需手动编辑。
验证 MCP 服务器是否已注册：
claude mcp list
# You should see "ornold-browser" in the list
第 6 步 — 启动浏览器并测试
在启动 Claude Code 之前，请确保你的反检测浏览器正在运行。快速检查清单：
- Linken Sphere — 打开应用。如果还没有会话，至少创建一个。
- Dolphin Anty — 打开应用。确保在设置中已启用本地 API。
- Wadex — 打开应用并确认 API 端口与配置一致。
第 7 步 — 你的第一条 AI 浏览器命令
一切已连接完毕。在任意目录启动 Claude Code：
claude
现在用自然语言与它交流。以下是一些可以尝试的命令：
# 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
可用 MCP 工具
连接后，Claude Code 可以访问 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 — 关闭会话
你不需要记住工具名称。只需用普通中文描述你想做的事，Claude Code 会自动选择合适的工具。
交互模式
Ornold MCP 支持两种交互模式，可在设置时选择：
DOM 模式（默认，免费）
AI 通过 DOM 快照读取页面结构，每个元素获得 [ref=N] 标记。速度快且不消耗视觉点数，最适合 HTML 结构清晰的结构化页面。
Vision AI 模式（按分析次数付费）
AI 截取页面截图并通过视觉分析根据外观查找元素。适用于任何页面，包括复杂的单页应用或基于 canvas 的 UI。每次分析消耗 1 个视觉点数。
# Enable both modes:
claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --mode both
常见问题排查
- "npx: command not found" — Node.js 不在 PATH 中。安装 Node.js 后重启终端。Windows 上请确保安装时勾选了"Add to PATH"。
- "Cannot connect to Linken Sphere" — 确保 Sphere 正在运行且 API 端口正确（默认 40080）。检查防火墙是否阻止了该端口。
- "Token invalid" — 从 mcp.ornold.com 仪表盘重新复制令牌。令牌是长字符串，确保复制了完整的值。
- "MCP server not responding" — 运行 `claude mcp list` 验证注册状态。尝试删除并重新添加：`claude mcp remove ornold-browser`，然后重新运行添加命令。
- "CAPTCHA solve failed" — 在 Ornold 仪表盘检查你的 captcha 点数余额。免费套餐的解决次数有限。
- "Permission denied (npm install)" — macOS 上请在前面加 sudo。Windows 上以管理员身份运行 PowerShell。
下一步
- 阅读 Linken Sphere 自动化指南，了解高级会话管理
- 学习并行浏览器自动化，同时运行 10 个以上会话
- 查看 CAPTCHA 解决指南，处理 reCAPTCHA、hCaptcha 和 Turnstile
- 探索 Vision AI 模式，与复杂的视觉界面交互