能力概述
CrashSight MCP 将 CrashSight 的崩溃分析能力，以 Model Context Protocol（MCP） 标准接口提供给 AI 编程助手。接入后，您可以在 CodeBuddy 等兼容 MCP 的客户端中，用自然语言查询问题（Issue）、异常上报详情、趋势统计和应用信息，而无需在控制台与编辑器之间反复切换。
CrashSight 同时提供 OpenAPI，用于把崩溃数据接入自有系统或脚本。MCP 是另一条访问方式：您用自然语言向 AI 助手提问，由助手代为查询 CrashSight。
1 能做什么
接入 CrashSight MCP 后，客户端可代表当前账号调用以下能力：
- 应用信息：列出当前账号有权限的应用（项目），并按应用 ID 或名称搜索
- 问题（Issue）检索：按版本、异常类型、堆栈关键词、处理状态等条件搜索 Issue，查看小时/日级 Top Issue
- 异常上报详情：查询崩溃、错误、ANR 等上报列表，获取单条上报的堆栈、设备信息与附件（日志、线程堆栈等）
- 趋势数据：查询日级趋势、实时小时统计、小时累计统计，以及指定 Issue 的上报趋势
- 维度排行：按版本、机型、操作系统等维度查看异常设备数或联网设备数排行
- 分享链接查询：通过 CrashSight 匿名分享链接查看上报详情与附件
- 当前用户信息：确认 MCP 当前使用的账号身份
完整工具列表见 工具能力清单。
2 使用前准备
- 已拥有 CrashSight 账号，并对目标应用具备查看权限（与控制台权限一致）
- 已在「个人设置 → MCP电子令牌管理」生成 API Key（电子令牌），详见 获取 API Key
- 已安装兼容 MCP 的客户端。推荐使用 CodeBuddy，也可使用 Cursor、Claude Desktop 等，详见 CodeBuddy 使用示例
3 国内与国际环境
CrashSight 国内站与国际站是两套独立环境，数据、账号和 API Key 互不通用。请按您实际使用的站点选择 MCP Server 地址：
| 环境 | 控制台 | MCP Server |
|---|---|---|
| 国内 | https://crashsight.qq.com | https://crashsight.qq.com/mcp |
| 国际 | https://crashsight.wetest.net | https://crashsight.wetest.net/mcp |
API Key 必须在同一环境的控制台中生成。例如，国内站生成的 Key 只能访问 https://crashsight.qq.com/mcp。
4 接入流程
- 获取 API Key
- 按环境复制 mcp.json 配置，将
csk_xxx替换为真实 Key - 在 CodeBuddy 或其他客户端 中保存配置并确认连接成功
- 在对话中试用，例如：「列出我有权限的 CrashSight 应用」