返回博客
指南3 分钟阅读
Linken Sphere MCP 配置:将 AI 代理连接到指纹浏览器
逐步指南:将 Claude Code、Cursor、Windsurf 或 Cline 连接到 Linken Sphere。用自然语言控制会话,无需脚本。
2026年4月18日最简单的方式:让你的 AI 代理自动安装
现代 AI 代理(Claude Code、Cursor、Windsurf、Cline、Codex)可以自动安装 Ornold MCP。粘贴带 token 的 prompt,代理会编辑配置并通过 CDP 连接。无需手动改 JSON。
步骤 1 — 启动 Linken Sphere
- 打开 Linken Sphere
- 确保至少有一个会话存在(如果需要就创建一个)
- 记下 API 端口 —— 默认是 `40080`
Linken Sphere 的 API 始终开启 —— 无需切换。只要 API 端口匹配,Ornold 自动通过 CDP 连接。
步骤 2 — 获取你的 Ornold token
- 在 mcp.ornold.com 注册
- 打开 Tokens 页面
- 点击 Create token,复制值
步骤 3 — 把安装 prompt 粘贴到你的代理
选择你的代理并粘贴对应 prompt。把 `YOUR_TOKEN` 替换为步骤 2 的 token。
Claude Code
Install Ornold MCP for Linken Sphere automation.
Requirements: Node.js ≥ 18.
Token: https://mcp.ornold.com → Tokens → Create token.
Run:
claude mcp add --transport stdio ornold-browser -- npx mcp-ornold-browser --token YOUR_TOKEN --linken-port 40080 --mode vision
npx mcp-ornold-browser --install-skill
After setup, verify by calling browser_list.
Cursor
Install Ornold MCP for Linken Sphere automation.
Requirements: Node.js ≥ 18.
Token: https://mcp.ornold.com → Tokens → Create token.
Edit ~/.cursor/mcp.json and add:
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": ["mcp-ornold-browser", "--token", "YOUR_TOKEN", "--linken-port", "40080", "--mode", "vision"]
}
}
}
Restart Cursor after saving.
Codex
Install Ornold MCP for Linken Sphere automation.
Requirements: Node.js ≥ 18.
Token: https://mcp.ornold.com → Tokens → Create token.
Edit ~/.codex/config.toml and add:
[mcp_servers.ornold-browser]
command = "npx"
args = ["-y", "mcp-ornold-browser", "--token", "YOUR_TOKEN", "--linken-port", "40080", "--mode", "vision"]
步骤 4 — 验证
询问代理:
List my connected Linken Sphere sessions using browser_list
如果会话出现,你就准备好了。试试:
Open google.com in all my sessions and take a screenshot
为什么用 Vision 模式做反检测?
`--mode vision` 标志告诉 Ornold 通过截图 + 坐标点击(带贝塞尔曲线)交互,而不是 CSS 选择器。反检测网站会标记 DOM 抓取;基于坐标的点击看起来像人类,可绕过这些检查。
故障排除
- **browser_list 为空** —— 确保 Linken Sphere 已打开,至少有一个会话在运行。
- **端口错误** —— 默认是 40080。如果你在 Linken Sphere 设置中改了它,更新 `--linken-port` 值。
- **Token 无效** —— 从 mcp.ornold.com Tokens 页面重新复制。
- **npx: command not found** —— 从 nodejs.org 安装 Node.js 18+。
下一步是什么?
- 并行浏览器自动化 —— 同时跨多个 Sphere 会话运行动作
- CAPTCHA 解决指南 —— Linken Sphere 中的 reCAPTCHA、hCaptcha、Turnstile
- Vision AI vs CSS 选择器 —— 为什么这对反检测重要