Bugzilla

Bugzilla MCP サーバー

Claude やほかの AI アシスタントが、Bugzilla 5.0 以降の任意のインスタンスでバグを検索、閲覧、トリアージ、更新できる MCP サーバーです。

• お使いのマシンで動作します：Bugzilla API キーが外部に送信されることはありません。
• デフォルトでは読み取り専用です：Bugzilla を変更するツールは、有効にするまでオフのままです。また、update_bug にはドライラン機能があります。
• トリアージ向けに設計されています：一括読み取り、履歴、重複、分類、画像として表示されるスクリーンショットに対応しています。

📖 ドキュメント： bugzilla-mcp.vercel.app

要件

まずはローカルで始めましょう。何もインストールせずに試すには、ホスト型サーバーをお使いください。

	ローカル（推奨）	ホスト型
Bugzilla	REST API が有効な 5.0 以降	同じ。インターネットからアクセス可能であること
API キー	お使いの Bugzilla から取得	同じ
お使いのマシンへのインストール	uv または pipx（Claude Desktop のワンクリックインストールでは不要）	不要
MCP クライアント	stdio サーバーを実行できる任意のクライアント	HTTP トランスポートとカスタムヘッダーに対応する任意のクライアント
API キー	お使いのマシンに保存されます	bugzilla.fastmcp.app を経由します
添付ファイルのダウンロード	はい	いいえ

インストール

Claude Desktop：ワンクリック

1. 最新リリースから bugzilla-mcp.mcpb をダウンロードします。
2. ダブルクリックします（または Settings → Extensions を開いて、そこからインストールします）。
3. Bugzilla の URL と API キーを入力します。Claude にバグを更新させる場合を除き、Read-only にチェックを入れたままにしてください。

Python もターミナルも必要ありません。Claude Desktop は API キーをシークレットとして保存します。

Claude Code

uv を一度インストールしてから、次を実行します。

claude mcp add bugzilla --scope user \
  -e BUGZILLA_URL=https://bugzilla.example.com \
  -e BUGZILLA_API_KEY=your-api-key \
  -- uvx bugzilla-mcp

書き込みツールを有効にするには、bugzilla-mcp の後に --allow-writes を追加します。claude mcp list で確認してください。

Cursor、VS Code、その他の MCP クライアント

{
  "mcpServers": {
    "bugzilla": {
      "command": "uvx",
      "args": ["bugzilla-mcp"],
      "env": {
        "BUGZILLA_URL": "https://bugzilla.example.com",
        "BUGZILLA_API_KEY": "your-api-key"
      }
    }
  }
}

クライアントが uvx を見つけられない場合（デスクトップアプリではシェルの PATH が読み込まれないことがあります）、which uvx で確認できるフルパスを使用してください。

pipx

pipx は、bugzilla-mcp を専用の環境にインストールし、コマンドを PATH に追加します。

brew install pipx && pipx ensurepath   # macOS; see pipx docs for Linux/Windows
pipx install bugzilla-mcp
bugzilla-mcp --help

その後、クライアントコマンドとして uvx bugzilla-mcp の代わりに bugzilla-mcp を使います。

claude mcp add bugzilla --scope user \
  -e BUGZILLA_URL=https://bugzilla.example.com \
  -e BUGZILLA_API_KEY=your-api-key \
  -- bugzilla-mcp

デスクトップアプリが見つけられない場合は、which bugzilla-mcp で確認できるフルパス（通常は ~/.local/bin/bugzilla-mcp）を使用してください。pipx upgrade bugzilla-mcp でアップグレードできます。

Python 3.12 以降が必要です。pipx が "No matching distribution found" と表示する場合は、古い Python が使われています（macOS の python3 は 3.9 です）。pipx install --python python3.12 bugzilla-mcp を実行してください。

オプション

設定	方法	デフォルト
Bugzilla の URL	BUGZILLA_URL	必須
API キー	BUGZILLA_API_KEY（環境変数または .env のみ。フラグでは指定できません）	必須
書き込みツール	--allow-writes または BUGZILLA_READ_ONLY=false	オフ
ツールの削除	BUGZILLA_DISABLED_TOOLS=update_bug,create_bug	なし
複数ユーザー向け HTTP サーバー	bugzilla-mcp --transport http --host 0.0.0.0 --port 8000	stdio

すべてのオプションについては、設定をご覧ください。

API キー

