bugcatcher-mcp

MCP (Model Context Protocol) server for BugCatcher, exposes bug reports, AI diagnosis, and status management to AI coding tools like Cursor, Claude, and Windsurf.

Installation

npx -y bugcatcher-mcp

Or add to your MCP config (e.g. ~/.cursor/mcp.json):

{
  "mcpServers": {
    "bugcatcher": {
      "command": "npx",
      "args": ["-y", "bugcatcher-mcp"],
      "env": {
        "BUGCATCHER_API_KEY": "your_api_key_here",
        "BUGCATCHER_URL": "https://bugcatcher.app"
      }
    }
  }
}

Important: Use https://bugcatcher.app (without www). The www subdomain redirects and can strip the Authorization header, causing "Missing API key" errors.

Setup

1. Get your API key

Go to your BugCatcher dashboard, open your project settings, and copy the API key (starts with bc_).

2. Configure

• Cursor: ~/.cursor/mcp.json
• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
• Windsurf: MCP settings in the IDE

For local development, set BUGCATCHER_URL to http://localhost:3000.

Note: MCP access requires a paid plan (BUILDER+). In development mode, access is unrestricted.

Available Tools

| Tool | Description | |------|-------------| | list_bugs | List bug reports with filters (status, severity, limit) | | get_bug_detail | Full bug report with AI diagnosis, click trail, telemetry | | get_suggested_fix | Fix context optimized for AI coding | | mark_fixed | Mark a bug as fixed after applying the code change |

Usage Examples

In Cursor, Claude, or Windsurf:

• "Show me all open bugs from BugCatcher"
• "Get details for bug cmxyz123"
• "What's the suggested fix for the latest critical bug?"
• "Mark bug cmxyz123 as fixed"

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | BUGCATCHER_API_KEY | Yes | Your project API key (starts with bc_) | | BUGCATCHER_URL | No | API base URL (default: https://bugcatcher.app). Use without www to avoid redirect stripping auth. |

Troubleshooting

| Error | Cause | Fix | |-------|-------|-----| | Missing API key | BUGCATCHER_URL uses www.bugcatcher.app; redirect strips Authorization header | Use https://bugcatcher.app (no www) | | Invalid API key | Wrong or revoked key | Copy the key from dashboard → project settings | | MCP access requires a paid plan | Free plan | Upgrade at bugcatcher.app/dashboard/upgrade |

Requirements

• Paid plan required (BUILDER or higher). Free plan users will see a 403 error with upgrade instructions.
• In development mode (NODE_ENV=development), MCP access is available regardless of plan.

Links

• npm: bugcatcher-mcp
• MCP Registry: io.github.fDiosc/bugcatcher-mcp
• Source: github.com/fDiosc/bugcatcher

License

MIT