MCP

BetterBugs MCP (Model Context Protocol) enables you to put your BetterBugs report links directly in AI Agents for AI-assisted RCA and super fast debugging sessions.

BetterBugs MCP: Quick Overview

The BetterBugs MCP (Model Context Protocol) enables you to load BetterBugs bug reports (via report links) directly to your preferred AI Agents and developer environments with MCP Client capabilities (such as Cursor, VS Code, and Windsurf).

Once you configure BetterBugs with your MCP Client, all you need is to paste the BetterBugs bug report link(s) along with your prompt and context to debug it.

The AI Agent then accesses the complete bug report (that comes bundled with the details and technical info, including screenshot, console logs, network requests, events, summary, steps to reproduce, and other info).

The result? You get instant root cause analysis of the issue, possible solutions, and other debugging info and steps.

As a developer, you can use the BetterBugs MCP server AI-debugging combined with your manual skills to resolve software issues significantly faster and better.

Prerequisites: What do you need to start using BetterBugs MCP

To start using it, create a bug report using BetterBugs extension and include the report link in your prompt.

Here’re the steps:

Install the BetterBugs Chrome extension.
Open extension and capture the bug using the “Capture Screenshot” option.
Annotate the screenshot to highlight the bug (optional)
In the Summary area at the right, select the BetterBugs Workspace and Project. This is the location within BetterBugs where your report would save once you finish creating the report.
Add bug title and description. Or, just enable the “AI” toggle (as in the demo) to add AI-generated title, summary, and steps to reproduce. The technical details (console logs, env info, network, and others) would auto-attach to the bug report.
Hit “Create Session” button from the top right to create a report.

Okay! Your report is ready to be consumed by the AI Agent through the MCP Client.

How to setup BetterBugs MCP it for your preferred MCP Client

Here, we've provided practical steps to integrate BetterBugs MCP with the following Clients:

Visual Studio Code
Cursor
Windsurf
Google Antigravity
Claude App
Claude Code
Trae IDE
Other MCP Clients

Visual Studio Code

Open VS Code and press CTRL/CMD + P
Search >MCP: Add Server
Select HTTP (HTTP or Server-Sent Events)
Add the following URL: https://mcp.betterbugs.io/mcp
Give the MCP Server a name, such as BetterBugs
The mcp.json file opens instantly with the following code snippet:

{
  "servers": {
    "BetterBugs": {
      "url": "https://mcp.betterbugs.io/mcp",
      "type": "http"
    }
  },
  "inputs": []
}

For first time users, you’d be prompted to authenticate to mcp.betterbugs.io.

From the dialog box, click “Allow” or "Open" to start authentication. Click “Authorize” (from the BetterBugs web page) and you’re good to go!
If the dialog box isn’t auto-displayed, you can click the “Start” text available within your MCP code snippet to start the authentication process.

Or, if it's authenticated instantly (as in the demo), you'd find it "Running" state within your code snippet.

Cursor

OPTION 1: Integrate BetterBugs MCP with Cursor automatically

Use the following link to instantly configure Cursor with BetterBugs MCP: -> Add to Cursor

OPTION 2: Manual Integration Steps

Alternatively, you can configure it manually. Here’re the steps:

Open Cursor and enter CTRL/CMD + P
Search: >View: Open MCP Settings
In the “Tools and MCP” option from the left navigation panel and click “Add Custom MCP”
Paste the following code in the mcp.json file:

{
    "mcpServers": {
      "BetterBugs": {
        "url": "https://mcp.betterbugs.io/mcp"
      }
    }
}

Save the file and open the “Cursor Settings” tab.
From the “BetterBugs” option (should be available under “Installed MCP Servers”), hit “Connect”.
In the Cursor dialog box, hit “Open”.
Finally, hit “Authorize” for successful authorization.

Okay! You’re all set with the MCP config on Cursor. It's as easy as that!

To confirm the BetterBugs MCP config for Cursor, in Cursor Settings > Tools & MCP > Installed MCP Servers, you should see BetterBugs successfully installed with 7 tools enabled

Windsurf

Here're the steps for it:

Open Windsurf, press CTRL /CMD + P
Enter: >Windsurf: MCP Marketplace
In the MCP Marketplace window, click the gear icon on the right. This opens the mcp_config.json file right away.
In the JSON file, add the following code snippet:

{"mcpServers": {"BetterBugs": {"url": "https://mcp.betterbugs.io/mcp"}} }

Save the file. This opens a Windsurf dialog box for authenticating it with BetterBugs. Click “Open”.
Finally, click “Authorize” and you’re good to go!.

The authorization screen opens with the message that it’s successful! Make sure to exit and then reload Windsurf to ensure that changes are implemented correctly.

Google Antigravity

Open Antigravity and press CTRL/CMD + P
Search >Antigravity: Manage MCP Servers
Click View raw config to open mcp_config.json file.
Add the following code snippet in the JSON file and save:

{
  "mcpServers": {
    "betterbugs": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.betterbugs.io/mcp",
        "--transport",
        "http-first"
      ]
    }
  }
}

Open Manage MCP servers tab and click "Refresh".

After authentication, you'd find "betterbugs" as an MCP server, with 7 tools enabled for Antigravity, ready for usage.

Claude Desktop App

NOTE: Make sure you have Node.js (v20 or above) installed on your system.

Steps to integrate BetterBugs MCP with Claude:

