指南12 分钟阅读

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

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

2026年4月18日

你将获得什么

完成本指南后，AI 代理（Claude Code、Cursor、Windsurf 或 Cline）将能够控制真实的 Linken Sphere 会话——打开页面、填充表单、解决 CAPTCHA 并管理多个会话——所有这些都通过自然语言命令完成。无需 Playwright 脚本。无需 CSS 选择器。只需告诉 AI 要做什么。

本指南专门介绍 Linken Sphere。如果您使用 Dolphin Anty、Wadex 或 Vision Browser，请查看特定浏览器的设置指南。

前置条件

Linken Sphere 已安装并运行
在 Linken Sphere 中至少创建了一个会话
已安装 Node.js 20+（nodejs.org）
AI 代理：Claude Code、Cursor、Windsurf 或 Cline
基本的终端/命令行操作能力

步骤 1 — 启用 Linken Sphere API

Linken Sphere 公开了一个本地 HTTP API，Ornold MCP 使用它来启动和控制会话。该 API 默认在端口 40080 上启用。

打开 Linken Sphere
确保应用程序正在运行
API 自动在 http://localhost:40080 上可用
无需额外配置——Linken Sphere API 始终开启

如果您在 Linken Sphere 设置中更改了默认端口，请记下它——您将在步骤 4 中需要它。

步骤 2 — 创建 Ornold 账户

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

访问 mcp.ornold.com
点击"注册"并使用您的电子邮件创建账户
使用发送到您收件箱的 6 位数代码验证您的电子邮件
您将进入仪表板——准备好进行下一步

🖼️

在 mcp.ornold.com 创建您的 Ornold 账户

步骤 3 — 创建 API 令牌

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

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

🖼️

创建并复制您的 API 令牌

免费套餐包括 1 个插槽、5 个 CAPTCHA 解决方案（完成入职后）和对标准浏览器的访问权限。升级以获得更多容量。

步骤 4 — 通过设置向导生成 MCP 配置

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

转到仪表板中的"API 令牌"选项卡。找到您的令牌并点击其旁边的"连接"按钮。

🖼️

点击您的令牌上的"连接"以打开向导

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

向导将询问您使用的 AI 代理。从列表中选择您的代理（Claude Code、Cursor、Windsurf、Cline 或 Codex）。每个代理都有自己的配置格式。

🖼️

步骤 1：选择您的 AI 代理

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

选择 AI 应如何与浏览器页面交互：

DOM 模式（默认）— AI 读取 HTML 结构。每个元素都获得一个 [ref=N] 标记。免费且快速。最适合表单、结构化页面和标准网站。
Vision AI 模式 — AI 拍摄屏幕截图并通过外观直观地查找元素。适用于任何页面，包括 canvas 界面。每次分析花费 1 个 vision 积分。
两种模式 — 所有工具都可用。AI 自动为每个操作选择最佳方法。

从 DOM 模式开始。它是免费的、快速的，可以处理 90% 的任务。如果您需要视觉分析，您可以随时切换到"两种模式"。

🖼️

步骤 2：在大多数情况下选择 DOM 模式

向导步骤 3 — 启用 Linken Sphere

打开 Linken Sphere 并填入连接详情：

API 端口（默认：40080）— 除非您在 Linken Sphere 设置中更改了它，否则使用默认值

您可以同时启用多个浏览器。MCP 配置将包括所有浏览器，AI 代理可以控制任何正在运行的浏览器。

🖼️

步骤 3：启用 Linken Sphere 并确认端口

向导步骤 4 — 复制并应用配置

向导根据您的选择生成最终配置。对于大多数 AI 代理，您有两个选项：

选项 A：终端命令（推荐）

复制单行命令并将其粘贴到您的终端中。这是一次性设置——之后 MCP 将每次与您的 AI 代理一起自动启动。

claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --linken-port 40080

🖼️

步骤 4：复制终端命令并运行它

选项 B：项目 .mcp.json 文件

如果您想通过版本控制与您的团队共享 MCP 配置，请复制 JSON 并将其保存为项目根目录中的 .mcp.json：

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

向导会自动填充您的令牌和端口值——只需点击"复制"并粘贴。无需手动编辑。

验证 MCP 服务器已注册：

claude mcp list
# You should see "ornold-browser" in the list

🖼️

Ornold MCP 服务器已成功注册

步骤 5 — 启动 Linken Sphere 并测试

在运行 AI 代理之前，请确保 Linken Sphere 已打开且您至少创建了一个会话。

打开 Linken Sphere
确保列表中至少有一个会话
在后台保持 Linken Sphere 运行

步骤 6 — 第一个 AI 浏览器命令

一切都已连接。启动您的 AI 代理（Claude Code、Cursor、Windsurf 或 Cline）并用自然语言与其交谈。以下是一些入门命令：

# Start a Linken Sphere session and navigate
> Start a 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

🖼️

AI 代理通过自然语言控制 Linken Sphere

可用的 MCP 工具

连接后，您的 AI 代理可以访问 40+ 个浏览器自动化工具。以下是最常用的：

browser_list — 列出所有可用的 Linken Sphere 会话
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
browser_status — 检查哪些会话正在运行

您无需记住工具名称。只需用简单的语言描述您想要做什么，AI 代理将自动选择正确的工具。

Linken Sphere 桌面

Linken Sphere 将会话组织成"桌面"——隔离的工作区，用于分组相关会话。当您通过 MCP 启动会话时，它使用 Linken Sphere 中当前活跃的桌面。

要控制使用哪个桌面，请在运行 AI 命令之前在 Linken Sphere 中切换到它。MCP 桥尊重您的活跃桌面选择。

交互模式

Ornold MCP 支持两种交互模式。您在设置期间选择了一种：

DOM 模式（默认，免费）

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

Vision AI 模式（付费，按分析计费）

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

# Enable both modes:
claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --mode both --linken-port 40080

故障排除

"No sessions found" — 确保 Linken Sphere 正在运行且您至少创建了一个会话。
"Connection refused" — 验证端口号（默认：40080）与您的 Linken Sphere API 端口匹配。确保防火墙未阻止 localhost 连接。
"MCP server not found" — 运行 `claude mcp list` 验证 ornold-browser 已注册。如果没有，请重新运行步骤 4 中的设置命令。
"Permission denied (npm install)" — 在 macOS 上，添加 sudo 前缀。在 Windows 上，以管理员身份运行 PowerShell。
"Session launch timeout" — Linken Sphere 在首次运行时启动会话可能很慢。等待 10-15 秒后重试。

接下来呢？

阅读 Dolphin Anty 自动化指南 (/blog/dolphin-anty-mcp-setup) 与另一个流行的反检测浏览器进行比较
了解并行浏览器自动化 (/blog/parallel-browser-automation) 以同时运行 10+ 个会话
查看 CAPTCHA 解决指南 (/blog/captcha-solving-guide) 以处理 reCAPTCHA、hCaptcha 和 Turnstile
探索 Vision AI 模式 (/blog/vision-vs-selectors) 以与复杂的视觉界面交互

解析