DebugBundle

@debugbundle/mcp

用于运行时错误报告、崩溃报告、事件响应、端点健康检查、调试包和产品分析的 MCP 服务。DebugBundle 可让 Agent 通过与 API 和命令行相同的管理界面，检查面向客户的事件、确定性调试包、产品使用情况证据、复现步骤、探测、告警、webhook、项目和设置状态。它是生产环境调试基础设施，而不是通用的基础设施监控或可观测性平台。

安装

普通的、经过身份验证的 MCP 包含账户／项目通知偏好设置、 按渠道暂停／恢复，以及使用本地时间和 IANA 时区安排每日电子邮件。这些工具使用与 API 和命令行相同的权限和策略； 托管的只读和受限目录保持不变。请参阅 工具参考。

使用 npm 直接运行 stdio 服务：

npx @debugbundle/mcp

或全局安装：

npm install -g @debugbundle/mcp
debugbundle-mcp

支持的 Node.js 版本：22.x 至 26.x。

MCP 客户端配置

{
  "mcpServers": {
    "debugbundle": {
      "command": "npx",
      "args": ["@debugbundle/mcp"]
    }
  }
}

对于要求以非交互方式执行软件包的客户端，请使用 npx -y @debugbundle/mcp。

安装方式一览

环境	推荐方式	备注
通用本地 MCP 客户端	npx @debugbundle/mcp	stdio 传输
Claude Desktop 本地 MCP	本地 MCP 服务配置	使用本机身份验证／配置
Claude Code 插件	/plugin marketplace add debugbundle/debugbundle	安装捆绑的 MCP 配置和 DebugBundle 技能
Codex 开发者插件	codex plugin add debugbundle-codex@debugbundle	仓库市场；本地 MCP 和工作流技能
Codex 直接 MCP	codex mcp add debugbundle -- npx -y @debugbundle/[email protected] --local-auth	同一主机上的应用、命令行和 IDE
Cursor	使用 npx @debugbundle/mcp 的 MCP 配置	stdio 传输
VS Code / GitHub MCP Registry	com.debugbundle/mcp	官方注册表元数据
OpenClaw / ClawHub	DebugBundle 技能和 MCP 配置	使用已发布的技能获取工作流指导
CI／无头 Agent	DEBUGBUNDLE_MEMBER_TOKEN	切勿使用项目令牌
自托管 DebugBundle	DEBUGBUNDLE_API_URL 加成员身份验证	将服务指向你的 API 基础 URL

此软件包是受支持的公共本地 stdio 方式。独立的 OpenAI Plugin 使用受 OAuth 保护的只读远程端点： https://mcp.debugbundle.com/mcp。其审核／发布流程独立进行， 不会更改此软件包的工具目录或身份验证方式。

本地身份验证配置

MCP 1.9.0 新增了 npx @debugbundle/mcp --local-auth。此可选配置会从工具架构中移除 bearerToken，拒绝每次调用提供的凭据和未知字段，并且仅使用服务启动时通过 CLI／环境设置的成员身份验证。如果身份验证缺失，需要成员令牌的托管工具会在发出 API 请求前报错 mcp_tool_error:auth_state_missing；请在该主机上运行 debugbundle login，或配置服务环境并重新启动连接。无需令牌即可使用仅限本地的检索功能。默认调用会保留旧版架构以及每个工具显式令牌的优先级。

Codex

Codex 可独立于托管的 OpenAI 插件使用现有的 stdio 服务。有关仓库市场、直接配置、身份验证、验证和移除，请参阅 Codex 开发者包和 Codex 设置指南。GitHub 安装功能需要先在默认分支上发布仓库插件；也可以通过本地检出安装来验证候选版本。

Claude Desktop

在 Claude Desktop 中，打开 Settings > Developer，编辑本地 MCP 配置，并添加：

{
  "mcpServers": {
    "debugbundle": {
      "command": "npx",
      "args": ["-y", "@debugbundle/mcp"]
    }
  }
}

请先运行 debugbundle login 以复用本地 CLI 身份验证状态，或者在服务环境中添加 DEBUGBUNDLE_MEMBER_TOKEN，以供托管式／无头模式使用。仅当使用自托管或非默认 API 主机时，才设置 DEBUGBUNDLE_API_URL。

Claude Code 插件

Claude Code 用户可以从此仓库添加 DebugBundle 的第一方市场：

/plugin marketplace add debugbundle/debugbundle
/plugin install debugbundle@debugbundle

插件包位于 apps/mcp/claude-code/debugbundle，并附带 Claude Code 技能。有关插件固定使用的 MCP 版本、直接 MCP 配置、身份验证、验证、更新和移除，请参阅 Claude Code 设置指南。该插件也已按适用于 Claude 社区市场审核的结构构建；在 Anthropic 接受并发布之前，请勿称其已在 claude-community 上架。

身份验证

模式	用途	备注
CLI 身份验证状态	本地开发者计算机	如果 ~/.debugbundle/auth.json 可用，则会复用该文件。
DEBUGBUNDLE_MEMBER_TOKEN	无头模式或由市场管理的客户端	成员令牌用于 CLI/API/MCP 读取和管理操作。
每个工具的 bearerToken	显式高级自动化	仅覆盖本次调用的默认身份验证。
项目令牌	仅用于 SDK 数据导入	请勿将项目令牌用于 MCP 检索或管理。

