如何给ChatGPT、Claude、Grok装上"超级浏览器"?Unbrowse MCP连接全攻略
如何给ChatGPT、Claude、Grok装上"超级浏览器"?Unbrowse MCP连接全攻略
Unbrowse 是一个开源的"网站逆向工程"工具:它观察每个网站与自家后端通信的第一方 API,把这些请求编译成可复用的工具,让 ChatGPT、Claude、Grok 等 AI 助手以比驱动真实浏览器快 50-100 倍、成本约低 95% 的速度直接调用网站。连接方式简单——通过 MCP(Model Context Protocol,模型上下文协议)把助手接到 Unbrowse 的远程服务器即可,本文带你看懂全部步骤。
🧠 Unbrowse 是什么?为什么叫"超级浏览器"
大多数 AI 助手"上网"的方式是:加载页面、读 DOM、截图、点击界面、等待——慢、贵,还容易被反爬拦截。
Unbrowse 往下钻一层,把浏览变成三步:
- Discover(发现):先搜索你的私有能力库,再搜公开的"已编译网站"注册表;
- Run(执行):匹配到能力后,直接回放网站自己的 HTTP 请求,不启动浏览器;且只有结果被验证后才算成功;
- Learn once(学一次):没匹配上时,agent 在 Unbrowse 的云端浏览器里把任务做一次并全程录制,Unbrowse 将其编译成"一次调用"的能力。下次再遇到同类任务,直接走第 2 步。
一句话:学一次,调多次。密码保存在 Unbrowse 密码管理器中,永远不经过模型。
- 原理详解:docs/how-it-works.md
- 产品概览白皮书:docs/whitepaper/what-is-unbrowse.md
⚡ 连接的核心:一个 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
- 在 ChatGPT 中打开 Developer mode(开发者模式);
- 在助手设置里添加 MCP app,URL 填
https://unbrowse.ai/mcp; - 认证方式选择 OAuth,在弹出的窗口完成 Unbrowse 登录;
- 回到聊天窗口直接下任务即可。
Claude:Settings 里添加自定义 Connector
- 打开 Settings → Connectors;
- 点击 Add custom connector;
- URL 填
https://unbrowse.ai/mcp; - 完成 OAuth 登录。
💡 小提示:如果你希望 Claude 里保存的网站、Canvas 数据与 Unbrowse 控制台一致,请用同一个 Unbrowse 账号登录。
Grok:新建自定义 Connector
- 进入 Grok 的连接器页面 → New Connector → Custom;
- 填入 URL
https://unbrowse.ai/mcp,完成登录; - 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 |
本月已验证调用量与剩余额度 |
标准操作顺序只有四步:
unbrowse_discover找能力(要登录的站点先看unbrowse_sites);unbrowse_run启动任务,传上你知道的全部参数;- 返回
input_required→ 在同一 run 上用unbrowse_resume作答; - 返回
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
📖 延伸阅读
- 安装与第一个请求:docs/install.md
- MCP 完整说明(含登录 elicitation、按站点的 MCP 服务器):docs/mcp.md
- 各助手连接细节:docs/connect.md
- CLI 命令参考:docs/cli.md
- TypeScript SDK(
@unbrowse/sdk):docs/sdk.md - 白皮书《Internal APIs Are All You Need》:docs/whitepaper/README.md