Getting Started

Introduction

Welcome to Bugzilla MCP Server documentation.

Welcome to Bugzilla MCP Server, a Model Context Protocol (MCP) server that enables secure interaction with Bugzilla instances. This server facilitates communication between AI applications and Bugzilla bug tracking systems through a controlled interface.

Source code: github.com/SanthoshSiddegowda/bugzilla-mcp. Licensed under Apache 2.0.

What is Bugzilla MCP Server?

Bugzilla MCP Server is a secure, production-ready MCP server built with FastMCP that provides a standardized way for AI applications to interact with Bugzilla bug tracking systems. Whether you're using Claude Code, Claude Desktop, Cursor IDE, or Visual Studio Code, this server enables seamless integration with your Bugzilla instance.

Quick Start

Hosted Server: Use the production server at https://bugzilla.fastmcp.app/mcp - no local setup required! Just add it to your MCP client configuration with your Bugzilla API key and instance URL.

Key Features

The Bugzilla MCP Server provides a comprehensive set of features for bug tracking:

  • Query Bug Information: Retrieve details about any bug by ID, compact by default
  • Search Bugs: Quicksearch syntax or structured multi-field filters
  • Manage Comments: Add public or private comments to bugs, and tag them
  • Update and File Bugs: Change status, resolution, assignee, CC and more, or file new bugs
  • Attachments: Read screenshots (as images), logs and patches; attach text or files
  • History and Triage: Change history, dependencies, duplicate chains, batch analysis
  • Read-only by Default: Write tools stay hidden until you turn them on
  • Secure Access: Authentication through HTTP headers with API keys
  • Comprehensive Error Handling: Robust error handling for reliable operation
  • Quicksearch Documentation: Built-in access to Bugzilla's quicksearch syntax documentation
  • URL Generation: Get direct links to bugs and your Bugzilla instance

Available Tools

The server provides 28 MCP tools. See Usage for parameters and examples.

  • Read: bug_info, bug_comments, bug_history, bug_dependencies, duplicate_chain, server_url, bug_url
  • Search: bugs_quicksearch, learn_quicksearch_syntax, bugs_advanced_search
  • Change: update_bug, create_bug, add_comment, tag_comment
  • Attachments: bug_attachments, get_attachment, upload_attachment, plus download_attachments / download_attachment (local server only)
  • Batch and triage: bugs_info, bugs_comments, bugs_analysis_context, classify_bugs_heuristics, analyze_bugs_statistics
  • Users and products: get_user, search_users, list_products, get_product_components

Why Use Bugzilla MCP Server?

  • No Local Setup Required: Use the hosted production server
  • Secure: API key-based authentication with minimal permissions
  • Production Ready: Built with FastMCP for reliability and performance
  • Easy Integration: Works with all major MCP clients
  • Comprehensive: Full access to Bugzilla's bug tracking capabilities

License

Bugzilla MCP Server is open source under the Apache License 2.0. Issues and pull requests are welcome on GitHub.