Bugzilla の Preferences → API Keys（https://your-bugzilla/userprefs.cgi?tab=apikey）で作成します。キーにはアカウントと同じ権限が付与されるため、アクセスを制限した専用アカウントを使うのが最も安全です。

ツール

機能別に分類された28個のツールです。完全なリファレンスは使用方法をご覧ください。

グループ	ツール
読み取り	bug_info（デフォルトは簡潔な形式、full / include_fields）、bug_comments、bug_history、bug_dependencies、duplicate_chain、bug_url、server_url
検索	bugs_quicksearch、bugs_advanced_search、learn_quicksearch_syntax
添付ファイル	bug_attachments、get_attachment（画像は画像として、ログとパッチはテキストとして取得）、upload_attachment
一括処理とトリアージ	bugs_info、bugs_comments、bugs_analysis_context、classify_bugs_heuristics、analyze_bugs_statistics
ユーザーと製品	get_user、search_users、list_products、get_product_components
変更（書き込みを有効にするまで無効）	update_bug（dry_run を使用）、create_bug、add_comment、tag_comment
ローカルのみ	download_attachments、download_attachment（ディスクに保存）

各ツールにはMCPヒント（読み取り専用／破壊的操作）が付いているため、クライアントは確認を求めずに読み取りを実行し、変更の前に確認できます。

ホスト型サーバー（FastMCP Cloud）

インストールは不要です。https://bugzilla.fastmcp.app/mcp に接続し、ヘッダーで認証情報を送信してください。

ヘッダー	必須	値
api_key	はい	Bugzilla API キー
bugzilla_url	はい	Bugzilla のベース URL（5.0 以降）
read_only	いいえ	書き込みツールを有効にするには false を指定します（デフォルトは true）

API キーは、Bugzilla に届くまでホスト型サーバーを経由します。まず試すには最適ですが、日常的に使用する場合はローカルにインストールしてください。

Claude Code

claude mcp add --transport http bugzilla https://bugzilla.fastmcp.app/mcp --scope user \
  --header "api_key: your-api-key" \
  --header "bugzilla_url: https://bugzilla.example.com"

Claude Desktop（mcp-remote経由、Node.js が必要です）

{
  "mcpServers": {
    "bugzilla": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://bugzilla.fastmcp.app/mcp",
        "--header", "api_key:your-api-key",
        "--header", "bugzilla_url:https://bugzilla.example.com"
      ]
    }
  }
}

Cursor（.cursor/mcp.json）

{
  "mcpServers": {
    "bugzilla": {
      "url": "https://bugzilla.fastmcp.app/mcp",
      "headers": {
        "api_key": "your-api-key",
        "bugzilla_url": "https://bugzilla.example.com"
      }
    }
  }
}

VS Code（.vscode/mcp.json）

{
  "servers": {
    "bugzilla": {
      "type": "http",
      "url": "https://bugzilla.fastmcp.app/mcp",
      "headers": {
        "api_key": "your-api-key",
        "bugzilla_url": "https://bugzilla.example.com"
      }
    }
  }
}

書き込みツールを有効にするには、ヘッダーに read_only: false を追加してください（mcp-remote の場合は "--header", "read_only:false"）。詳細はホスト型サーバーをご覧ください。

セキュリティ

• サーバーは読み取り専用で起動します。バグの変更を許可するアカウントでのみ書き込みを有効にしてください。
• アクセス権を制限した専用の Bugzilla アカウントを使用し、管理者アカウントは決して使用しないでください。
• キーは X-BUGZILLA-API-KEY ヘッダーで Bugzilla に送信されます。標準の Bugzilla 5.0/5.2 はこのヘッダーを無視するため、その場合は ?api_key= にフォールバックします（非推奨です。クエリ文字列がウェブサーバーのアクセスログに記録されないようにしてください）。

詳細はセキュリティをご覧ください。

開発

git clone https://github.com/SanthoshSiddegowda/bugzilla-mcp.git
cd bugzilla-mcp
uv sync --all-extras
uv run pytest tests
uv run bugzilla-mcp --help

貢献者向けの情報はCLAUDE.mdにあります。GitHub リリースを公開すると、PyPI へのリリース公開と Claude Desktop 拡張機能の添付が自動で行われます。

謝辞

Sai Karthik 氏の mcp-bugzillaに着想を得ています。MCP コミュニティと取り組みを共有してくださり、ありがとうございます。openSUSE のサーバーをお探しですか？ それは別プロジェクトのmcp-bugzillaです。

ライセンス

Apache 2.0