什么是浏览器 MCP 服务器?
MCP 是一个开放协议,让 AI 应用可以调用模型之外的工具。浏览器 MCP 服务器提供打开网页、点击、输入和读取等工具,让助手能使用没有 API 的网站。Browsa 服务器在云浏览器而不是你的电脑上执行这些步骤,所以不会碰到你自己的浏览器、Cookie 和密码,页面再慢,任务也会继续运行。
服务器本身是一个小型 Node.js 进程,由你的 MCP 客户端通过 npx 启动。它发出的每个请求都会带着你的 agt_live_ 密钥发往 Browsa API。
-
获取 API 密钥
-
把服务器添加到客户端
Claude Desktop
打开配置文件:macOS 上是
~/Library/Application Support/Claude/claude_desktop_config.json,Windows 上是%APPDATA%\Claude\claude_desktop_config.json。添加服务器,保存并重启 Claude Desktop。{ "mcpServers": { "browsa": { "command": "npx", "args": ["-y", "@browsa/mcp"], "env": { "BROWSA_API_KEY": "agt_live_..." } } } }Claude Code
在终端中添加。服务器名称要写在
-e之前,--之后的所有内容是 Claude Code 要运行的命令。claude mcp add browsa -e BROWSA_API_KEY=agt_live_... -- npx -y @browsa/mcp运行
claude mcp list检查是否已连接。Cursor
把同样的配置块加到
~/.cursor/mcp.json可对所有项目生效,加到某个项目的.cursor/mcp.json则只对该项目生效。{ "mcpServers": { "browsa": { "command": "npx", "args": ["-y", "@browsa/mcp"], "env": { "BROWSA_API_KEY": "agt_live_..." } } } }VS Code
VS Code 读取工作区中的
.vscode/mcp.json。它的格式用servers而不是mcpServers。这个版本会在服务器首次启动时询问密钥,因此密钥不会保存在文件里。{ "inputs": [ { "type": "promptString", "id": "browsa-api-key", "description": "Browsa API key (agt_live_...)", "password": true } ], "servers": { "browsa": { "type": "stdio", "command": "npx", "args": ["-y", "@browsa/mcp"], "env": { "BROWSA_API_KEY": "${input:browsa-api-key}" } } } }Cline、Continue、Zed 和其他客户端
任何通过 stdio 启动 MCP 服务器的客户端都可以使用。把命令指向
npx -y @browsa/mcp,并在服务器的环境变量中设置BROWSA_API_KEY。 -
试一试
让助手做一件需要实时网页的事,例如:
- “打开 news.ycombinator.com,告诉我排名第一的帖子。”
- “打开 books.toscrape.com,列出前五本书及其价格。”
- “每天早上检查这个商品页的价格,并把结果发到我的 Webhook。”
助手会调用
run_task。结果会附带一个live_url:打开即可观看浏览器;遇到需要人工处理的页面,也可以直接用鼠标和键盘操作。
浏览器任务用哪个模型?
浏览器智能体需要一个语言模型。你无需在配置中填写模型密钥。每次调用按以下顺序匹配,先匹配的生效:
- 调用中的
llm: "browsa"Browsa 托管模型,无需密钥,每个任务多收 5 积分。 BROWSA_LLM_API_KEY你的 Anthropic、OpenAI 或 Google 密钥,随每个任务发送,任务运行期间加密保存,结束即删除。BROWSA_LLM_KEY_ID你在控制台保存的密钥,按 id 指定。- 什么都没设置工作区的默认已保存密钥。如果没有保存密钥也没有指定模型,任务会在 Browsa 托管模型上运行,结果中也会注明。
BROWSA_LLM 用于设置默认模型,例如 anthropic:claude-sonnet-5-5。如果你指定了模型却没有可用密钥,工具会返回 LLM_KEY_REQUIRED,而不会回退。
助手能用哪些工具?
run_task- 运行用自然语言描述的浏览器任务,返回结果和实时画面链接。
get_job- 查看长时间运行的任务,可选择在服务器端等待。
cancel_job- 取消正在运行的任务。
respond_to_job- 回复因等待输入而暂停的任务。
list_job_files- 列出任务写入的文件,比如下载的报表。
create_schedule,list_schedules- 定时任务,从每小时一次到每 30 天一次。
list_webhooks,create_webhook,delete_webhook- 结果的推送目标,以 HMAC 签名的 Webhook 发送。
list_identities- 持久身份,任务可复用其中保存的登录状态。
list_llm_keys- 已保存的模型密钥,已脱敏,绝不返回密钥原文。
credits- 积分余额和积分包。
费用是多少?
MCP 服务器免费。每次 run_task 都是一个智能体任务,按积分计费:浏览器时间(每开始一个 12 分钟收 1 积分),加 1 积分,再加每 5 步 1 积分。使用 Browsa 托管模型再加 5 积分。
| 任务(12 分钟内完成) | 自带模型密钥 | Browsa 托管模型 |
|---|---|---|
| 10 步 | 4 积分 | 9 积分 |
| 20 步 | 6 积分 | 11 积分 |
失败的任务会退回浏览器费用,步数也不收费。使用自带密钥时,token 费用由你的模型服务商收取,Browsa 不加价。$20 的 Starter 包中 1 积分为 $0.10。完整价格。
故障排查
服务器没有出现
编辑配置后重启客户端,确认 JSON 格式有效,并在终端运行 node --version:服务器需要 Node.js 18 或更高版本,且客户端使用的 PATH 中要有 npx。
LLM_KEY_REQUIRED
你指定了模型,但没有可用的密钥。可以在 dashboard/llm-keys 保存密钥、设置 BROWSA_LLM_API_KEY,或改用 llm: "browsa"。
402 INSUFFICIENT_CREDIT 或 BUDGET_REACHED
余额不足,或已达到每月支出上限。让助手运行 credits 工具,或到控制台的积分页面查看。
常见问题
浏览器在我的电脑上运行吗?
不是。MCP 服务器是你电脑上的一个小型 Node.js 进程,负责调用 Browsa API。浏览器运行在 Browsa 的云端,所以无需安装其他东西,也不会碰到你自己的浏览器。
我需要 Anthropic 或 OpenAI 密钥吗?
不需要。只设置 BROWSA_API_KEY 且没有保存密钥时,任务会在 Browsa 托管模型上运行,每个任务多收 5 积分,服务器也会在结果中注明。要使用自己的模型,可以在控制台保存 Anthropic、OpenAI 或 Google 密钥,或设置 BROWSA_LLM_API_KEY。
每次请求要花多少?
每次 run_task 调用都是一个智能体任务:浏览器时间(每开始一个 12 分钟收 1 积分),加 1 积分,再加每 5 步 1 积分。一个在 12 分钟内完成的 10 步任务,用自带密钥花 4 积分,用 Browsa 托管模型花 9 积分。MCP 服务器本身免费。
支持哪些 MCP 客户端?
任何能通过 stdio 启动本地 MCP 服务器的客户端,包括 Claude Desktop、Claude Code、Cursor、VS Code、Cline、Continue 和 Zed。服务器需要 Node.js 18 或更高版本来运行 npx。