跳到主要内容

常见问题

1 Key 泄漏了怎么办？​

立即登录对应环境的 MCP电子令牌管理 页面，找到该令牌并点击「废弃」。废弃后该 Key 立即失效，无法再调用 MCP。

然后重新生成新令牌，把客户端 mcp.json 中的 X-CSMCP-API-KEY 更新为新 Key，并重启或刷新 MCP 连接。请不要继续使用已泄漏的旧 Key。

2 令牌过期后如何续期？​

在令牌管理页点击「续期」，选择续期时长（7 天、30 天、90 天或 1 年）。每个令牌最多续期 2 次，单次最长 1 年。

  • 续期成功后，Key 字符串不变，一般无需改 mcp.json
  • 若已达到续期次数上限，请废弃旧令牌并生成新令牌，再更新客户端配置
  • 已废弃的令牌不能续期

3 权限范围是什么？​

API Key 绑定到生成它的 CrashSight 账号，权限与该账号在控制台中的权限一致：

  • 只能查询该账号有权查看的应用（项目）及其中的 Issue、上报和统计数据
  • 不能通过 MCP 访问没有加入、或没有查看权限的项目
  • 国内站 Key 只能访问国内 MCP；国际站 Key 只能访问国际 MCP
  • 个人令牌仅用于您本人的客户端接入，请勿把 Key 分享给他人。需要协作时，应邀请成员加入项目并让对方使用自己的账号生成 Key

若提示没有权限，请先在控制台确认该账号能否打开对应应用；再确认 mcp.json 中的 MCP 地址与 Key 是否属于同一环境。

4 如何在国内 / 国际环境之间切换？​

国内站（crashsight.qq.com）与国际站（crashsight.wetest.net）相互独立：

  1. 在目标环境的控制台重新生成（或使用已有的）API Key
  2. 将 mcp.json 中的 url 改为该环境的 MCP 地址
  3. 将 X-CSMCP-API-KEY 改为该环境生成的 Key
  4. 保存后重启或刷新客户端的 MCP 连接
环境获取 KeyMCP Server
国内https://crashsight.qq.com/account/profile?tag=mcpTokenhttps://crashsight.qq.com/mcp
国际https://crashsight.wetest.net/account/profile?tag=mcpTokenhttps://crashsight.wetest.net/mcp

使用国内 Key 去连接国际 MCP（或相反）会认证失败。

5 客户端连不上或看不到工具？​

请依次检查：

  1. url 是否为 https://crashsight.qq.com/mcp 或 https://crashsight.wetest.net/mcp，且与 Key 所属环境一致
  2. X-CSMCP-API-KEY 是否为完整 Key（以 csk_ 开头），没有多余空格或引号错误
  3. 令牌是否已过期或被废弃
  4. 配置是否写在客户端实际读取的文件中（CodeBuddy 推荐 ~/.codebuddy/.mcp.json）
  5. 保存后是否已重启客户端或刷新 MCP 列表
  6. 本机网络是否可以访问对应 CrashSight 域名

6 查询结果为空或报错？​

  • 先调用 who_am_i 和 get_app_info_list，确认身份和应用列表是否符合预期
  • 确认提问中的应用 ID、平台与时间范围正确；多数检索接口时间跨度不超过 90 天
  • 实时小时类工具只能查询当天数据
  • OOM 数据请使用 query_oom_mmap_crashes，而不是 query_crash_list