如何给ChatGPT、Claude、Grok装上"超级浏览器"?Unbrowse MCP连接全攻略

原创2026-10-28 02:26:111,987 阅读

如何给ChatGPT、Claude、Grok装上"超级浏览器"?Unbrowse MCP连接全攻略

Unbrowse 是一个开源的"网站逆向工程"工具:它观察每个网站与自家后端通信的第一方 API,把这些请求编译成可复用的工具,让 ChatGPT、Claude、Grok 等 AI 助手以比驱动真实浏览器快 50-100 倍、成本约低 95% 的速度直接调用网站。连接方式简单——通过 MCP(Model Context Protocol,模型上下文协议)把助手接到 Unbrowse 的远程服务器即可,本文带你看懂全部步骤。

🧠 Unbrowse 是什么?为什么叫"超级浏览器"

大多数 AI 助手"上网"的方式是:加载页面、读 DOM、截图、点击界面、等待——慢、贵,还容易被反爬拦截。

Unbrowse 往下钻一层,把浏览变成三步:

  1. Discover(发现):先搜索你的私有能力库,再搜公开的"已编译网站"注册表;
  2. Run(执行):匹配到能力后,直接回放网站自己的 HTTP 请求,不启动浏览器;且只有结果被验证后才算成功;
  3. Learn once(学一次):没匹配上时,agent 在 Unbrowse 的云端浏览器里把任务做一次并全程录制,Unbrowse 将其编译成"一次调用"的能力。下次再遇到同类任务,直接走第 2 步。

一句话:学一次,调多次。密码保存在 Unbrowse 密码管理器中,永远不经过模型。

⚡ 连接的核心:一个 URL + 一次 OAuth 登录

Unbrowse 提供一个远程 MCP 服务器(Streamable HTTP 传输),地址固定为:

https://unbrowse.ai/mcp
  • 登录走 OAuth 2.1 + PKCE,由你的助手客户端自己执行整个授权流程,全程不需要把 API key 粘贴到聊天框里;
  • 如果你习惯用 API key,Authorization: Bearer ub_live_… 也同样可用。

这意味着:任何支持"自定义 MCP connector"的助手都能接。下面按平台给出具体路径。

🗂️ 各平台 MCP 连接步骤速查

ChatGPT:开启开发者模式,添加 MCP app

  1. 在 ChatGPT 中打开 Developer mode(开发者模式);
  2. 在助手设置里添加 MCP app,URL 填 https://unbrowse.ai/mcp;
  3. 认证方式选择 OAuth,在弹出的窗口完成 Unbrowse 登录;
  4. 回到聊天窗口直接下任务即可。

Claude:Settings 里添加自定义 Connector

  1. 打开 Settings → Connectors;
  2. 点击 Add custom connector;
  3. URL 填 https://unbrowse.ai/mcp;
  4. 完成 OAuth 登录。

💡 小提示:如果你希望 Claude 里保存的网站、Canvas 数据与 Unbrowse 控制台一致,请用同一个 Unbrowse 账号登录。

Grok:新建自定义 Connector

  1. 进入 Grok 的连接器页面 → New Connector → Custom;
  2. 填入 URL https://unbrowse.ai/mcp,完成登录;
  3. Business / Enterprise 账号需要管理员先添加。

Perplexity 与 Le Chat 也能接

助手 添加位置 关键配置
Perplexity Settings → Connectors → + Custom connector → Remote URL https://unbrowse.ai/mcp,传输 Streamable HTTP,认证 OAuth
Le Chat (Mistral) Connectors → custom MCP connector URL https://unbrowse.ai/mcp

各助手的完整入口与参数见:docs/connect.md

编程 Agent(Claude Code / Codex 等):一条命令最快捷

终端类 agent 用命令行接入最直接:

# Claude Code
claude mcp add --transport http unbrowse https://unbrowse.ai/mcp

# Codex
codex mcp add unbrowse --url https://unbrowse.ai/mcp && codex mcp login unbrowse

也可以在客户端的 MCP 配置 JSON 里直接写:

