Claude Desktop 接入 Rockxy MCP 服务器 — 3 分钟配置指南

2026 年 4 月 18 日 · 6 分钟阅读

Rockxy 0.9.0 内置了 Model Context Protocol (MCP) 服务器。接入之后，Claude Desktop 可以直接读取你抓到的 HTTP 流量、重放请求、对比两次响应，而不用你把 curl 的输出粘进聊天窗口。本文讲三分钟配置流程，以及 Claude 真正能拿你的流量做什么。

为什么要把 Claude Desktop 接到 HTTP 流量上

HTTP 调试一直是个复制粘贴的问题。你在代理里看到一条失败的请求，复制请求头和请求体，粘到聊天或文档里，再围绕它写一段人类能看懂的问题。上下文切换本身就在吃时间。另一边的 AI 助手也只能看到你恰好粘进去的那部分。

MCP 把这一切倒过来。你不再粘贴，而是直接给 Claude 一个通往代理的通道。Claude 调用 list_flows，挑出需要的流量读取，再拿着真实字节回过头来追问。失败的请求不再是截图，而是一次工具调用——Claude 提出修复方案后，可以直接重放验证。

两边接上之后，整个调试循环被压缩了。你用一句大白话描述看到的现象，Claude 读的是真的请求，不是被你转述过一遍的请求。Claude 提出修复后，可以就地重放修改过的请求去验证。助手和代理在同一页上，这一页就在你的终端里——什么都不会离开你的 Mac。

前置条件

macOS 14 (Sonoma) 或更高。 Rockxy 的 MCP 可执行文件是通用版本 (Apple Silicon + Intel)。
已安装支持 MCP 的 Claude Desktop (2024 年末以后的任意版本均可)。
Rockxy 0.9.0 或更高。 更早的版本不包含 MCP 服务器。
留出五分钟。 实际操作只要三分钟，但首次启动时可能遇到 Gatekeeper 弹窗，留点缓冲时间。

Step 1: 安装 Rockxy

从 rockxy.io/zh/download 下载 DMG，挂载后把 Rockxy.app 拖进 /Applications。启动一次，让 macOS 把这个应用记为受信任。

第一次启动会弹出 Gatekeeper 对话框——Rockxy 已经签名并完成公证，因此对话框应该显示可以打开 Rockxy。如果看到"无法验证"之类的吓人提示，打开 系统设置 → 隐私与安全，滚到"安全"一节，点 仍要打开。

Rockxy 运行起来之后，MCP 可执行文件就在下面这个路径：

/Applications/Rockxy.app/Contents/MacOS/rockxy-mcp

Step 3 会用到这个完整路径，记一下。

Step 2: 在 Rockxy 里启用 MCP 服务器

打开 Rockxy → 设置 → MCP (或者按 Cmd+, 然后切到 MCP 标签)，把 Enable MCP Server 打开。

Rockxy 的 MCP 服务器是按需运行的子进程，由 MCP 客户端拉起。与 Claude Desktop 之间通过 stdio (标准输入输出) 通信，所以 MCP 传输本身并不是一个网络 socket。Rockxy 同时在 loopback 上开放一个可选的本地 HTTP 端口，供不走 stdio 的客户端使用——两条路径都只在 Mac 内部。

MCP 启用之后，Rockxy 暴露四个工具：list_flows、get_flow_detail、replay_request、diff_flows。每个工具都只作用于当前打开的会话文件——你决定让 Claude 看到什么，取决于你打开哪个会话。

简单说一下每个工具。list_flows 支持可选过滤条件 (host、method、status、时间段、条数上限)，返回流量摘要数组。get_flow_detail 接收一个 flow id，返回完整请求 (头、体)、完整响应 (头、体) 和时序分解 (DNS、TCP、TLS、TTFB、传输)。replay_request 接收 flow id 和可选的 override 对象，向原 host 重新执行请求，并返回新的 flow id。diff_flows 接收两个 flow id，返回结构化差异 (path、headers、body 字段)——Claude 不用肉眼比对两段 JSON 就能总结哪里变了。

Step 3: 编辑 claude_desktop_config.json

Claude Desktop 从单一 JSON 文件读取 MCP 配置：

