BugEzy Complete Guide

From install to letting AI fix your bugs — all on one page.

All features → Features　·　Questions → FAQ

Fastest way: copy & paste to your AI

Not technical? Copy the text below to your AI (Claude Desktop / Claude Code / Cursor / Windsurf / VS Code + Cline / Google Antigravity / Gemini CLI) and it will handle it.

Please help me install the BugEzy MCP debugging tool so you can read my bug reports and fix bugs for me.

Steps:
1. Chrome extension: https://chromewebstore.google.com/detail/bugezy/hfnkjlbbpehkflgfbjenfmnmjkdjadcj
2. MCP connection — add this to your MCP config:
{
  "mcpServers": {
    "bugezy": {
      "url": "https://bugezy.dev/mcp"
    }
  }
}

Once installed, whenever I record a bug with BugEzy, you can read my report via MCP (console errors, network issues, voice description, screenshots) and fix it directly.

Full guide: https://bugezy.dev/guide

Or follow the steps below yourself

Quick start in 30 seconds

1Install BugEzy
2Click the icon → sign in with Google
3Paste this into your AI tool MCP settings: https://bugezy.dev/mcp
Then ask your AI: "Read my latest BugEzy report"

Step-by-step (for first-timers)

Step 1: Install the Chrome extension

  1. Open the BugEzy page on the Chrome Web Store
  2. Click "Add to Chrome" → confirm "Add extension" in the popup
  3. Click the puzzle icon at the top right → find BugEzy → click the pin
Go to Chrome Web Store →
Works on Chrome and all Chromium-based browsers (Edge, Brave, Arc, etc.). Pinning keeps the icon on your toolbar for one-click recording.

Step 2: Sign in

  1. Click the BugEzy icon on the toolbar
  2. Click "Sign in with Google" → choose your account to authorize
  3. Your name shown in the popup = signed in

Step 3: Capture your first bug (six modes)

Record
Best for: Fully reproducing the bug
How: Click "Record" → reproduce on the page → describe by voice → click "Stop"
Captures: DOM changes + Console + Network + voice
Rewind 30s
Best for: The bug already happened, too late to record
How: Click "Rewind 30s" → auto-grabs the last 30 seconds
No need to start early — BugEzy records in the background
Screenshot Annotate
Best for: Quickly pointing out an on-screen issue
How: Click "Screenshot" → pen/arrow/box to mark → add a note
Three modes: Full page / visible area / custom region
Keyboard Mode
Best for: Noisy environments (cafés, offices)
How: Enable keyboard mode → voice off → type the description
Live Monitor
Best for: Leaving it on to catch bugs as they appear
How: Enable live monitor → a badge appears bottom-right → turns red with a count on errors
Click the badge to expand the error list
Terminal
Best for: Server-side errors (Node.js, Python, etc.)
How: Run in the terminal npx bugezy-watch -- npm run dev
Auto-captures stderr / throw / crash

Step 4: Edit & upload

  1. The editor opens after you stop recording
  2. Edit the voice text and add extra notes
  3. Click "AI Correct" to fix typos (optional)
  4. Click "AI Summarize" to condense (optional)
  5. Click "Upload" → the report is saved to the cloud

Step 5: Let AI fix it

Option 1: Ask directly in Claude / Cursor / VS Code
"Read my latest BugEzy report and tell me how to fix it"
AI reads the report via MCP → analyzes Console + Network errors → suggests a fix

Option 2: Share the report link
Uploading generates a link — send it to teammates or paste into an issue

MCP connection setup
BugEzy MCP URL (same for all tools):
https://bugezy.dev/mcp
Note: do not open this URL in a browser — it is a protocol endpoint for AI tools. Opening it in a browser just shows an error, which is normal. Set it up in your AI tool per the steps below.
Claude.ai
Settings → Connectors → Add → paste the URL → Connect
Claude Desktop
Edit claude_desktop_config.json, add:
{
  "mcpServers": {
    "bugezy": {
      "url": "https://bugezy.dev/mcp"
    }
  }
}
Cursor
Settings → MCP → Add Server → paste the URL
VS Code
Settings → search MCP → Add Server → paste the URL
Claude Code (terminal)
Run: claude mcp add --transport http bugezy https://bugezy.dev/mcp
Zed
Add context_servers to the config file

🆘 Stuck? Paste this to your AI

Help me set up the BugEzy MCP server.
BugEzy is a Chrome extension for reporting bugs.
MCP URL: https://bugezy.dev/mcp
Tell me how to configure it for the AI tool I am using.

Whether you use Claude, ChatGPT, Cursor or VS Code, your AI can walk you through the setup from this prompt.

Once connected, just ask your AI:
"Read my latest BugEzy report and tell me how to fix it"
The AI will read your bug report automatically via MCP.

Claim MCP30: 30 days free

Once MCP is connected, enter the code MCP30 for 30 days of full access (stacks with BUG10 for 40 days total).

  1. Add the MCP URL to your AI tool as described above
  2. Ask your AI to "read my latest BugEzy report" — it must actually succeed once
  3. Open the BugEzy extension → enter MCP30 in the promo code field
The most common blocker: the MCP URL is missing ?token=
BugEzy has to know who made the call to count it as connected — and that comes from the ?token=… at the end of the URL.
If the URL you copied is just https://bugezy.dev/mcp with nothing after it, your AI can still read reports — but the call will not be attributed to you, and MCP30 will keep saying "please connect MCP first".

How to check:The URLs above are auto-filled with your token once you are signed in. If they are not, first open My Reports (that step carries your sign-in over to this site), then come back here and copy again.
Or copy it straight from the extension → Advanced settings → MCP URL, which always includes the token.

FAQ

Q: MCP30 says "please complete MCP setup first"?
A: BugEzy sees no MCP calls attributed to your account. Nine times out of ten the URL is missing ?token= (see the warning above). Fix it, ask your AI to read a report again, then re-enter the code.

Q: It says "cannot verify MCP usage right now"?
A: That one is on our side, not your setup. Please try again later or email us.

Q: My AI says it cannot find BugEzy after setup?
A: Check the URL is complete (including https://) and reconnect. In Claude, BugEzy should show as connected under Settings → Connectors.

Q: Is Gemini supported?
A: Gemini does not yet expose a general MCP connector. We will update this page as soon as it does.

Tips