技能介绍

要解决什么问题

桌面 Agent 经常需要「真浏览器」：持久化 Profile、扩展、以及你在窗口里亲手完成的登录、MFA 和验证码。把整颗浏览器搬到云端或让模型代填密码，既不符合安全习惯，也容易踩站点风控。本技能围绕 Browser Orchestrator：在本机以有头浏览器节点运行，通过 MCP Relay 与上游 Agent 协作——Relay 派任务，节点在本机执行导航与页面操作，敏感步骤仍由你手动完成。

技能如何工作

连接上分三类凭证，职责要分清：

MCP_RELAY_PAIRING_TOKEN：短时令牌，仅用于 POST /api/nodes/pair 完成节点配对。
node_secret：配对后写入 .local/relay-node.json，仅供 Browser Node 的 worker WebSocket 使用。
MCP_RELAY_MCP_TOKEN：Relay 服务端配置的 Bearer，供桌面 Agent 或 @tpxipsterliu/mcp-connect 访问 Streamable HTTP MCP 端点 /mcp。

典型部署是分机：Skill 装在会与 Relay 对话的 Agent 机；Browser Orchestrator 装在有显示器的 Browser Node 工位。配对成功后执行 relay:worker，维持出站 WebSocket，上报心跳、任务进度与完成/失败事件。任务执行时只导航到明确的 http(s) 边界，浏览器保持有头；需要登录或验证时，Agent 应暂停并请你先在窗口内完成。

本地 MCP 工具（调试或非 Relay 路由时）包括：browser_start / browser_status / browser_stop，以及 page_goto、page_snapshot、page_click、page_fill、page_wait、page_screenshot。扩展抓取可走 capture_trigger；若返回 mode: "manual_required"，需你在有头浏览器里点扩展采集按钮，确认完成后再继续。

适用边界与注意点

不要把 pairing token、node_secret、.local/relay-node.json 内容贴进对话或提交到仓库；也不要在聊天里索要用户密码。
桌面 Agent 连远程 Relay 时，MCP 鉴权用 MCP_RELAY_MCP_TOKEN，不要把 pairing token 或 node_secret 交给 mcp-connect。
https://mcp-relay.cloudplus.im/api/mcp 不是 MCP 端点；/api/* 属于控制台与 worker REST 命名空间。
破坏性、付费、改账号或大批量操作前应征得确认；抓取目标需明确且经用户同意；未特别要求时不要另造 scraper，优先扩展采集路径。

截图预览

使用场景

Relay 向本机 Browser Node 下发任务后，在有头窗口打开用户指定的 https 页面；SSO、MFA 或验证码由你在浏览器内完成，Agent 再继续点击、填表或截图。
Agent 与浏览器分机：Agent 机通过 MCP 连 Relay 的 `/mcp`，工位机执行 `relay:pair` 与 `relay:worker`，接收派单并在本地 Profile 中保持登录态。
本地联调 Browser Orchestrator 时，用 `page_goto` 与 `page_snapshot` 查看当前 URL 与可见正文，再决定是否改用 Relay 任务路由。
页面数据需走浏览器扩展采集时调用 `capture_trigger`；返回需人工操作时，你在有头窗口点击扩展采集并确认完成后再继续后续步骤。

适合人员

负责 MCP Relay 与 Browser Node 分机部署的平台工程师，需要远程 Agent 派浏览任务但 Cookie、扩展与有头窗口必须留在工位本机。
常访问企业 SSO 或验证码站点、希望 Agent 在人工登录后继续执行翻页、填表与 `page_screenshot` 留证的文档或合规采集同学。
集成桌面 Agent 的开发者，要把 Streamable HTTP MCP 接到本地 Browser Orchestrator，而不是共用无头远程浏览器池。
维护浏览器扩展采集链路的数据同学，能接受 `capture_trigger` 在 manual_required 时暂停任务、待人工点扩展后再续跑。