Skip to content

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 命令:

  1. 安装 Claude Code(如果尚未安装):

    bash
    npm install -g @anthropic-ai/claude-code
  2. 获取 API 密钥,访问 app.browserman.run

    • 在侧边栏点击 API 密钥
    • 点击 + 新建密钥
    • 复制你的密钥
  3. 添加 Browserman MCP 服务器

    bash
    claude mcp add --transport http browserman https://mcp.browserman.run --header "X-API-Key: YOUR_API_KEY_HERE"

    YOUR_API_KEY_HERE 替换为你的实际 API 密钥。

  4. 验证安装

    bash
    claude mcp list

完成!现在你可以在 Claude Code 中使用 Browserman 工具了。

方式 2:Cursor

对于 Cursor,将配置添加到 MCP 配置文件:

  1. 打开 Cursor MCP 配置

    • Linux/macOS: ~/.cursor/mcp.json
    • Windows: %USERPROFILE%\.cursor\mcp.json
  2. 添加此配置

json
{
  "mcpServers": {
    "browserman": {
      "url": "https://mcp.browserman.run",
      "headers": {
        "X-API-Key": "YOUR_API_KEY_HERE"
      }
    }
  }
}
  1. YOUR_API_KEY_HERE 替换为你的实际 API 密钥。

  2. 重启 Cursor。

方式 3:Codex

对于 OpenAI Codex,在 Codex 配置文件中使用 TOML 格式:

toml
[mcp_servers.browserman]
url = "https://mcp.browserman.run"
http_headers = { "X-API-Key" = "YOUR_API_KEY_HERE" }

其他客户端

获取所有支持客户端的详细配置说明,包括 Cline、Continue、Zed、Windsurf、Claude Desktop 等:

  1. 访问 app.browserman.run/mcp
  2. 从下拉列表中选择你的 MCP 客户端
  3. 复制生成的配置
  4. 按照客户端特定的说明操作

Claude Desktop

Claude Desktop 需要 mcp-remote 包装器来连接 HTTP MCP 服务器。为了更简单的设置,我们推荐使用 Claude Code。

获取 API 密钥

  1. 访问 app.browserman.run
  2. 登录或创建账号
  3. 在侧边栏点击 API 密钥
  4. 点击 + 新建密钥
  5. 复制密钥并安全存储

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 配置添加自定义头部:

json
{
  "mcpServers": {
    "browserman": {
      "url": "https://mcp.browserman.run",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "X-Custom-Header": "value"
      }
    }
  }
}

超时设置

大多数 MCP 客户端允许你配置超时设置。对于长时间运行的浏览器自动化任务,你可能想增加超时:

json
{
  "mcpServers": {
    "browserman": {
      "url": "https://mcp.browserman.run",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      },
      "timeout": 300000
    }
  }
}

执行模式

Browserman 支持两种执行模式:

轻量模式(默认)

  • 更快的执行
  • 更低的资源使用
  • 适合大多数任务

完整模式

  • 完整的浏览器模拟
  • 更好地避免检测
  • 推荐用于敏感操作

你可以在工具参数中指定执行模式:

json
{
  "preferredEngine": "full"
}

安全最佳实践

  1. 定期轮换 API 密钥 - 定期生成新的 API 密钥并撤销旧的
  2. 使用环境变量 - 将 API 密钥存储在环境变量中,而不是配置文件中
  3. 限制权限 - 为不同用例创建单独的 API 密钥
  4. 监控使用 - 定期检查控制台中的任务历史
  5. 启用两步验证 - 使用两步验证保护你的 Browserman 账号

故障排除

查看故障排除指南了解常见问题和解决方案。

下一步