{ "mcpServers": { "unbrowse": { "url": "https://unbrowse.ai/mcp" } } }

插件方案(推荐):官方仓库为 Claude Code、Codex、Cursor、Dify、n8n、LangChain、LlamaIndex、Zed、Raycast 等宿主提供了现成插件(plugins/README.md)。插件不仅连上托管 MCP,还会把宿主内置浏览器的工作重定向到 Unbrowse,例如:

claude plugin marketplace add unbrowse-ai/unbrowse
claude plugin install unbrowse@unbrowse

需要本地 stdio 的宿主(或不接受带点的工具名,如 Grok Build)可以用本地代理:

npx -y unbrowse mcp

它会复用 CLI 的登录态,工具名改用下划线(如 unbrowse_scrape)。

📚 别漏掉:安装 Agent Skill

MCP 提供的是"连接",而 skill 提供的是"操作规范"(执行顺序、登录交接、如何判断验证过的结果)。建议两者一起装:

npx skills add unbrowse-ai/unbrowse --skill unbrowse

安装器会列出可选的 agent,选你的助手即可;装完建议重启或重新加载 skills。

⚠️ 一个常见误区:skill 本身不是连接。如果装了 skill 却没有 Unbrowse 工具,请回到上一节补上远程 MCP 并完成认证,再刷新客户端工具列表。

完整的 agent 契约见:skill/SKILL.md

🚀 连接后的第一个任务

官方推荐的第一句验证话术:

"Read https://news.ycombinator.com with Unbrowse and list the top 5 stories."

然后试一个你常用的网站任务,例如"查明天新加坡到东京的航班"。新站点的第一次运行可能走云端浏览器——Unbrowse 会学会这条路线,之后的运行就变成纯 API 调用,又快又省。

🛠️ Unbrowse 会给助手带来哪些工具

连接完成后,助手可使用的核心工具包括:

工具 用途
unbrowse_discover 搜索你的私有空间,再搜公开注册表
unbrowse_sites 查看站点状态:公开还是需登录、会话、已存登录、学到的工具
unbrowse_run 用能力 ID 或自然语言任务启动运行
unbrowse_inspect 查看运行状态、要求与验证过的结果
unbrowse_resume 运行索要输入时,在同一 run 上继续作答
unbrowse_cancel 停止新的调度并获取回执
unbrowse_scrape 把一个页面读成 Markdown
unbrowse_browse_open / _snapshot / _act / _finish / _close 录制式云端浏览器
unbrowse_learn 把 HAR 录制编译成可复用能力
unbrowse_usage 本月已验证调用量与剩余额度

标准操作顺序只有四步:

  1. unbrowse_discover 找能力(要登录的站点先看 unbrowse_sites);
  2. unbrowse_run 启动任务,传上你知道的全部参数;
  3. 返回 input_required → 在同一 run 上用 unbrowse_resume 作答;
  4. 返回 no_capability → 用 unbrowse_browse_* 做一次,自动学会。

工具入参 schema 参考:skill/references/tools.json

🩹 故障排查速查

现象 怎么办
装了 skill 但看不到 Unbrowse 工具 skill 是指令不是连接;补上远程 MCP、完成认证并刷新工具
网站需要登录 通过返回的 Unbrowse save-login 链接保存登录(Unbrowse 登录 ≠ 自动登录所有网站)
input_required 在同一 run 上用 unbrowse resume RUN_ID field=value 作答
no_capability 让 agent 用云端浏览器做一次并学会路线(CLI 本身不跑本地浏览器)
人机验证 / MFA 走官方支持的交接;挑战页出现不代表任务成功
额度不足或被拒 用 unbrowse usage 与控制台套餐核对;重试不会增加额度

完整对照表:docs/troubleshooting.md

💰 计费说明

以你账号控制台的当前套餐为准:unbrowse usage 命令和计费页面都能查到额度与消耗。只有验证成功的运行才计费,失败、被拒或中断的运行不计费。详情:docs/pricing.md

📖 延伸阅读

登录后查看全文
unbrowse