DebugBundle

@debugbundle/mcp

ランタイムエラー報告、クラッシュ報告、インシデント対応、エンドポイントのヘルスチェック、デバッグバンドル、プロダクト分析に対応する MCP サーバーです。DebugBundle を使うと、エージェントは API や CLI と同じ管理画面を通じて、顧客向けインシデント、決定論的なバンドル、プロダクト利用の証拠、再現手順、プローブ、アラート、Webhook、プロジェクト、セットアップ状態を調査できます。汎用的なインフラ監視やオブザーバビリティのプラットフォームではなく、本番環境のデバッグインフラです。

インストール

通常の認証済み MCP には、アカウント／プロジェクトの通知設定、 チャネルごとの一時停止／再開、ローカル時刻と IANA タイムゾーンを使った 毎日のメール配信スケジュールが含まれます。これらのツールには、API や CLI と同じ権限とポリシーが適用されます。 ホスト型の読み取り専用カタログと制限付きカタログに変更はありません。詳しくは ツールリファレンスをご覧ください。

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	同じホスト上のアプリ、CLI、IDE
Cursor	npx @debugbundle/mcp を使った MCP 設定	stdio トランスポート
VS Code / GitHub MCP Registry	com.debugbundle/mcp	公式レジストリのメタデータ
OpenClaw / ClawHub	DebugBundle スキルと MCP 設定	ワークフローのガイダンスには公開済みのスキルを使用
CI／ヘッドレスエージェント	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"]
    }
  }
}

ローカルの CLI 認証状態を再利用するには、最初に debugbundle login を実行します。マネージド環境やヘッドレス環境で使用する場合は、サーバー環境に DEBUGBUNDLE_MEMBER_TOKEN を追加します。DEBUGBUNDLE_API_URL は、セルフホスト環境またはデフォルト以外の API ホストを使用する場合にのみ設定してください。

Claude Code Plugin

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 の取得または管理にプロジェクトトークンを使用しないでください。

エージェントにできること

• 公開されているプロジェクトの獲得／アクティベーション定義や集計レポートを、list_analytics_flows と get_analytics_flow_report で読み取れます。オーナー／管理者は、save_analytics_flow と archive_analytics_flow で管理できます。これらの開発者向けツールは、API、CLI、ウェブと同じプロジェクト認可およびフローサービスを使用します。別個のホスト型 OpenAI カタログに変更はありません。

• アクティブなインシデントを一覧表示し、インシデントのコンテキスト全体を取得します。

• 決定論的なデバッグバンドルと再現用アーティファクトを取得します。

• get_usage_summary、get_route_metrics、get_device_breakdown、get_action_metrics、get_funnel_analysis および関連する読み取りツールを使い、分析アーティファクトを待たずに、集計された使用状況、ルート、デバイス／ブラウザー／OS／言語のセグメント、リファラー、アクション、ファネル、ジャーニーパターンを照会します。

• 保持されている匿名化済みのジャーニーサンプル、分析の機会、生成済みの AnalyticsBundle を確認します。また、集計メトリクスだけでは不十分な場合に、範囲を限定した分析アーティファクトをリクエストします。

• プライバシー、保持期間、同意、キャプチャ、承認済みのカスタムディメンションの変更を提案する前に、分析設定を読み取ります。設定を更新するのは、オーナー／管理者の明示的な意図がある場合に限ります。

• 保存済みの分析ファネルを一覧表示します。また、オーナー／管理者のアクセス権があれば、list_saved_analytics_funnels、create_saved_analytics_funnel、update_saved_analytics_funnel、archive_saved_analytics_funnel を使って、再利用可能なファネル定義を作成、更新、アーカイブできます。

• ホスト型のヘルスチェック、プローブ、アラート、ウェブフック、プロジェクト、メンバー、課金、キャプチャポリシー、GitHub 自動化の状態を確認します。

• verify_local、verify_cloud、doctor、smoke、analyze などのツールを使って、ローカルとホスト環境の検証を実行します。

verify_app_event は、実際の SDK を使用したアプリの証明を提供し、CLI の verify cloud --expect-app-event と同等の検証を行います。projectId と、service、traceId、requestId のうち少なくとも 1 つを渡してください。environment、maxAgeMinutes、authFilePath は任意です。既存のインシデント／バンドルを読み取り、合成イベントは送信しません。既存の verify_cloud のスキーマと説明に変更はありません。この新しいツールは、通常の stdio MCP とローカル認証を使う stdio MCP、およびその OpenClaw プロジェクションで利用できます。ホスト型の読み取り専用カタログと制限付きエージェントカタログに変更はありません。

• 検証後にインシデントを解決または再オープンします。

分析に関する質問には、まず直接集計ツールを使用し、範囲を限定した分析に永続的なアーティファクトが必要な場合にのみ AnalyticsBundle を生成してください。この製品は、アクセスごとに 1 つのバンドルを作成することはありません。

トラブルシューティング

症状	確認事項
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
• エージェントのワークフロー：https://debugbundle.com/docs/agent-workflows
• LLM インデックス：https://debugbundle.com/llms.txt
• MCP ツールスキーマ：https://debugbundle.com/schemas/mcp-tools.json
• OpenAI プラグイン候補：https://debugbundle.com/docs/mcp/openai-plugin
• 公式 MCP レジストリのメタデータ：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 ツールプロファイルと制限付きの 5 ツールプロファイルに変更はありません。

test_webhook_event は、既存のスコープ付きテストサービスを通じて、サポートされている 8 種類すべての 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 と診断情報は非公開のままです。新しいチェック項目は非公開のままです。ホスト型の読み取り専用プロファイルと制限付きエージェントプロファイルでは、公開ツールを利用できません。ステータスページガイドをご覧ください。