绑定浏览器
浏览器资产是你本来就在用的浏览器——在你自己的桌面机器上,用你自己的登录态。WingGate 浏览器扩展是让它可管理的那块拼图:它把浏览器接入 WingGate,向被授权的 AI Agent 暴露受控的浏览器工具,并把敏感操作留在你的控制之下。
扩展运行在你的浏览器里、你的机器上。页面数据只会交给你在项目中授权的人,不经过任何你没有搭建的第三方中转。
你会得到什么
浏览器完成绑定、成员获得项目访问之后:
- 持有 MCP 凭据的 AI Agent 可以使用浏览器工具:页面快照、截图、点击、填写、等待、拖拽、滚轮与右键菜单,以及页面级 WebMCP 工具的发现与调用。
- 破坏性或敏感操作(提交表单、走完流程)需要在扩展侧本地确认——扩展会在执行前先问你。
- 访问链与其它资产一致:组织角色、项目授权、资产就绪状态和审计记录。
安装扩展
从 Chrome 应用商店安装
官方分发的稳定构建,随版本自动更新,不需要在本地保留任何目录:
- 打开 Chrome 应用商店的 WingGate 页面,选择添加至 Chrome。
- 在浏览器工具栏固定 WingGate 图标,然后开始绑定。
无法访问商店时:加载已解压的扩展
离线或隔离网络下,使用 WingGate 部署自身域名分发的安装包:
- 从你的 WingGate 部署自身域名下载扩展安装包。zip 根即扩展根。
- 解压到一个你打算长期保留的目录(浏览器会从这个目录加载扩展)。
- 打开
chrome://extensions(或你的 Chromium 系浏览器的等价页面),开启开发者模式,选择加载已解压的扩展,然后选中解压后的目录。
两条路径都适用于 Chromium 系浏览器(Chrome、Chromium 及其衍生),且共用同一个扩展 ID:商店版与下载包可以互相替换而不丢失绑定。解压安装需要自己保留目录并手动升级——拿到新版本包后替换目录内容,再到 chrome://extensions 重新加载。
绑定到你的组织
绑定采用设备码流程,浏览器本身不需要控制台凭据:
- 在 Web 控制台打开组织资产池,选择添加资产 → 绑定浏览器。这里会打开绑定指南和绑定审批页入口。
- 在浏览器中打开 WingGate 扩展并开始绑定,它会显示一个短设备码。
- 在控制台的绑定审批页批准该代码。
- 绑定成功后,浏览器以自动生成的名称出现在组织资产池中。
一台已绑定的浏览器是一条资产,绑定以扩展的公钥为身份。在扩展内解除绑定会同时:吊销该扩展在服务端的身份、把对应的 browser 资产从组织资产池移除,并删除本机密钥。解除后重新绑定会得到一条新资产;未解除绑定时的再次绑定会接回原来那条资产,不会重复创建。重装系统的机器不会继承过期访问。
使用它
绑定完成后,像其它资产一样通过项目授权成员。持有该项目 MCP 凭据的 Agent 会在文件与命令工具之外列出浏览器工具。当扩展关闭或浏览器未运行时,资产显示为离线——这是活跃会话状态,不是配置故障;重新打开浏览器即可恢复。
排障
- 绑定未完成——确认扩展已打开且显示的设备码与你批准的一致,并在正确的组织的审批页批准。
- 资产离线——启动浏览器即可,扩展会自行重连。
- Agent 无法使用浏览器工具——检查成员的项目授权以及 MCP 凭据是否为该项目创建;参见 MCP 配置指南。
- 解除绑定失败——解除绑定需要 Hub 可达:扩展会先吊销服务端身份再清本地密钥,网络不通时会保留绑定并报错,稍后重试即可。已无法访问 Hub 时,也可由组织管理员在控制台的执行端列表中吊销该扩展。
- 从旧版下载包升级后绑定丢失——下载包与商店版共用同一个扩展 ID。若你此前加载的是更早的下载包(旧 ID),那份目录在 Chrome 里是另一条扩展,新包不会原地升级它:先在扩展内解除绑定(吊销服务端身份并移除 browser 资产),再到
chrome://extensions移除旧条目、加载或安装新包,然后重新绑定。跳过解除绑定会在组织里留下一条孤儿 agent 与 browser 资产。