日志与诊断

当你遇到“服务显示正常但客户端还是报错”“工具列表看起来没问题但实际调用失败”这类情况时，日志页通常是最直接的定位入口。

它的重要性在于：大多数 AI 客户端并不会把 MCP 的真实调用过程完整展示给你。没有日志和诊断，你只能猜。

MCP2Skill 之所以把日志做成独立能力，就是为了补齐这个盲区。

日志页包含哪两类信息

当前版本主要分为两类：

• 调用日志
• 服务日志

两者用途不同，建议结合使用。

这页最适合回答什么问题

• 配置改完后到底有没有生效
• 某次失败是客户端问题、服务问题还是授权问题
• 某个 MCP 最近是不是持续不稳定
• 是谁在调用、什么时候开始出错、错误是否反复出现

调用日志

调用日志更适合回答：

• 哪次调用失败了
• 失败发生在什么时间
• 是哪个服务、哪个工作区或哪个客户端触发的
• 请求与响应大概是什么样子

如果你刚做完一次客户端接入验证，优先看这里。

服务日志

服务日志更适合回答：

• 后端最近输出了什么
• 某个错误是不是反复出现
• 启动、连接、鉴权、清理等后台动作是否正常

排查远程连接、服务启动或 API Key 问题时，服务日志通常很有价值。

调用日志里建议重点看什么

选中一条调用后，优先关注：

• 调用是否成功
• 目标服务或工作区是谁
• 响应时间是否异常
• 是否有明确错误提示

如果一眼就能看出是鉴权或连接问题，再回头到对应服务详情页或设置页处理，会比盲目重试更高效。

服务日志里建议怎么搜

如果日志很多，建议直接按关键词搜索，例如：

• 服务名称
• error
• oauth
• gateway
• unauthorized

这样能更快缩小范围。

下载和清理日志

当前版本支持：

• 下载当前日志文件
• 清空服务日志
• 在设置中控制调用日志保留数量
• 在数据管理页清空所有日志

正式排障前，如果你准备把日志交给别人分析，先下载一份再清理会更稳妥。

一条常用排障路径

当你发现客户端报错时，建议按下面顺序处理：

1. 在日志页查看最近的调用记录
2. 进入失败详情确认报错方向
3. 切换到服务日志搜索相关关键词
4. 回到对应的服务、工作区或设置页修正配置
5. 再做一次实际调用验证

什么时候看工作区日志，什么时候看全局日志

• 想看某个具体工作区最近发生了什么：去该工作区详情页的日志标签
• 想全局排查：直接看日志主页面

两种入口并不冲突，可以配合使用。

相关章节

• 想看总体趋势：看 仪表盘与统计
• 想调日志保留策略：看 常规与 MCP 设置
• 想查看常见故障场景：看 常见问题与故障排查