跳到正文
Browsa
  1. 指南
  2. MCP 服务器

在 Claude、Cursor 和 VS Code 中配置 Browsa MCP 服务器。

Browsa MCP 服务器(@browsa/mcp)是一个 Model Context Protocol 服务器,能给 AI 助手一个云端的真实浏览器。你用自然语言提出需求,Browsa 上的浏览器智能体完成工作,助手拿回答案,并附带一个实时观看浏览器的链接。

耗时
约 2 分钟
需要
Node.js 18 或更高版本,一个 Browsa API 密钥
包
npm 上的 @browsa/mcp,MIT

什么是浏览器 MCP 服务器?

MCP 是一个开放协议,让 AI 应用可以调用模型之外的工具。浏览器 MCP 服务器提供打开网页、点击、输入和读取等工具,让助手能使用没有 API 的网站。Browsa 服务器在云浏览器而不是你的电脑上执行这些步骤,所以不会碰到你自己的浏览器、Cookie 和密码,页面再慢,任务也会继续运行。

服务器本身是一个小型 Node.js 进程,由你的 MCP 客户端通过 npx 启动。它发出的每个请求都会带着你的 agt_live_ 密钥发往 Browsa API。

  1. 获取 API 密钥

    注册,然后在控制台的 Keys 页面复制密钥。验证邮箱后即送 100 个免费积分,无需绑卡。

  2. 把服务器添加到客户端

    Claude Desktop

    打开配置文件:macOS 上是 ~/Library/Application Support/Claude/claude_desktop_config.json,Windows 上是 %APPDATA%\Claude\claude_desktop_config.json。添加服务器,保存并重启 Claude Desktop。

    claude_desktop_config.json
    {
      "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 则只对该项目生效。

    ~/.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。这个版本会在服务器首次启动时询问密钥,因此密钥不会保存在文件里。

    .vscode/mcp.json
    {
      "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。

  3. 试一试

    让助手做一件需要实时网页的事,例如:

    • “打开 news.ycombinator.com,告诉我排名第一的帖子。”
    • “打开 books.toscrape.com,列出前五本书及其价格。”
    • “每天早上检查这个商品页的价格,并把结果发到我的 Webhook。”

    助手会调用 run_task。结果会附带一个 live_url:打开即可观看浏览器;遇到需要人工处理的页面,也可以直接用鼠标和键盘操作。

浏览器任务用哪个模型?

浏览器智能体需要一个语言模型。你无需在配置中填写模型密钥。每次调用按以下顺序匹配,先匹配的生效:

  1. 调用中的 llm: "browsa"Browsa 托管模型,无需密钥,每个任务多收 5 积分。
  2. BROWSA_LLM_API_KEY你的 Anthropic、OpenAI 或 Google 密钥,随每个任务发送,任务运行期间加密保存,结束即删除。
  3. BROWSA_LLM_KEY_ID你在控制台保存的密钥,按 id 指定。
  4. 什么都没设置工作区的默认已保存密钥。如果没有保存密钥也没有指定模型,任务会在 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。

下一步

给你的助手一个浏览器。

100 个免费积分。无需绑卡,无需订阅。