~/Library/Application Support/Claude/claude_desktop_config.json

如果这个文件还不存在，就新建一个。如果已经有别的 MCP 服务器配置，把 Rockxy 这一块加到现有的 mcpServers 对象里。只接 Rockxy 一个服务器的最简配置长这样：

{
  "mcpServers": {
    "rockxy": {
      "command": "/Applications/Rockxy.app/Contents/MacOS/rockxy-mcp",
      "args": []
    }
  }
}

保存文件。现在还不用重载——Claude Desktop 只在启动时读一次配置。

Step 4: 重启 Claude Desktop

用 Cmd+Q 彻底退出 Claude Desktop。只关闭窗口不够——应用还在后台跑，后台进程不会重新读配置。从 Launchpad 或 Spotlight 重新打开。

Claude Desktop 启动时，会把 Rockxy MCP 作为子进程拉起来，通过 stdio 连接，并读取工具清单。聊天界面里会出现一个小插头图标，表示有 MCP 服务器已经挂上了。

Step 5: 验证连接

在 Claude Desktop 里开一个新对话，发送：

列出 Rockxy 抓到的最近 5 条 HTTP 流量。

预期行为：Claude 会用 limit=5 调用 list_flows。聊天里会出现一段工具调用 (通常是折叠的)，里面有原始的输入输出。随后 Claude 用自然语言总结这些流量：method、host、path、status、大小。

如果列表是空的，就先造点流量。打开 Rockxy 的系统代理，随便开个浏览器标签刷新一下，再问一次同样的问题。

故障排查

找不到可执行文件。 如果 Claude Desktop 日志里出现 command not found，或者 MCP 插头始终不亮，检查配置里的路径。正确路径永远是 /Applications/Rockxy.app/Contents/MacOS/rockxy-mcp。如果你把 Rockxy 放在 ~/Applications，相应修改路径。

Rockxy 里没启用 MCP。 如果没在设置里打开开关，MCP 服务器虽然会接受 stdio 连接，但只会返回 mcp_disabled 错误。打开开关，再重启 Claude Desktop。

Claude 看不到工具。 如果插头亮着，Claude 却说"我没有这个工具"，打开 Claude Desktop 的开发者控制台 (较新版本里按 Cmd+Option+I)。典型原因是 claude_desktop_config.json 里有 JSON 解析错误——逗号漏了、尾逗号、从文档里复制过来的智能引号等等。

Claude 能拿你的流量做什么

连上以后，试试下面这些提示词：

"我最近那次打 /api/auth 的请求为啥失败？" — Claude 调用 list_flows，按 host 和 path 过滤，抓出那条 401 的详情，读 WWW-Authenticate 头后解释原因。
"把最近两次 GraphQL mutation 对比一下。" — Claude 列流量、挑出两条 mutation、调 diff_flows，然后总结哪些字段变了。
"把流量 42 重放一次，Authorization 头换成 Bearer eyJ...。" — Claude 带着 override 调用 replay_request，读新的响应，告诉你是不是还 401。
"这个会话里最慢的端点是哪个？" — Claude 遍历流量列表，从每条详情里拉时序数据排序。

MCP 服务器的工具面只有四个，这是故意的。面越窄，模型越容易推理，你也越容易把流量限定在你明确批准的几个操作里。少一些工具，也意味着和用户挂的其他 MCP 服务器重名的可能更低。

有一个行为值得记住：每次工具调用在 Claude Desktop 的聊天里都是一段可折叠的块。展开就能看到模型发出的精确输入和工具返回的精确输出。哪天你怀疑 Claude 是否按你说的做了，打开这块就是答案。这也是调试跑偏的提示词的办法——你能看到模型过滤 list_flows 时用的是不是对的 host，或者传给 get_flow_detail 的 flow id 是不是错的。

下一步

水管搭好之后，真正有意思的在提示词上。Stripe webhook 案例 (英文) 把一次真实的调试会话从头走到尾。首页的 MCP 板块有当前的工具参考。

Rockxy 基于 AGPL-3.0 免费开源。MCP 服务器的源码和应用其他部分在同一个仓库里——接入任何助手之前，你都能读到它究竟暴露了什么。

下载 Rockxy 查看 MCP 工具