指南

把 Claude Code 连接到 你的网络流量

一条终端命令,一次浏览器登录。之后 Claude Code 就能读取你手机刚抓到的流量、在隐去密钥的前提下解释登录流程,并对你的设备执行操作——每个工具都受你的角色限制,每个有风险的操作都要经过确认。

Busymate 把整个仪表盘——覆盖设备、抓包流量、设置、规则、导出和手机农场的 454 个工具——作为一个 MCP 服务器暴露在单一主机名上。Claude Code 原生支持基于 HTTP 的 MCP,所以连接只需一条命令。认证是标准的 OAuth 2.1:客户端自行注册,打开你的浏览器,你用平时的 Busymate 账号登录并授权一次,得到的令牌就是每次工具调用所携带的凭证。不需要创建、粘贴或轮换任何 API 密钥。

本指南从头到尾走完连接过程,然后展示最先见效的三类提示词:读取实时信息流、解释一段抓到的 API 流程、对设备执行操作。它还讲了唯一一条能省去一次浏览器往返的维护习惯——服务器更新后重新连接,绝不重新授权。

开始之前

你需要 准备什么

你机器上的 Claude Code、一个 Busymate 账号,以及——为了有东西可问——一台抓过流量的设备。

  • 已安装的 Claude Code,以及一个能运行其命令的终端。

  • 一个能在浏览器里登录的 Busymate 账号——就是仪表盘用的那个。

  • 至少一台有近期流量的已配对设备:iPhone、Android、代理客户端或被抓包的 Chrome。iPhone 指南是最快的路径。

  • 一个具备你打算使用的能力的角色。读取需要查看权限;重发请求或修改设备设置之类的操作需要对你拥有的设备的编辑权限。

分步操作

按顺序 执行

两步连接,一步验证,三步产出价值,一步保持健康。

  1. 01

    在终端里添加服务器

    运行下面的命令。它使用 HTTP 传输和标准端点,把 Busymate 注册为 Claude Code 的远程 MCP 服务器。命令里不需要别的东西——没有令牌、没有头部、没有客户端 ID。工具发现在认证之前就已提供,所以 Claude Code 马上就能列出服务器提供的内容。

    唯一的一条命令
    bash
    # Claude Code — add the server, then authorize in your browser on the first tool call
    claude mcp add --transport http busymate-devtools https://mcp.busymate.dev
  2. 02

    第一次调用工具时在浏览器里授权

    向 Claude Code 提出任何需要工具的请求,OAuth 流程随即启动:客户端向服务器注册,带着 PKCE 挑战在你的浏览器里打开 Busymate 自己的登录页,你登录并授权,浏览器把一次性代码交还给客户端,客户端用它换取访问令牌。Claude Code 确认连接成功。这一切你都不用手动做;登录页只会看到一次。

    这个令牌与仪表盘内置控制台使用的令牌类型相同,它能认证 Busymate 的所有服务,不只是 MCP。你连接的每个客户端都会在你的账号下获得独立的授权——可单独撤销,全部以你唯一的角色行事,全部在审计日志中可见。

  3. 03

    用一个只读问题来验证

    从只读的问题开始。问问哪些设备在线、其中一台最近抓到了什么,或者过去一小时里哪些主机返回了某个状态码。Claude Code 会选择合适的工具,答案来自你的真实数据——设备名、主机、路径、状态——而不是猜测。

    证明连接有效的头两个提示词
    text
    Which of my devices are online right now, and what did the iPhone capture in the last 10 minutes?
    
    Across all my devices, which hosts returned 401 in the last hour?
  4. 04

    让它解释一段抓到的 API 流程

    这正是这个连接存在的意义。说出一个你从手机上抓到的主机——用带点的完整主机名,而不只是品牌名——然后问应用是如何认证的。Claude Code 会读取真实的请求和响应头部与正文,重建流程,并能为你写出可运行的复现代码。抓包流量中的令牌、Cookie 和凭据都会被当作机密,在它返回的所有内容中替换为占位符。

    解释手机刚刚完成的登录流程
    text
    Look at the captured traffic for identity.example.com and tell me exactly how the app authenticates — the endpoint, the headers it needs, and the request body shape. Then write a curl command that reproduces the login call.
  5. 05

    让它执行操作——在确认之后

    会改变状态的工具——重发请求、切换设备的 VPN、把它的流量路由到另一个国家的上游代理、编辑拦截规则——在服务端都需要确认:Claude Code 会展示它即将做什么,并等待你说「是」。一切都以你的身份运行,受你角色的能力和你拥有的设备限制,所以客户端永远做不了比你在仪表盘里能做的更多的事。

    一个操作类提示词——每次写入都会先询问再执行
    text
    Resend the last failed checkout request from my iPhone, then route that phone through a proxy in Germany and confirm its public IP changed.
  6. 06

    与本系列的其他指南搭配

    其他指南手动完成的每件事,在这里都是一句话:要一份今天某主机的 HAR 导出、在登录端点上做一次性的 401 模拟、列出当前的断点模式,或者给农场里的每台手机截图。Claude Code 把话语映射到工具上;同样的角色和确认规则依然适用。

  7. 07

    服务器更新后:重新连接,绝不重新授权

    服务器经常重新部署,新工具不断到来。在部署前连接的客户端可能持有过期的工具列表——某个工具似乎不见了,或者描述已经过时。大多数客户端会自动获取变化,因为服务器会主动通告;如果你的没有,就重启 Claude Code 会话。不要退出登录,也不要删除服务器:你的令牌在部署之后依然有效,而重新授权只会多花一趟浏览器往返。如果哪天你想干净地重新添加,先移除条目再添加——授权仍然保留,所以不会要求你再次登录。

    干净地重新添加会保留你已有的授权
    bash
    claude mcp remove busymate-devtools
    claude mcp add --transport http busymate-devtools https://mcp.busymate.dev