Open Claude app and open “Settings” from the left pane.
Next, click “Developer” under Desktop app. Here, you’d find the “Local MCP servers” window to add and manage your MCP servers.
Click “Edit Config”. This’d open your system location with the claude_desktop_config.json file.
Open the JSON file in your text editor, add the following code snippet, and save:

{
  "mcpServers": {
    "betterbugs": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.betterbugs.io/mcp",
        "--transport",
        "http-first"
      ]
    }
  }
}

To apply changes to the claude_desktop_config.json, quit the Claude Desktop app (via the System Tray/Menu Bar) and then re-launch it.

To confirm for successful installation. Go to Settings > Developer > Local MCP servers. You should see “betterbugs” running in the Local MCP servers window.

To double check its available to use, take following steps:

Open a new chat on Claude app.
Hit the “+” icon at the bottom left of the chat area.
Click “Connectors”. You should see betterbugs in the enabled state.

You’re good to go with the integration.

Claude Code

In your terminal, run:

claude mcp add BetterBugs https://mcp.betterbugs.io/mcp -t http -s user

Open Claude

claude

Enter: /mcp . Here, you'd find BetterBugs in disabled state under "Manage MCP servers".

Next, select BetterBugs and enable it for Claude Code.

You're good to go! You should see BetterBugs MCP "connected" to Claude.

Trae IDE

Open the Trae app.
Open the “AI Side Bar” from the top right and click the gear icon for the “AI Management” option
Click the “MCP” tab.
Open the “+ Add” drop down and select “Add Manually”.
Paste the following code snippet in the JSON file and hit “Confirm”.

{
  "mcpServers": {
    "betterbugs": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.betterbugs.io/mcp",
        "--transport",
        "http-first"
      ]
    }
  }
}

Finally, authorize BetterBugs MCP for Trae.

You’re good to go with the BetterBugs MCP config with Trae IDE.

For Other MCP Clients

If you’re using any other MCP clients other than those listed, just add the following code snippet into the mcp JSON file of that client to start using BetterBugs MCP:

{"mcpServers": {"BetterBugs": {"url": "https://mcp.betterbugs.io/mcp"}} }

How to use BetterBugs MCP for AI debugging: Windsurf Example

Once you’re good with the config steps, here’s how to use it:

Create a bug report using BetterBugs and copy the report link.
Paste the BetterBugs report link in your MCP client chat space along with the prompt and context for it.
If required, approve any requests that the AI agent makes to provide more info and context. Continue your debugging session in the chat interface.

BetterBugs MCP: Available tools/properties

Tools/Property Names

Description

getUserDetails

Get authenticated user profile, available workspaces, and account information.

listWorkspaces

Retrieve all workspaces the user has access to, including workspace metadata, permissions, and project counts.

listProjects

List all projects within a specific workspace, including project status, creation dates, and metadata.
Requires a workspace_id parameter.
Pagination support using skip and limit.
Supports up to 50 results per request.
Responses now include total project count and has_more status.

getBugDetails

Fetch comprehensive bug information including title, description, status, priority, reporter, timestamps, and visual evidence (screenshots, screen recordings).
Returns structured bug data with metadata.
Support for retrieving comments and viewers.
Comment pagination controls.
Support for workspace_id and project_id when requesting additional data.

listBugs

Retrieve all bugs for a specific project, including bug summaries, status, priority, and basic metadata.
Pagination support using skip and limit.
Support for viewing archived bugs.
Advanced filtering options including:
- Priority
- Status
- Creator
- Assignees
- Tags
- Integrations
- Creation Source
- Date Range

getScreenshot

Use this to get a screenshot from the CDN.
Requires screenshot_url.
Must be called after getBugDetails.
Essential for enhanced visual analysis.

getBugLogs

Get detailed technical logs for a specific bug including console logs, network requests, user interactions, and step-by-step reproduction data.

shareBug

Share bugs with teammates via email.

updateBugDetails

Update titles, status, priority, tags, assignees, comments, project assignment, and archive status.

recordingLink

Create, manage, and monitor recording links directly through MCP.

basecamp

Manage Basecamp projects, boards, assignees, and submit bugs.

jira

Access Jira projects, issue types, boards, sprints, labels, assignees, and create issues directly from BetterBugs.

managemembersinworkspace

Manage workspace members and roles.

Prompt Example: Using BetterBugs MCP with Cursor

Prompt

Analyze the following report <BetterBugs Report Link> and provide a RCA for it. Suggest fixes and test cases for the issue. Provide the steps to resolve the issue.

BetterBugs Tools and AI Agent

BetterBugs Report link (bundled with Screenshot and other technical details)
BetterBugs MCP
Cursor

Frequently Asked Question (FAQs)

1 - Can I use more than one BetterBugs report link in my prompt?

Yes. You can use more than one bug report link for analysis and troubleshooting the issue. However, we highly recommend using one report link at a time. This allows your AI agent to perform optimally and cohesively for better context analysis.

2 - Can I use the MCP without BetterBugs Chrome Extension?

Yes. All you need is the BetterBugs report link from any of your team members or end-user who uses the extension for creating BetterBugs reports. Same way, to analyze your own BetterBugs report you’d need the extension to create your reports. Else, you can use report links from others.

No. BetterBugs does not auto-share or analyze your MCP data for training purposes. You can check out our AI privacy policies here.

4 - How do the BetterBugs admins control what MCP can access?

BetterBugs MCP works with the exact permissions set for the BetterBugs report link. The MCP has no access to any data that the user (whom the BetterBugs report belongs to) can’t see already.

PreviousAI Debugger NextBetterBugs Feedback Widget

Last updated 1 month ago