MCP · 安装

连接你的 AI 代理

粘贴一次 mcp.busymate.dev。454 个工具。无需 API 密钥。

一次点击,或一次粘贴

Pick your client

Cursor 和 VS Code 一键完成。其余客户端粘贴同一个 URL,首次使用时授权。

Claude Code

在终端里添加服务器。首次工具调用会打开浏览器完成授权。

  1. 01

    在终端中运行下面的命令——默认只会添加到当前项目;加上 --scope user 即可在你的所有项目中使用。

  2. 02

    首次调用工具时会打开浏览器让你登录并授权——批准后,Claude Code 会确认连接成功。

终端
bash
# Claude Code — add the server, then authorize in your browser:
claude mcp add --transport http busymate-devtools https://mcp.busymate.dev

验证:运行 claude mcp list(或在 Claude Code 中输入 /mcp)——busymate-devtools 会显示为已连接,全部 454 个工具即可调用。

Claude.ai & Claude Desktop

Settings → Connectors → Add custom connector,粘贴 URL,点击 Connect,在浏览器里授权。无需编辑任何文件。

  1. 01

    打开设置 → 连接器,点击 + 并选择添加自定义连接器

  2. 02

    将下面的 URL 粘贴为远程服务器 URL,然后点击Add——OAuth Client ID/Secret 字段留空即可,Busymate 不需要它们。

  3. 03

    Claude 会打开浏览器让你登录——批准后,连接器会显示为已连接。

连接器 URL
text
https://mcp.busymate.dev

验证:再次打开连接器——它会列出全部 454 个工具,Claude 可以在对话中随时调用它们。

Cursor
添加到 Cursor

一键添加并通过 OAuth 授权。也可手动加到 ~/.cursor/mcp.json(全局)或项目的 .cursor/mcp.json

  1. 01

    点击Add to Cursor即可一键安装,或手动将下面的代码块添加到 ~/.cursor/mcp.json(全局)或某个项目的 .cursor/mcp.json 中。

  2. 02

    打开Cursor Settings → MCP,如果尚未启用,请启用该服务器。

  3. 03

    首次调用工具时会打开浏览器进行授权——Cursor 会自行完成整个 OAuth 握手,因此无需粘贴任何 client ID 或密钥。

~/.cursor/mcp.json (or .cursor/mcp.json in a project)
json
{
  "mcpServers": {
    "busymate-devtools": {
      "url": "https://mcp.busymate.dev"
    }
  }
}

验证:在 Cursor Settings → MCP 中,busymate-devtools 会显示为已启用,旁边会标出工具数量。

VS Code (Copilot)
在 VS Code 中安装

一键安装到 VS Code。也可手动加到工作区的 .vscode/mcp.json(根键为 servers):

  1. 01

    点击Install in VS Code即可一键安装,或将下面的代码块添加到工作区的 .vscode/mcp.json——也可以运行MCP: Open User Configuration,让它对所有工作区都生效。

  2. 02

    VS Code 第一次会询问是否信任该服务器——同意后,点击条目上方 code lens 中的Start(或在命令面板中运行MCP: List Servers)。

  3. 03

    VS Code 会打开浏览器进行 OAuth 握手——登录并批准即可。

.vscode/mcp.json (root key: servers)
json
{
  "servers": {
    "busymate-devtools": {
      "type": "http",
      "url": "https://mcp.busymate.dev"
    }
  }
}

验证:在命令面板中运行MCP: List Servers——busymate-devtools 会显示为Running,并列出全部 454 个工具。

ChatGPT

在提供开发者模式连接器的地方:Settings → Connectors → Add,粘贴 URL 并授权。可用性因套餐而异。

  1. 01

    开启开发者模式连接器——在 ChatGPT 设置中搜索Developer modeConnectors(该菜单的确切位置以前变动过;需要 Plus、Pro 或 Business 及以上套餐,且工作区管理员可以限制此功能)。

  2. 02

    添加一个自定义连接器,并粘贴下面的 URL。

  3. 03

    在打开的浏览器标签页中完成授权。

连接器 URL
text
https://mcp.busymate.dev

验证:连接器会显示为已连接。让 ChatGPT 使用某个 Busymate DevTools 工具,它应该能够正常调用而不出错。

其他任意 MCP 客户端

Streamable-HTTP 传输是标准的——Continue、Cline、Zed 或你自己的机器人都用同一份配置。把它指向这个 URL:

  1. 01

    确认你的客户端支持 Streamable HTTP 传输方式(不仅是 stdio),并支持带有 Dynamic Client Registration 的 OAuth 2.1——大多数现代客户端都支持。

  2. 02

    按照你的客户端所需的配置格式,指向下面的 URL——该代码块采用大多数客户端可直接读取的通用 mcpServers 结构。

  3. 03

    首次使用时在浏览器提示中完成授权,与上面每个客户端一样。

