中文
🐛 BugEzy

🐛 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

1️⃣ Install BugEzy
2️⃣ Click the 🐛 icon → sign in with Google
3️⃣ Paste 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.

💡 Tips