BugMojo

@bugmojo/mcp-server

AI コーディングエージェント — Claude Code、Cursor、VS Code、Claude Desktop — を BugMojo のバグトラッキングに接続する MCP サーバーです。

理由

BugMojo は、ブラウザーからピクセル単位で正確なバグレポートを直接収集します。セッションリプレイ、コンソールログ、ネットワークリクエスト、スクリーンショットが含まれます。この MCP サーバーはそのコンテキストを AI コーディングエージェントに渡します。BugMojo の API キー認証済み REST API を通じて、バグの一覧表示、検索、読み取り、新規登録、ステータス／優先度／担当者の更新、コメントの追加ができます。エージェントは一行の説明だけでなく、収集されたコンテキスト全体を使ってバグを修正します。

すべての機能を利用しますか？ 回帰テストスイート／実行、テストワークフロー、エージェント、セッションリプレイの要約、インラインのコンソール／ネットワークログは、https://www.bugmojo.com/api/mcp にある ホスト型の OAuth 認証済み HTTP エンドポイントで利用できます。詳しくは、以下のすべての機能（OAuth HTTP）をご覧ください。この npm パッケージは、すべてのツールが実際のエンドポイントに対応し（404 が発生しないよう）、意図的にバグ管理に絞った最小構成になっています。

インストール

Node.js 18 以降が必要です。 インストールは不要です。MCP クライアントから npx で実行できます。

npx -y @bugmojo/mcp-server

または、bugmojo-mcp コマンドをグローバルにインストールします。

npm install -g @bugmojo/mcp-server
# or
pnpm add -g @bugmojo/mcp-server
# or
yarn global add @bugmojo/mcp-server

MCP over stdio で通信し、以下の環境変数を読み取ります。

クイックスタート（Claude Code、60 秒）

1. BugMojo ダッシュボードの Settings → API Keys から API キーを生成します（bm_key_ で始まります）。
2. サーバーを登録します。

claude mcp add bugmojo -e BUGMOJO_API_KEY=bm_key_your_key_here -- npx -y @bugmojo/mcp-server

3. Claude に「オープン状態の CRITICAL バグを一覧表示して、最新のものを要約してください」と尋ねます。

設定

変数	必須	説明
BUGMOJO_API_KEY	✅	BugMojo API キーです（bm_key_ で始まります）。ダッシュボードの Settings → API Keys から生成します。
BUGMOJO_API_URL	—	BugMojo インスタンスのベース URL です。デフォルトは https://www.bugmojo.com です。セルフホスト環境またはローカルインスタンス（例：http://localhost:3000）の場合にのみ設定してください。

クライアントの設定

Claude Code

CLI を使う方法（ユーザー単位）：

claude mcp add bugmojo -e BUGMOJO_API_KEY=bm_key_your_key_here -- npx -y @bugmojo/mcp-server

または、プロジェクト全体で使えるように、プロジェクト単位の .mcp.json をリポジトリのルートにチェックインします。

{
  "mcpServers": {
    "bugmojo": {
      "command": "npx",
      "args": ["-y", "@bugmojo/mcp-server"],
      "env": {
        "BUGMOJO_API_KEY": "bm_key_your_key_here"
      }
    }
  }
}

Claude Desktop

claude_desktop_config.json に追加します（Settings → Developer → Edit Config）。