故障排除

可能出现 的问题

下面每一条看起来都像故障,其实都是协议在按规范工作。

  • 在浏览器里打开端点时返回 401

    规范就是这么规定的。裸请求会返回 401 并附带 OAuth 挑战,告诉客户端去哪里找登录流程。MCP 客户端会自动从这个挑战继续;没有任何东西宕机。

  • 浏览器窗口一直没打开

    Claude Code 也会打印授权 URL。把它复制到任意浏览器;这个流程就是普通的网页登录,完成后会把控制权交还给客户端。

  • 工具都列出来了,但每次调用都被拒绝

    工具发现在认证之前提供;调用任何工具都需要 OAuth 授权。完成客户端发起的浏览器授权,或者在令牌被撤销时重新触发,然后重试。

  • 文档里有的某个工具不见了

    部署后的过期工具列表。重启会话,让客户端重新发现工具面。如果仍然缺失,可能是你的角色没有该工具所需的能力。

  • 对一台我能看到的设备的操作被拒绝

    操作仅限于你拥有的设备和你角色的编辑能力。请工作区管理员授予该能力,或者在你自己的设备上执行操作。

常见问题

大家常问 的问题

有没有需要我保存在某处的 API 密钥?

没有。访问权是绑定到你的账号和该客户端的 OAuth 授权。设备丢失时在仪表盘里撤销即可;没有什么需要轮换。

在 Cursor、VS Code 或 Claude Desktop 里也一样能用吗?

能——任何支持 HTTP 传输和带动态客户端注册的 OAuth 2.1 的客户端都连接同一个端点。安装页面为每个客户端都提供了可复制粘贴的配置和一键链接。

它会泄露在我流量里看到的令牌吗?

抓到的凭据在解释和复现片段中都会被隐去,读取受你的角色和设备限制,写入需要确认。原始 HAR 导出应视为敏感内容;智能体的回答则不是。

一条命令, 然后开口问就行

添加服务器,在浏览器里授权一次,把手机抓到的流量交给能解释它的智能体。

Ask your mate