Bugfender

Name: Bugfender
Author: bugfender

本地服务

github.com数据与分析06 天前更新

代码仓库访问官网

关于 Bugfender

Bugfender MCP 将 Bugfender 数据接入 AI 客户端，用于应用监控和调查。托管服务通过远程 Streamable HTTP 和 OAuth 连接；现有安装及自托管环境仍可使用已弃用的本地 stdio 包。

主要功能

01搜索日志并查看设备与应用元数据
02汇总并检查崩溃和问题
03访问用户反馈与网络数据
04获取 SDK 配置代码片段
05在具备所需写入权限时更新问题状态

适用场景

01调查崩溃及受影响的设备
02查看指定应用的日志
03汇总问题或反馈趋势
04在应用配置时获取 Bugfender SDK 代码片段

MCP 相关

托管 MCP 服务通过 Streamable HTTP 暴露 Bugfender 工具和资源模板，并使用 OAuth 授权。已弃用的本地 stdio 包仍可用于现有安装，包括连接自托管后端。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "bugfender": {
      "command": "npx",
      "args": [
        "-y",
        "@bugfender/mcp"
      ],
      "env": {
        "BUGFENDER_API_TOKEN": "<BUGFENDER_API_TOKEN>",
        "BUGFENDER_REFRESH_TOKEN": "<BUGFENDER_REFRESH_TOKEN>",
        "BUGFENDER_API_URL": "<BUGFENDER_API_URL>"
      }
    }
  }
}

启动命令npx -y @bugfender/mcp

需要配置的环境变量

BUGFENDER_API_TOKEN密钥Bugfender API access token from MCP setup.

BUGFENDER_REFRESH_TOKEN密钥Refresh token for automatic session renewal (recommended).

BUGFENDER_API_URLAPI base URL override; defaults to https://dashboard.bugfender.com/api

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@bugfender/mcp0.6.0stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

Bugfender MCP

Bugfender 托管的 MCP 服务通过远程 Streamable HTTP 和 OAuth 将 AI 客户端连接到 Bugfender：

https://mcp.bugfender.com/mcp

@bugfender/mcp npm 包仍可用，但已弃用，作为现有安装和可自托管安装的本地 stdio 后备方案。

提供的功能

通过 MCP 提供用户范围内的 Bugfender 只读访问
配置刷新令牌后自动刷新访问令牌
日志、设备、应用元数据、崩溃聚合和问题聚合工具
用于应用接入的 SDK 代码片段检索
用于代码片段、日志和问题组的资源模板
随 bugfender/bugfender-skills 分发的配套 Bugfender 技能

维护者

开发工作流：DEVELOPMENT.md
发布和发布流程：RELEASING.md

已弃用：本地 stdio 包

现有安装以及不支持远程 OAuth 的客户端可以继续运行：

npx -y @bugfender/mcp

不要将此设置用于新的公有云连接。请改用托管 URL 或公开插件。

在 IDE 或 Agent 中添加或更新 MCP 服务后，请重启该客户端，以便正确重新加载新的 MCP 配置。

如果你在此代码库的本地检出目录中运行，请勿使用 npx @bugfender/mcp 或 npx -p @bugfender/mcp bugfender-mcp。npm 可能会解析当前软件包，而不是已发布的 tarball，并导致 bugfender-mcp: not found 错误。

如需本地开发，请直接构建并运行生成的入口文件：

pnpm build
pnpm start

本地 stdio 配置

BUGFENDER_API_TOKEN：必需的访问令牌
BUGFENDER_REFRESH_TOKEN：建议配置，用于自动刷新令牌
BUGFENDER_API_URL：可选覆盖项，默认值为 https://dashboard.bugfender.com/api
~/.bugfender/mcp.json：可选配置文件，也是轮换后凭据的本地存储

{
  "default": {
    "apiToken": "YOUR_ACCESS_TOKEN",
    "refreshToken": "YOUR_REFRESH_TOKEN",
    "apiUrl": "https://dashboard.bugfender.com/api"
  }
}

提供刷新令牌后，MCP 会将轮换后的凭据存储在 ~/.bugfender/mcp.json 中，以便自动刷新在重启后仍然有效。使用新生成的刷新令牌更新 IDE 配置会重置此本地状态。

这些凭据和本地令牌存储仅适用于 stdio 可执行文件。托管 HTTP 可执行文件会从每个请求中读取 Bearer 令牌，且不会读取或写入 ~/.bugfender/mcp.json。

如果使用本地或自托管的 Bugfender 凭据，BUGFENDER_API_URL 必须指向相应的后端。例如，从 https://dashboard:3000 生成的本地凭据无法用于 https://dashboard.bugfender.com/api。

旧版 Cursor / Claude Code 配置

