MCP 配置
Browserman 为模型上下文协议(MCP)提供原生支持,允许你直接从 Claude 和其他 AI 助手使用浏览器自动化功能。
概述
Browserman MCP 服务器托管在:
https://mcp.browserman.run这个 MCP 服务器提供了与各种社交媒体平台和浏览器自动化任务交互的工具。
支持的 MCP 客户端
Browserman 支持多种 MCP 客户端:
- Claude Code(推荐)- Anthropic 官方 Claude CLI
- Cursor - AI 优先的代码编辑器
- Codex - OpenAI 的代码助手,支持 MCP
- Cline - VS Code 的自主 AI 编码代理
- Continue - 开源 AI 代码助手
- Windsurf - Codeium 的 AI 流程编辑器
- Zed - 高性能代码编辑器
- Claude Desktop - 需要 mcp-remote 包装器
- 以及更多...
TIP
为获得最佳体验,我们推荐使用 Claude Code,它提供了基于 CLI 的简单设置。
快速设置
方式 1:Claude Code(推荐)
Claude Code 提供了最简单的设置,只需一个 CLI 命令:
安装 Claude Code(如果尚未安装):
bashnpm install -g @anthropic-ai/claude-code获取 API 密钥,访问 app.browserman.run:
- 在侧边栏点击 API 密钥
- 点击 + 新建密钥
- 复制你的密钥
添加 Browserman MCP 服务器:
bashclaude mcp add --transport http browserman https://mcp.browserman.run --header "X-API-Key: YOUR_API_KEY_HERE"将
YOUR_API_KEY_HERE替换为你的实际 API 密钥。验证安装:
bashclaude mcp list
完成!现在你可以在 Claude Code 中使用 Browserman 工具了。
方式 2:Cursor
对于 Cursor,将配置添加到 MCP 配置文件:
打开 Cursor MCP 配置:
- Linux/macOS:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- Linux/macOS:
添加此配置:
{
"mcpServers": {
"browserman": {
"url": "https://mcp.browserman.run",
"headers": {
"X-API-Key": "YOUR_API_KEY_HERE"
}
}
}
}将
YOUR_API_KEY_HERE替换为你的实际 API 密钥。重启 Cursor。
方式 3:Codex
对于 OpenAI Codex,在 Codex 配置文件中使用 TOML 格式:
[mcp_servers.browserman]
url = "https://mcp.browserman.run"
http_headers = { "X-API-Key" = "YOUR_API_KEY_HERE" }其他客户端
获取所有支持客户端的详细配置说明,包括 Cline、Continue、Zed、Windsurf、Claude Desktop 等:
- 访问 app.browserman.run/mcp
- 从下拉列表中选择你的 MCP 客户端
- 复制生成的配置
- 按照客户端特定的说明操作
Claude Desktop
Claude Desktop 需要 mcp-remote 包装器来连接 HTTP MCP 服务器。为了更简单的设置,我们推荐使用 Claude Code。
获取 API 密钥
- 访问 app.browserman.run
- 登录或创建账号
- 在侧边栏点击 API 密钥
- 点击 + 新建密钥
- 复制密钥并安全存储
WARNING
将你的 API 密钥视为密码。永远不要将其提交到版本控制或公开分享。
可用工具
配置后,你将可以访问以下 MCP 工具:
账号管理
accounts_list- 列出所有你有访问权限的账号- 按平台过滤以查看特定账号
Twitter/X
twitter_createTweet- 发布新推文twitter_likeTweet- 点赞现有推文twitter_reTweet- 转发推文twitter_replyTweet- 回复推文twitter_quoteTweet- 引用推文并添加评论
雪球
xueqiu_post- 发布内容到雪球平台
东方财富
eastmoney_postWithCode- 在股票页面发表评论
同花顺
tonghuashun_post- 发布文本和图片到同花顺
任务管理
tasks_getStatus- 通过任务 ID 获取任务的状态和结果
使用示例
示例 1:发布推文
在 Claude Desktop 中,你可以简单地说:
"使用我的 jingo 账号发布一条推文:'来自 Browserman 的问候!'"
Claude 将使用适当的参数使用 twitter_createTweet 工具。
示例 2:列出账号
"显示我所有的 Twitter 账号"
Claude 将使用按平台过滤的 accounts_list 工具。
示例 3:复杂工作流
"将相同的消息'看看这个新功能!'发布到我的 Twitter 和雪球账号"
Claude 将协调多个工具调用来完成这个任务。
配置选项
自定义头部
你可以向 MCP 配置添加自定义头部:
{
"mcpServers": {
"browserman": {
"url": "https://mcp.browserman.run",
"headers": {
"Authorization": "Bearer YOUR_API_KEY",
"X-Custom-Header": "value"
}
}
}
}超时设置
大多数 MCP 客户端允许你配置超时设置。对于长时间运行的浏览器自动化任务,你可能想增加超时:
{
"mcpServers": {
"browserman": {
"url": "https://mcp.browserman.run",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
},
"timeout": 300000
}
}
}执行模式
Browserman 支持两种执行模式:
轻量模式(默认)
- 更快的执行
- 更低的资源使用
- 适合大多数任务
完整模式
- 完整的浏览器模拟
- 更好地避免检测
- 推荐用于敏感操作
你可以在工具参数中指定执行模式:
{
"preferredEngine": "full"
}安全最佳实践
- 定期轮换 API 密钥 - 定期生成新的 API 密钥并撤销旧的
- 使用环境变量 - 将 API 密钥存储在环境变量中,而不是配置文件中
- 限制权限 - 为不同用例创建单独的 API 密钥
- 监控使用 - 定期检查控制台中的任务历史
- 启用两步验证 - 使用两步验证保护你的 Browserman 账号
故障排除
查看故障排除指南了解常见问题和解决方案。
