@rubyjobs-jp/bugoon-mcp-server

Bugoon の MCP (Model Context Protocol) サーバー。

AI コーディングツール（Claude Code, Cursor）から Bugoon のバグレポートを直接取得・更新できます。

セットアップ

1. シークレットキーを取得

Bugoon ダッシュボード > プロジェクト設定 > シークレットキーをコピー

2. IDE に設定

Claude Code

.claude/settings.json:

{
  "mcpServers": {
    "bugoon": {
      "command": "npx",
      "args": ["-y", "@rubyjobs-jp/bugoon-mcp-server"],
      "env": {
        "BUGOON_API_URL": "https://bugoon.com",
        "BUGOON_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

Cursor

.cursor/mcp.json:

{
  "mcpServers": {
    "bugoon": {
      "command": "npx",
      "args": ["-y", "@rubyjobs-jp/bugoon-mcp-server"],
      "env": {
        "BUGOON_API_URL": "https://bugoon.com",
        "BUGOON_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

ローカル開発環境

{
  "BUGOON_API_URL": "http://localhost:3100",
  "BUGOON_SECRET_KEY": "your-local-secret-key"
}

環境変数

| 変数 | 必須 | 説明 | |------|------|------| | BUGOON_API_URL | Yes | Bugoon API の URL | | BUGOON_SECRET_KEY | Yes | プロジェクトのシークレットキー | | BUGOON_FIREBASE_BUCKET | No | Firebase Storage バケット名（スクリーンショット URL 構築用） |

MCP Tools

| Tool | 説明 | |------|------| | get_project | プロジェクト情報を取得（接続確認） | | list_bug_reports | バグレポート一覧（status, severity でフィルタ可能） | | get_bug_report | バグレポートの全詳細を取得 | | get_screenshot_url | スクリーンショットの URL を取得 | | update_bug_report_status | ステータス・タイトル・説明・深刻度を更新 |

MCP Prompts

| Prompt | 説明 | |--------|------| | fix_bug | バグ詳細を取得し、修正用のコンテキストとして整形 | | triage_bug | バグを分析し、重要度・原因を評価 |

使用例

Claude Code で:

# バグ一覧を確認
「未対応のバグレポートを表示して」

# 特定のバグを修正
「バグレポート #42 を修正して」

# ステータスを更新
「バグレポート #42 のステータスを in_progress に変更して」

開発

npm install
npm run build
npm start

ライセンス

MIT