{
  "mcpServers": {
    "bugmojo": {
      "command": "npx",
      "args": ["-y", "@bugmojo/mcp-server"],
      "env": {
        "BUGMOJO_API_KEY": "bm_key_your_key_here"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト単位）：

{
  "mcpServers": {
    "bugmojo": {
      "command": "npx",
      "args": ["-y", "@bugmojo/mcp-server"],
      "env": {
        "BUGMOJO_API_KEY": "bm_key_your_key_here"
      }
    }
  }
}

VS Code（MCP）

.vscode/mcp.json：

{
  "servers": {
    "bugmojo": {
      "command": "npx",
      "args": ["-y", "@bugmojo/mcp-server"],
      "env": {
        "BUGMOJO_API_KEY": "bm_key_your_key_here"
      }
    }
  }
}

その他の MCP クライアント

同じ stdio コマンド npx -y @bugmojo/mcp-server（グローバルにインストール済みの場合は bugmojo-mcp）を指定し、環境変数に BUGMOJO_API_KEY を設定します。セルフホスト環境の場合にのみ BUGMOJO_API_URL を追加してください。

ツール

ツール	機能
list_bugs	プロジェクト、ステータス、優先度、担当者でバグを一覧表示／絞り込みします（ページネーション対応）。
get_bug	バグ 1 件の詳細を取得します。説明、コメント、ラベル、録画／スクリーンショットが含まれます。
search_bugs	バグのタイトルと説明を全文検索します。
create_bug	プロジェクトにバグを作成します（タイトル、説明、優先度、担当者）。書き込み権限付きのキーが必要です。
update_bug	ステータス、優先度、担当者、タイトル、説明を更新します。書き込み権限付きのキーが必要です。
add_comment	バグにコメントを追加します。書き込み権限付きのキーが必要です。

これが npm パッケージの全機能です。6 つのツールがそれぞれ実際の /api/v1/bugs/* エンドポイントに対応しています。

全機能（OAuth HTTP）

回帰テストスイート／実行、テスト（QA）ワークフロー、エージェント、セッションリプレイの要約（summarize_replay）、およびインラインのコンソール／ネットワークログ（get_bug_console_logs、get_bug_network_logs）は、ホスト型のOAuth 2.1認証済みストリーミングエンドポイントから提供されます。このnpmパッケージからは提供されません。HTTPに対応したMCPクライアントを次のエンドポイントに接続してください。

https://www.bugmojo.com/api/mcp

初回はクライアントによってブラウザーでログイン画面が開きます（管理するAPIキーはありません）。任意のクエリパラメーター：?workspace=<slug>を指定すると接続先がワークスペースに紐づき、さらに?mode=adminを指定すると管理ツールも公開されます。

// Claude Code / clients that support remote MCP servers
{
  "mcpServers": {
    "bugmojo": {
      "type": "http",
      "url": "https://www.bugmojo.com/api/mcp"
    }
  }
}

使用例

設定が完了したら、次のようなことをエージェントに依頼できます。

「プロジェクトXの未解決のCRITICALバグを一覧表示して、最新のものを開き、再現手順を要約してください。」

エージェントはlist_bugs（status=OPEN、priority=CRITICAL）を呼び出し、続いてget_bugを呼び出して、BugMojoがブラウザーで記録したセッションリプレイを含む全コンテキストを取得します。

仕組み

このパッケージは、ステートレスな薄型クライアントです。MCPツール呼び出しを、認証済みHTTPSリクエストとしてBugMojo REST API（/api/v1）に変換します。すべてのビジネスロジックとデータはBugMojoのインスタンス内にあり、ローカルには何も保存されません。

トラブルシューティング

「BUGMOJO_API_KEY environment variable is required」 キーがサーバープロセスに渡されていません。MCP設定のenvブロックに指定するか（またはclaude mcp addに-e BUGMOJO_API_KEY=...を渡してください）、シェルでエクスポートした環境変数は、すべてのMCPクライアントに引き継がれるわけではありません。

「BUGMOJO_API_KEY must start with 'bm_key_' prefix」 異なる値（セッショントークンや途中で切れたキーなど）をコピーしています。ダッシュボードのSettings → API Keysでキーを再生成し、bm_key_...文字列全体をコピーしてください。

「Authentication failed ... Check your BUGMOJO_API_KEY」（401） キーが取り消されているか、別のインスタンスのものです。新しいキーを生成してください。セルフホストの場合は、BUGMOJO_API_URLがそのインスタンスを指していることも確認してください。

作成／更新／コメント時の「Permission denied」（403） キーが読み取り専用です。create_bug、update_bug、add_commentには書き込み権限のあるキーが必要です。

「fetch failed」／ECONNREFUSED サーバーがBUGMOJO_API_URLに接続できません。デフォルトはhttps://www.bugmojo.comです。セルフホストまたはローカルのURLを設定した場合は、そのインスタンスが実行中で、接続可能であることを確認してください。

初回実行時にサーバーがすぐに切断される 設定で"args": ["-y", "@bugmojo/mcp-server"]を使用していることを確認してください。-yがないと、npxの初回実行時の「Ok to proceed?」プロンプトによってstdioハンドシェイクが停止します。また、node --versionが18以降であることも確認してください。

関連パッケージ

パッケージ	用途
@bugmojo/widget	フレームワークに依存しない、サイト上のフィードバック＋キャプチャウィジェットのコア
@bugmojo/react	React／Next.js SDK — プロバイダー、エラーバウンダリー、フック
@bugmojo/react-native	React Native＋Expo SDK — 振ってバグを報告
@bugmojo/cli	バグのPlaywright再現パックを取得して、修正をローカルで検証

リンク

• ウェブサイト — https://www.bugmojo.com
• ドキュメントと課題（GitHub） — https://github.com/viveksinra/bugmojo-sdk
• 課題 — https://github.com/viveksinra/bugmojo-sdk/issues
• 変更履歴 — https://github.com/viveksinra/bugmojo-sdk/blob/main/packages/mcp-server/CHANGELOG.md
• Model Context Protocol — https://modelcontextprotocol.io

ライセンス

MIT © Softech Infra