通过 MCP 让 Claude Code 直接查询日志
文章演示将 Rudow 的 MCP 服务接入 Claude Code,让编程代理直接搜索日志、聚合数据、查看事件和指标。服务提供 17 个只读工具,使用前需接入日志并配置 MCP 密钥。
AI 深度解读
生产报错后,开发者常常得在日志平台和 Claude Code 之间来回复制内容:先搜一轮,再补上下文,模型追问时继续找。作者提出的改法很直接:通过 MCP,让编码代理自己查询日志。
Rudow 提供日志存储和只读查询能力,Claude Code 负责串联证据、分析代码。作者用一次模拟结账故障展示了这套流程:它能缩短人工搬运信息的路径,但效果仍取决于日志是否充分,以及代理是否交代调查边界。
接上 MCP,还得先把日志送进去
MCP(Model Context Protocol)可以理解为代理调用外部工具的接口。在这里,它连接 Claude Code 与 Rudow,让代理获得搜索、聚合、列出事故和提取指标等 17 个只读工具。
连接命令只有一行:
claude mcp add --transport http rudow https://mcp.rudow.ai/mcp
注意 --transport http:这里连接的是远程 MCP 服务。随后需要提供 MCP key,在 Rudow 的 Settings → Account → MCP keys 创建,前缀为 alogmcp_。
连接成功不代表已经有数据。服务日志还要通过 Node SDK、Python SDK 或 HTTP 接入。原文分别给出了 npm install @rudow/node-logger 和 pip install rudow;Node 侧用 createLogger({ apiKey: process.env.RUDOW_API_KEY }) 初始化。
不使用 SDK,也可以直接提交日志:
curl -X POST https://api.rudow.ai/v1/ingest \
-H "Authorization: Bearer $RUDOW_API_KEY" \
-H "Content-Type: application/json" \
-d '{"entries": [{"message": "POST /charge failed", "level": "error", "source": "payment-service"}]}'
注意 Authorization 使用的写入密钥:它在 Settings → Projects → API keys 创建,前缀为 alog_,与 MCP 查询密钥不同。原文要求将其放进环境变量,不要提交到源码仓库,并称日志会在数秒内出现在 Logs 页。
这里的职责划分很清楚:Rudow 保存并回答日志问题,Claude Code 利用结果继续调查。只读权限限制的是这条日志查询通道,不能据此推断编码代理其他工具的权限。
一次连接池故障,代理查出了什么
作者测试的是模拟结账后端,包括 checkout API、payment service,以及最大 100 个连接的 Postgres 连接池。
故障由 deploy #842 引入:每次支付调用都占用连接 8 秒,连接池逐渐耗尽,结账开始失败。作者向 Claude Code 提问:「今天 checkout 出了什么问题?检查日志。」
代理通过 Rudow 查询后,判断 payment service 在 #842 部署后耗尽数据库连接,回滚到 #841 后恢复。它给出的证据包括:
POST /charge和POST /refund报错,出现timeout acquiring connection from pool (waited 5000ms)和pool exhausted, active=100 idle=0。- 共查到 139 次连接池耗尽错误,从 #842 发布后 47 秒开始,到回滚时停止。
- 连接池达到 100/100,另有 113 个请求等待。
- 警告日志记录了 #842 每个 charge 请求占用连接 8 秒。
这些证据能串成一条相互支持的解释:部署改变连接占用时间,连接池饱和,请求等待并超时;回滚后错误停止。作者称,代理重建的时间线与部署日志一致。
不过,这是一个已知故障原因的模拟案例。原文没有提供真实生产事故中的成功率,也没有比较人工排查、直接粘贴日志与 MCP 查询分别耗时多久。附带的 44 秒真实 Claude 会话演示,也不能当作完整排障耗时的对照数据。
更有用的输出,是结论后面带着调查范围
这次案例还有一个细节:代理主动承认,它只向前读取了有限范围的错误,因此无法确认更早的部署窗口是否也失败过,也没有统计全部失败支付次数。
查到多少证据,就下多大范围的结论。
对于程序员,这比一句笼统的「已经定位问题」更有用。连接池耗尽的错误条数,不等于失败支付总数;回滚后错误停止,也不能证明所有业务影响都已消除。
作者认为,让代理直接查询生产日志会成为未来调试的重要工作方式。这属于趋势判断。案例实际展示的是:在日志已经接入、故障信号明确的情况下,代理可以自行补查证据,减少开发者反复搜索和粘贴的操作。Rudow 不写代码,也不修复缺陷,后续修改仍由编码代理和开发者完成。
我的判断
我赞成把日志查询能力交给代理,尤其是需要连续追问的调查。粘贴日志容易把上下文固定在第一次搜索结果里;代理能继续查询,才有机会检验最初的猜测。
但原文属于产品演示,尚不足以证明 Rudow 比现有日志平台或其他查询接口更有效。作者强调原生 MCP、只读设计、固定价格和硬上限,其中「原生」究竟带来多少实际收益,没有对照数据,这是经验判断与产品主张。
按原文标价,免费 Hobby 档每月包含 200,000 条日志,也开放 MCP;付费档为 Dev $9.99、Pro $29.99、Team $79.99。原文没有交代付费档具体配额,也没解释触及硬上限后的行为,不能只凭价格判断适不适合团队。
只读设计能限制日志侧的修改行为,但日志质量、敏感信息处理和访问范围仍需团队自己确认。若日志里缺少部署记录、服务来源或连接池状态,代理也无法凭空补齐证据。
能拿来做什么
- 如果你维护 Node 后端,可以先选一个服务接入日志,确认错误消息、服务来源和部署记录能否支撑一次完整调查,再决定是否扩大接入范围。
- 在 Claude Code 中提问时,同时要求给出时间范围、证据、统计口径和未确认事项,避免把局部查询结果当作完整事故结论。
- 用一个原因已知的故障做验证,例如连接池耗尽,检查代理能否正确关联部署、报错与恢复时间,并核对它引用的数字。
- 评估替换现有流程前,记录人工搬运日志的实际耗时,再比较代理查询后的效果;原文没有替你完成这项对照。