快速配置
选择适合您环境的设置。
最后验证: 2026-06-13
验证环境: Node.js 18+，@browserbasehq/mcp 使用 stdio（Browserbase + Stagehand）
安装命令:
npx -y @browserbasehq/mcp本地配置
JSON 本地配置 json
{
"browserbase": {
"command": "npx",
"args": ["-y", "@browserbasehq/mcp"],
"env": {
"BROWSERBASE_API_KEY": "${BROWSERBASE_API_KEY}",
"BROWSERBASE_PROJECT_ID": "${BROWSERBASE_PROJECT_ID}",
"GEMINI_API_KEY": "${GEMINI_API_KEY}"
}
}
}验证提示词
启动一个会话，打开 https://example.com，返回页面标题与一张截图。
成功时应看到
应看到托管浏览器会话启动，然后返回页面标题与截图引用。
常见陷阱与修复
- ⚠️ 注意: 会话生命周期、凭据处理方式，以及网络出口策略。
- 🔑 始终将 API 密钥存储在环境变量中，切勿硬编码在 JSON 中。
- 🛡️ 如果可用，从只读权限开始，以安全地验证连接。
安全检查
- 把所有密钥（Browserbase 与模型）放在环境变量里，绝不提交到 JSON 配置。
- 托管会话在远端运行；不要把密钥或真实凭据送进自动浏览流程。
常见错误
| 错误 | 原因 | 修复方法 |
|---|---|---|
401 Unauthorized | BROWSERBASE_API_KEY 或 BROWSERBASE_PROJECT_ID 缺失或错误。 | 从 Browserbase 控制台复制两者，并设为环境变量。 |
Model API key error | Stagehand 需要的 LLM 密钥（GEMINI_API_KEY）缺失。 | 添加有效的 GEMINI_API_KEY，或配置 Browserbase 期望的模型提供方。 |
Session limit reached | 当前套餐的并发会话额度已满。 | 关闭空闲会话，或升级 Browserbase 套餐。 |
示例提示词
连接后，尝试这些提示词以测试功能：
- 启动一个新的浏览器会话，访问某 URL，并返回截图与页面标题。
- 从页面中提取关键字段（价格、套餐名、FAQ 标题）并输出 JSON。
- 重复执行同一导航两次，并报告你观察到的任何不稳定元素。