{
  "mcpServers": {
    "bugfender": {
      "command": "npx",
      "args": ["-y", "@bugfender/mcp"],
      "env": {
        "BUGFENDER_API_TOKEN": "YOUR_ACCESS_TOKEN",
        "BUGFENDER_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN",
        "BUGFENDER_API_URL": "https://dashboard.bugfender.com/api"
      }
    }
  }
}

旧版 Codex CLI 配置

codex mcp add bugfender \
  --env BUGFENDER_API_TOKEN='YOUR_ACCESS_TOKEN' \
  --env BUGFENDER_REFRESH_TOKEN='YOUR_REFRESH_TOKEN' \
  --env BUGFENDER_API_URL='https://dashboard.bugfender.com/api' \
  -- npx -y @bugfender/mcp

运行 codex mcp add 后，先重启 Codex 会话，再测试 who_am_i 或 list_apps。

旧版 Gemini CLI 配置

gemini mcp add bugfender npx -y @bugfender/mcp \
  --env BUGFENDER_API_TOKEN='YOUR_ACCESS_TOKEN' \
  --env BUGFENDER_REFRESH_TOKEN='YOUR_REFRESH_TOKEN' \
  --env BUGFENDER_API_URL='https://dashboard.bugfender.com/api'

运行 gemini mcp add 后，启动新的 Gemini CLI 会话或重新加载 MCP 服务，再测试 who_am_i 或 list_apps。

旧版 Codex App 配置

在自定义 MCP 服务表单中：

Name：bugfender
Command to launch：npx
Argument 1：-y
Argument 2：@bugfender/mcp
BUGFENDER_API_TOKEN：YOUR_ACCESS_TOKEN
BUGFENDER_REFRESH_TOKEN：YOUR_REFRESH_TOKEN
BUGFENDER_API_URL：https://dashboard.bugfender.com/api

请将各个参数分别添加为单独的行，而不要合并成一个字符串。

保存服务后，先重启应用，再测试 who_am_i 或 list_apps。

托管式 Streamable HTTP 部署

使用以下命令构建并启动 HTTP 入口：

pnpm build
pnpm start:http

它会提供：

POST /mcp：无状态 MCP Streamable HTTP 端点
GET /healthz：存活检查
GET /readyz：就绪检查

TLS 由生产入口负责终止。每个 /mcp 请求都必须包含 Authorization: Bearer <token>。进程会为该请求创建隔离的 MCP 服务和 Bugfender API 客户端；令牌既不会共享，也不会持久化。

托管配置：

BUGFENDER_API_URL（默认值为 https://dashboard.bugfender.com/api）
BUGFENDER_MCP_HOST（默认值为 0.0.0.0）
BUGFENDER_MCP_PORT（默认值为 3002）
BUGFENDER_MCP_MAX_REQUEST_BYTES（默认值为 1048576）
BUGFENDER_MCP_MAX_RESPONSE_BYTES（默认值为 524288）
BUGFENDER_MCP_MAX_CONCURRENCY（默认值为 100）
BUGFENDER_MCP_REQUEST_TIMEOUT_MS（默认值为 35000）
BUGFENDER_MCP_SHUTDOWN_TIMEOUT_MS（默认值为 10000）

托管入口在 Streamable HTTP 协议中使用 JSON 响应模式。它采用无状态设计，因此对 /mcp 的 GET 和 DELETE 请求会返回 405 Method Not Allowed。

可以使用以下命令在本地构建并运行生产容器：

docker build -t bugfender-mcp .
docker run --rm --read-only --tmpfs /tmp:rw,noexec,nosuid,size=16m \
  -p 3002:3002 bugfender-mcp

镜像以 UID/GID 10001 运行，将结构化 JSON 日志写入 stderr，并通过 GET /metrics 暴露 Prometheus 指标，供集群内部抓取。

托管模式通过 GET /.well-known/oauth-protected-resource 发布 OAuth 受保护资源元数据。身份验证质询会将客户端引导至该文档。生产环境默认使用资源 https://mcp.bugfender.com、颁发者 https://app.bugfender.com 和 API https://app.bugfender.com/api；暂存部署必须将 BUGFENDER_MCP_RESOURCE_URL、 BUGFENDER_OAUTH_ISSUER 和 BUGFENDER_API_URL 覆盖为对应的暂存环境源。可以通过 BUGFENDER_MCP_DOCUMENTATION_URL、 BUGFENDER_MCP_PRIVACY_POLICY_URL 和 BUGFENDER_MCP_TERMS_URL 覆盖文档、隐私和条款链接。

托管身份验证故障排除

