@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