Agent 能做什么

• 使用 list_analytics_flows 和 get_analytics_flow_report 读取公开的项目获取／激活定义和汇总报告；所有者／管理员可使用 save_analytics_flow 和 archive_analytics_flow 管理这些内容。这些开发者工具使用与 API、CLI 和 Web 相同的项目授权和流程服务。单独托管的 OpenAI 目录保持不变。

• 列出活跃事件并获取完整事件上下文。

• 获取确定性的调试包和复现产物。

• 使用 get_usage_summary、get_route_metrics、get_device_breakdown、get_action_metrics、get_funnel_analysis 及相关读取工具，查询汇总用量、路由、设备／浏览器／操作系统／语言细分、引荐来源、操作、漏斗和旅程模式，无需等待分析产物。

• 检查保留的脱敏旅程样本、分析机会和生成的 AnalyticsBundle；仅当汇总指标不足以满足需求时，才请求范围受限的分析产物。

• 在提出隐私、保留、同意、采集或获批自定义维度变更建议前，先读取分析设置；仅在所有者／管理员明确提出要求时才更新设置。

• 列出已保存的分析漏斗；拥有者／管理员权限的用户可通过 list_saved_analytics_funnels、create_saved_analytics_funnel、update_saved_analytics_funnel 和 archive_saved_analytics_funnel 创建、更新或归档可复用的漏斗定义。

• 检查托管健康检查、探测、警报、Webhook、项目、成员、账单、采集策略和 GitHub 自动化状态。

• 通过 verify_local、verify_cloud、doctor、smoke 和 analyze 等工具运行本地及托管验证。

verify_app_event 可提供由 SDK 驱动的应用实际证据，与 CLI 的 verify cloud --expect-app-event 相匹配。传入 projectId，以及 service、 traceId 或 requestId 中至少一个；environment、maxAgeMinutes 和 authFilePath 为可选参数。它会读取现有事件／调试包，不会发送合成事件。 现有 verify_cloud 架构和说明保持不变。此新工具可通过普通和本地身份验证的 stdio MCP 及其 OpenClaw 投影使用； 托管只读目录和受限 Agent 目录保持不变。

• 验证后解决或重新打开事件。

对于分析问题，优先使用直接汇总工具；仅当范围受限的分析需要持久化产物时，才生成 AnalyticsBundle。该产品不会为每次访问都创建一个调试包。

故障排除

症状	检查
Node.js 启动失败	使用 Node.js 22.x 至 26.x。将客户端配置为使用受支持的 node 或 npx 运行时。
缺少本地身份验证	运行 debugbundle login，或为无头客户端和托管客户端设置 DEBUGBUNDLE_MEMBER_TOKEN。
令牌无效	使用 dbundle_mem_ 成员令牌。项目令牌仅用于 SDK 数据采集。
API 主机错误	对于 DebugBundle Cloud，请保持 DEBUGBUNDLE_API_URL 未设置；仅在使用自托管或非默认 API 主机时设置。
本地仓库尚未初始化	在仅限本地的诊断、本地调试包分析或生成项目技能的工作流之前，运行 debugbundle setup。

链接

• 文档：https://debugbundle.com/docs/mcp
• Agent 工作流：https://debugbundle.com/docs/agent-workflows
• LLM 索引：https://debugbundle.com/llms.txt
• MCP 工具架构：https://debugbundle.com/schemas/mcp-tools.json
• OpenAI Plugin 候选项：https://debugbundle.com/docs/mcp/openai-plugin
• 官方 MCP Registry 元数据：https://github.com/debugbundle/debugbundle/blob/main/apps/mcp/server.json

安全与信任

• 官方 MCP Registry 名称：com.debugbundle/mcp。
• 官方 npm 包：@debugbundle/mcp。
• 源代码仓库：https://github.com/debugbundle/debugbundle/tree/main/apps/mcp
• 许可证：Apache-2.0。
• 服务使用 stdio 传输和本地进程凭据，不包含隐藏的托管管理身份验证。
• 公开示例只能使用占位符；切勿在市场列表中粘贴真实的成员令牌、项目令牌、Webhook 密钥或客户配置。

许可证

Apache-2.0。

disconnect_github_installation 调用现有的组织级断开连接路由。它要求当前组织的所有者执行操作，并会移除该组织所有项目的仓库分配，包括降级后的清理。它不会卸载 GitHub 上的 App。安装/重新连接使用仪表板浏览器流程，以保留已签名的状态 Cookie。普通/本地身份验证目录现包含 134 个工具；托管版的 23 工具配置和受限的五工具配置保持不变。

test_webhook_event 通过现有的作用域测试服务接受全部八种受支持的 Webhook 事件。旧版 test_webhook 架构仅用于验证。两者都会将签名的合成信封加入队列，而不会创建真实事件或数据包。

公共状态页

get_public_status_page、list_public_status_page_options、 save_public_status_page 和 preview_public_status_page 使用与 Project Health 相同的 API 管理由所有者控制的发布。读取选项，明确选择检查项，并保存 {title, enabled, projects:[{project_id, check_ids}]}。使用 enabled: false 保存会取消发布，但不会更改 URL。仅在所有者指示时发布：所选项目/检查项名称和汇总可用性将公开；URL 和诊断信息仍为私有。新检查项仍为私有。托管只读配置和受限 Agent 配置不提供发布工具。请参阅状态页指南。