Configuration

Overview

The Bugzilla MCP Server requires HTTP headers for authentication. You need to configure your MCP client with:

• api_key (Required) - Your Bugzilla API key
• bugzilla_url (Required) - The base URL of your Bugzilla instance

Getting Your API Key

1. Navigate to your Bugzilla instance's API key page:

   https://your-bugzilla-instance.com/userprefs.cgi?tab=apikey
   

2. Generate a new API key if you don't have one
3. Copy the API key (you'll need it for configuration)

Server URLs

• Production (Hosted): https://bugzilla.fastmcp.app/mcp
• Local Development: http://127.0.0.1:8000/mcp

Claude Desktop

Add this configuration to your claude_desktop_config.json:

The location of this file depends on your operating system:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

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

Cursor IDE

Add this configuration to your .cursor/mcp.json:

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

Visual Studio Code

Add this configuration to your mcp.json:

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

Configuration Examples

Example: Bugzilla Mozilla

{
  "mcpServers": {
    "bugzilla": {
      "url": "https://bugzilla.fastmcp.app/mcp",
      "headers": {
        "api_key": "YOUR_MOZILLA_API_KEY",
        "bugzilla_url": "https://bugzilla.mozilla.org"
      }
    }
  }
}

Example: Custom Bugzilla Instance

{
  "mcpServers": {
    "bugzilla": {
      "url": "https://bugzilla.fastmcp.app/mcp",
      "headers": {
        "api_key": "YOUR_CUSTOM_API_KEY",
        "bugzilla_url": "https://bugs.yourcompany.com"
      }
    }
  }
}

Verifying Configuration

After configuring your MCP client:

1. Restart your MCP client (Claude Desktop, Cursor, or VS Code)
2. The Bugzilla MCP Server should appear in your available MCP servers
3. You can test the connection by asking your AI assistant to:
   • Get information about a bug
   • Search for bugs
   • Get the server URL

Troubleshooting

Server Not Connecting

• Verify your API key is correct
• Check that your Bugzilla URL is accessible
• Ensure the server URL is correct (production or local)
• Check your MCP client logs for error messages

Authentication Errors

• Verify your API key has the necessary permissions
• Ensure your Bugzilla instance allows API access
• Check that the API key hasn't expired or been revoked

Local Development Issues

• Make sure the local server is running (python server.py)
• Verify the server is accessible at http://127.0.0.1:8000/mcp
• Check firewall settings if the connection fails

Next Steps

• Learn about usage examples
• Review security best practices