跳到主要内容

CodeBuddy 使用示例

本章以 CodeBuddy 为主说明如何完成联调。Cursor、Claude Desktop 等其他 MCP 兼容客户端的配置字段相同，文末给出简要说明。

请先完成 mcp.json 配置。 打开 mcp.json 配置示例，按您使用的 CrashSight 站点（国内或国际）复制完整 JSON，将 csk_xxx 替换为真实 API Key 后保存。未完成该配置时，CodeBuddy 无法连接 CrashSight MCP。

1 CodeBuddy​

1.1 确认连接​

完成 mcp.json 配置后，重启 CodeBuddy 或刷新 MCP Server 列表。连接成功时，应能看到名为 crashsight 的 Server，并可列出 CrashSight 提供的工具（如 who_am_i、get_app_info_list、advanced_issue_search 等）。

在对话中可以先做一次连通性验证：

  • 「我当前的 CrashSight 账号是谁？」
  • 「列出我有权限的 CrashSight 应用」

客户端会调用 who_am_i、get_app_info_list 等工具。若返回了您的账号信息和应用列表，说明 CodeBuddy 已成功接入 CrashSight MCP。

1.2 常见用法​

连接成功后，可以直接用自然语言查询，例如：

  • 「查看应用 {appId} 最近 7 天未处理的崩溃 Issue」
  • 「这个 Issue 链接里最近一次上报的堆栈是什么？」
  • 「对比昨天和今天该应用的崩溃趋势」

请将 {appId} 换成真实应用 ID。也可以先让助手调用 get_app_info_list 自动查找。工具说明见 工具能力清单。

2 其他 MCP 兼容客户端​

请同样先完成 mcp.json 配置示例。配置结构与 CodeBuddy 相同：mcpServers → Server 名称 → url + headers.X-CSMCP-API-KEY。将 csk_xxx 替换为真实 Key，并选择与 Key 一致的环境 URL。

2.1 Cursor​

将已完成的 mcp.json 配置加入 Cursor 的 MCP 设置。保存后确认 crashsight 已连接。部分 Cursor 版本可不填写 type 字段。

2.2 Claude Desktop​

将已完成的 mcp.json 配置加入 Claude Desktop 的 MCP 配置（mcpServers）。保存后重启 Claude Desktop，确认工具列表中出现 CrashSight 相关工具。

若客户端暂不支持远程 HTTP MCP，请查阅该客户端文档中关于 Streamable HTTP / HTTP MCP 的说明。CrashSight MCP 不提供本地 stdio 进程，请使用 HTTP 方式接入。