如何将 Browserless 远程 MCP 连接到 Claude Code
约 1 分钟即可把 Browserless 的远程 MCP 服务端接入 Claude Code。如需排查 OAuth / 401 问题,可先用 OAuth 2.1 调试器体检端点。
🔒 Client-side only — never leaves your browser.
Or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"browserless": {
"url": "https://mcp.browserless.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}claude mcp add --transport http browserless https://mcp.browserless.io/mcp
With credential header:
claude mcp add --transport http browserless https://mcp.browserless.io/mcp --header "Authorization: Bearer YOUR_API_KEY"
Or add to .vscode/mcp.json:
{
"servers": {
"browserless": {
"type": "http",
"url": "https://mcp.browserless.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}- Open Settings → Connectors (Integrations) → Add Custom Connector.
- Paste the endpoint URL:
https://mcp.browserless.io/mcp - Provide your API key / Bearer token when prompted.
Bridge the remote endpoint into stdio with mcp-remote in claude_desktop_config.json:
{
"mcpServers": {
"browserless": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.browserless.io/mcp",
"--header",
"Authorization: Bearer YOUR_API_KEY"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"browserless": {
"serverUrl": "https://mcp.browserless.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Add to ~/.kiro/settings/mcp.json (or .kiro/settings/mcp.json in your workspace), then reopen Kiro's Agent panel to pick up the server:
{
"mcpServers": {
"browserless": {
"url": "https://mcp.browserless.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Add to ~/.codex/config.toml — Codex reads remote HTTP servers from [mcp_servers.*] tables:
[mcp_servers.browserless] url = "https://mcp.browserless.io/mcp" bearer_token_env_var = "BROWSERLESS_TOKEN"
Add to cline_mcp_settings.json (Cline → MCP Servers → Configure), or paste it via Cline's MCP marketplace file:
{
"mcpServers": {
"browserless": {
"type": "streamableHttp",
"url": "https://mcp.browserless.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Add to ~/.gemini/settings.json under mcpServers — httpUrl for Streamable HTTP, url for legacy SSE:
{
"mcpServers": {
"browserless": {
"httpUrl": "https://mcp.browserless.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}接入步骤
- 执行添加命令 — 运行
claude mcp add --transport http browserlesshttps://mcp.browserless.io/mcp``。 - 完成认证 — 在 Browserless 控制台获取凭据,并将其作为
Authorization: Bearer <密钥>请求头加入配置。在 Claude Code 内运行/mcp可触发 OAuth 流程。 - 验证状态 — 运行
claude mcp list应显示已连接。若 OAuth 回调失败,先claude mcp remove browserless再重新添加,并确认浏览器能访问回调地址。在 在线 Inspector 中粘贴https://mcp.browserless.io/mcp并运行 initialize + tools/list 验证连通性。