mcp.json
json
{
  "mcpServers": {
    "busymate-devtools": {
      "url": "https://mcp.busymate.dev"
    }
  }
}

验证:授权完成后,调用 tools/list 即可返回全部 454 个工具。

The handshake

What happens on first connect

The whole OAuth 2.1 flow, demystified — four steps, all standard, no console to visit first.

  1. 01

    Your client registers itself

    Dynamic Client Registration (RFC 7591): the client POSTs its own metadata and receives a client id. There's nothing to create in a console first.

  2. 02

    You authorize in the browser

    A browser window opens on Busymate's own sign-in. You approve once; PKCE protects the code exchange end to end.

  3. 03

    Tools appear

    The client lists the tools and your agent starts calling them — as you, scoped to your role, with destructive tools confirm-gated.

  4. 04

    The token keeps working

    Refresh rotation keeps the grant alive, and the same token also authenticates REST, WebSockets and Edge Functions. Revoke it any time — every call it made is in your audit trail.

它如何保持安全

Your account, your rules

访问采用带动态客户端注册和 PKCE 的 OAuth 2.1——没有粘贴的密钥,没有共享秘钥。代理拿到的唯一令牌可认证所有 Busymate 界面(MCP、REST、WebSockets、Edge Functions),且受限于你自己的角色:代理只能做你在仪表盘里能做的事。

  • RBAC 范围控制
  • 需确认
  • 密钥已脱敏

OAuth 2.1,无密钥

动态客户端注册(RFC 7591)+ PKCE(S256)+ 刷新令牌轮换。用户在浏览器里通过 Busymate 登录授权——没有可粘贴或可泄露的 API 密钥。

受限于你的角色

每次调用都由数据库本身授权(RBAC)。破坏性工具要求显式确认,秘钥值从不返回——只写且脱敏。

全程审计记录

每次工具调用——每个代理、每个动作——都进入你账号的审计日志,你随时能看到代理以你的名义做了什么。

阅读更多: 隐私条款RBAC 与审计日志模型

全部 454 个工具

What your agent can drive

人能在 UI 里做的,代理就能通过 MCP 做。

抓取并检查流量

搜索、检查、标记、导出(HAR)、汇总和删除抓到的请求与响应——按设备,或跨整支船队。

控制设备

列出、重命名、解绑、开关 VPN、设置连接类型,或让设备的出口流量经由上游代理。

驱动远程浏览器

原始 Chrome DevTools 协议透传——对已连接设备的 Chrome 打开页面、求值、截屏、拍快照。

自动化手机农场

Android 和 iOS 设备农场自动化——点击、输入、滑动、安装与应用生命周期管理,附实时镜像。

脚本化与塑造请求

沙箱请求/响应脚本、自动拦截规则、断点和暂停域名——在飞行中修改或合成流量。

运营整个平台

角色与权限(RBAC)、TestFlight 测试管理、计费、可查询的审计日志、通知、待办、工作区以及 BusyBro 团队记忆。

Troubleshooting

If something looks stuck

The answers below cover every first-connect snag we've actually seen — most are the protocol working as designed.

The endpoint answers 401 in my browser — is it down?

No — that's the spec working. A bare GET on mcp.busymate.dev returns 401 with the OAuth challenge, because the URL is the OAuth resource identifier your client reads to find the sign-in flow. MCP clients proceed from that challenge automatically.

My client lists the tools but every call fails.

Tool discovery is served before authentication; calling anything requires OAuth. Finish the browser authorization your client started (or trigger it again if the token was revoked), then retry the call.

The browser window never opened.

Most clients also print the authorization URL — copy it into any browser. The flow is a normal web sign-in and hands control back to the client when it finishes.

Should I use mcp.busymate.dev or mcp.busymate.net?

Use mcp.busymate.dev for new configs. The older mcp.busymate.net serves the same server permanently and OAuth issues host-matched metadata on whichever host you connected to — existing setups never break.

Claude Code says the server already exists.

Remove the old entry first — claude mcp remove busymate-devtools — then add it again. Your OAuth grant survives; you won't have to re-authorize.

Do I need separate credentials for a bot and my editor?

No. Each client registers itself and gets its own OAuth grant against your account — individually revocable, all acting under your one role, all visible in the audit trail.

Connect in under a minute

添加 mcp.busymate.dev,授权一次,即可调用 454 个工具中的任意一个。

Ask your mate