使用准确的端点 https://mcp.bugfender.com/mcp；OAuth 资源是源站 https://mcp.bugfender.com，不包含 /mcp。
不要为远程托管连接配置 BUGFENDER_API_TOKEN，也不要粘贴 bearer token。
断开连接后重新连接，以恢复已过期或已撤销的授权，或申请不同的作用域。
update_issue_status 需要 mcp:issues:write；调查工具需要 mcp:read。
客户端必须支持远程 Streamable HTTP、OAuth 发现、带 PKCE 的 Authorization Code 和资源指示符。否则，请使用已弃用的本地 stdio 回退方式。
托管 OAuth 目前支持 Bugfender 公有云。自托管部署必须使用本地 stdio，并将 BUGFENDER_API_URL 设置为其后端地址。

工具

who_am_i
list_teams
list_apps
get_app
list_app_versions
get_sdk_snippet
get_crashes
get_crash_stats
get_crash_device_stats
get_crash_details
search_logs
count_logs
count_devices_with_logs
get_network_aggregates
get_network_details
search_devices
count_devices
list_issues
get_issue
update_issue_status
get_issue_stats
get_issue_device_stats
get_issue_devices
get_feedback
get_app_summary

资源

bugfender://snippet/{app_id}/{platform}
bugfender://app/{app_id}/logs?...
bugfender://issue/{issue_id}?app_id={app_id}

配套 Skills

配套 skills 现已移至独立的 bugfender/bugfender-skills 仓库。它们在 MCP 工具之上封装了具有明确主张的工作流：

先聚合，再查看日志
尽早缩小时间范围
深入调查前先评估影响
最后给出简短的分诊摘要

MCP 软件包为 Agent 提供原始 Bugfender 功能。skill 则在这些功能之上增加了具有明确主张的调查工作流。

当你希望 Cursor、Codex 或 Claude Code 执行以下任务时，可以使用该 skill：

帮助在应用中设置 Bugfender SDK，并采用最低限度的必要步骤
获取某个平台的 SDK 代码片段，并准确说明应将其放在何处
调查应用中的主要崩溃
总结某个时间范围内的问题或反馈趋势
比较某个应用版本前后的影响
找出可能的原因、范围和后续检查项

调查 skill 的源代码位于：

https://github.com/bugfender/bugfender-skills/tree/main/skills/bugfender

SDK 设置 Skill

专用的入门 skill 也位于 bugfender/bugfender-skills。

当你希望 Cursor、Codex 或 Claude Code 执行以下任务时，可以使用它：

自动检测项目平台
获取正确的 Bugfender SDK 代码片段
将设置对应到实际的仓库文件
在崩溃报告或 Android logcat 等可选功能需要确认时，提出一个简短的功能问题
应用最低限度的集成更改
将开发者的工作减少到最后一步验证

其中还包含针对以下平台的参考资料：

iOS
Android
Flutter
Unity
.NET MAUI
Cordova
Ionic
Angular
React
Vue
JavaScript
jQuery
Titanium
Web
React Native

skill 的源代码位于：

https://github.com/bugfender/bugfender-skills/tree/main/skills/bugfender-sdk-setup

在 Cursor、Codex 或 Claude Code 中安装 Skills

Cursor、Codex 和 Claude Code 可以直接从 GitHub 安装 skills，无需手动克隆仓库。

在 IDE 内的 Agent 聊天中，使用内置安装器 skill 运行此提示词：

Use $skill-installer to install these skills from https://github.com/bugfender/bugfender-skills:
- skills/bugfender
- skills/bugfender-sdk-setup

安装完成后，重启客户端并使用：

Use $bugfender-sdk-setup to set up Bugfender in this app with the minimum required changes.

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

Bugfender

关于 Bugfender

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

Bugfender MCP

提供的功能

维护者

推荐：托管 OAuth

OAuth 范围

断开连接并撤销

隐私

已弃用：本地 stdio 包

本地 stdio 配置

旧版 Cursor / Claude Code 配置

旧版 Codex CLI 配置

旧版 Gemini CLI 配置

旧版 Codex App 配置

托管式 Streamable HTTP 部署

托管身份验证故障排除

工具

资源

配套 Skills

SDK 设置 Skill

在 Cursor、Codex 或 Claude Code 中安装 Skills

评论

第一次接触 MCP？

Bugfender

关于 Bugfender

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

Bugfender MCP

提供的功能

维护者

推荐：托管 OAuth

OAuth 范围

断开连接并撤销

隐私

已弃用：本地 stdio 包

本地 stdio 配置

旧版 Cursor / Claude Code 配置

旧版 Codex CLI 配置

旧版 Gemini CLI 配置

旧版 Codex App 配置

托管式 Streamable HTTP 部署

托管身份验证故障排除

工具

资源

配套 Skills

SDK 设置 Skill

在 Cursor、Codex 或 Claude Code 中安装 Skills

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？