Bugfender

Name: Bugfender
Author: bugfender

ローカル

github.comデータ・分析06 日前に更新

リポジトリ公式サイト

Bugfender について

Bugfender MCP は、アプリの監視や調査に使う Bugfender データを AI クライアントに提供します。ホスト型サービスはリモート Streamable HTTP と OAuth を使用し、既存環境やセルフホスト環境向けに非推奨のローカル stdio パッケージも残されています。

主な機能

01ログ検索とデバイス・アプリメタデータの確認
02クラッシュと issue の集計・調査
03ユーザーフィードバックとネットワークデータへのアクセス
04SDK セットアップスニペットの取得
05必要な書き込みスコープでの issue ステータス更新

活用シーン

01クラッシュと影響を受けたデバイスの調査
02指定アプリのログ確認
03issue やフィードバックの傾向の要約
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

推奨：ホスト型 OAuth

ChatGPT または Codex では、公開されている Bugfender プラグインをインストールし、付属の Bugfender アプリに接続してください。互換性のあるリモート MCP クライアントでは、 https://mcp.bugfender.com/mcp を追加し、OAuth 認証を選択してください。

クライアントは保護されたリソースと Bugfender 認可サーバーを検出し、 Bugfender のサインインと同意の画面を開いて、有効期間の短いアクセストークンとリフレッシュトークンを管理します。ホスト型の利用では、API トークンを手動でコピーして接続に貼り付けないでください。

OAuth スコープ

mcp:read は、サインインしているユーザーがすでにアクセスできる ID、チーム、アプリ、SDK メタデータ、ログ、デバイス、クラッシュ、課題、フィードバック、ネットワークデータ、概要への読み取り専用アクセスを許可します。
mcp:issues:write は、update_issue_status のみを許可します。一般的な Bugfender の管理権限やその他の書き込み操作は許可しません。

切断と取り消し

クライアントの Bugfender 切断操作を使って、ホスト型の認可と、そのアクセストークンおよびリフレッシュトークンを取り消してください。クライアントでプラグインと接続が別々に表示される場合は、プラグインをアンインストールする前に接続を切断してください。以後のツール呼び出しでは、新しい OAuth フローを開始する必要があります。

プライバシー

ホスト型 MCP は、リクエストのベアラートークンを Bugfender API に転送し、サインインしているユーザーにアクセスが許可されたデータを返します。ユーザーの認証情報を永続化したり、ツールの結果に含めたりすることはありません。MCP クライアントと AI プロバイダーは、それぞれ独自のプライバシーおよびデータ保持条件に基づいて、ツールの入力を別途処理したり、 Bugfender のデータを返したりする場合があります。Bugfender のプライバシーポリシーおよび利用規約をご覧ください。

非推奨：ローカル stdio パッケージ

既存のインストール環境や、リモート OAuth に対応していないクライアントでは、引き続き次の方法で実行できます。

npx -y @bugfender/mcp

新しいパブリッククラウド接続には、この設定を使用しないでください。代わりにホスト型 URL または公開プラグインを使用してください。

IDE またはエージェントで 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 実行ファイルは各リクエストからベアラートークンを読み取り、 ~/.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 の実行後、who_am_i または list_apps をテストする前に Codex セッションを再起動してください。

レガシー版 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 の実行後、who_am_i または list_apps をテストする前に、新しい Gemini CLI セッションを開始するか、MCP サーバーを再読み込みしてください。

レガシー版 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

引数は、1 つの文字列にまとめず、別々の行として追加してください。

サーバーを保存した後、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 リソースは /mcp を含まないオリジン https://mcp.bugfender.com です。
リモートホスト型の接続では、BUGFENDER_API_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}

コンパニオンスキル

コンパニオンスキルは、現在、独立した bugfender/bugfender-skills リポジトリで管理されています。MCP ツール上に、特定の方針に基づいたワークフローを追加します。

ログの前に集計を使用する
早い段階で時間範囲を絞り込む
詳細な調査の前に影響の大きさを把握する
最後に簡潔なトリアージの概要をまとめる

MCP パッケージは、エージェントに Bugfender の機能をそのまま提供します。スキルは、それらの機能を活用する特定の方針に基づいた調査ワークフローを追加します。

Cursor、Codex、Claude Code に次のような作業をさせたい場合に、このスキルを使用してください。

必要最小限の手順で、アプリに Bugfender SDK をセットアップする
プラットフォーム用の SDK スニペットを取得し、配置場所を正確に説明する
アプリの上位クラッシュを調査する
期間を指定して、Issue やフィードバックの傾向を要約する
アプリのバージョン変更前後の影響を比較する
考えられる原因、範囲、次に確認すべき項目を特定する

調査スキルのソースは次の場所にあります。

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

SDK セットアップスキル

専用のオンボーディングスキルも bugfender/bugfender-skills で管理されています。

Cursor、Codex、Claude Code に次のような作業をさせたい場合に使用してください。

プロジェクトのプラットフォームを自動検出する
適切な Bugfender SDK スニペットを取得する
セットアップ内容を実際のリポジトリ内のファイルに対応付ける
クラッシュレポートや Android logcat など、任意の機能が必要な場合に、短い質問を 1 つ尋ねる
必要最小限の統合変更を適用する
開発者の作業を最後の確認 1 回に減らす

また、次のプラットフォーム固有のリファレンスも含まれています。

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

スキルのソースは次の場所にあります。

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

Cursor、Codex、または Claude Code にスキルをインストールする

Cursor、Codex、Claude Code では、リポジトリを手動でクローンしなくても、GitHub からスキルを直接インストールできます。

IDE 内のエージェントチャットで、組み込みのインストーラースキルを使って次のプロンプトを実行してください。

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 対応

ログインしてコメント

基本情報

作者: bugfender
言語: node
バージョン: 0.6.0
トランスポート: stdio
掲載日: 2026年6月18日
最終更新: 6 日前
公式 Registry: io.github.bugfender/mcp

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。