BugEzy 完整指南

从安装到让 AI 帮你修 Bug，一页搞定。

完整功能说明 → 功能说明　·　常见问题 → FAQ

最快的方式：复制贴给你的 AI

不懂技术？把下面这段复制贴给你的 AI（Claude Desktop / Claude Code / Cursor / Windsurf / VS Code + Cline / Google Antigravity / Gemini CLI），它会帮你搞定。

请帮我安装 BugEzy MCP 除错工具，让你可以直接读取我的 Bug 报告来帮我修 Bug。

安装步骤：
1. Chrome 扩展程序：https://chromewebstore.google.com/detail/bugezy/hfnkjlbbpehkflgfbjenfmnmjkdjadcj
2. MCP 连线设置，在你的 MCP config 加入：
{
  "mcpServers": {
    "bugezy": {
      "url": "https://bugezy.dev/mcp"
    }
  }
}

安装完成后，我只要用 BugEzy 录制 Bug，你就能透过 MCP 读取我的报告（Console 错误、Network 问题、语音描述、截图），直接帮我修。

详细教学：https://bugezy.dev/guide

或依下方步骤自己来

30 秒快速开始

1安装 BugEzy
2点 图示 → Google 登入
3在你的 AI 工具 MCP 设置贴上： https://bugezy.dev/mcp
然后问 AI：「读我最新的 BugEzy 报告」

详细步骤（给新手，一步一步操作）

第一步：安装 Chrome 扩展程序

  1. 前往 Chrome Web Store 的 BugEzy 页面
  2. 点「加到 Chrome」→ 在弹窗按「新增扩展程序」确认
  3. 点浏览器右上角拼图图示 → 找到 BugEzy → 按钉选
前往 Chrome Web Store →
支援 Chrome 以及所有 Chromium 核心浏览器（Edge、Brave、Arc 等）。钉选后图示会常驻工具列，随时一键开录。

第二步：登入

  1. 点工具列上的 BugEzy 图示
  2. 按「用 Google 登入」→ 选择帐号授权
  3. popup 显示你的名字 = 登入成功

第三步：录下你的第一个 Bug（六种模式任选）

录制
适合：完整重现 Bug 过程
用法：按「录制」→ 操作网页重现 Bug → 语音描述问题 → 按「停止」
录到：DOM 变化 + Console + Network + 语音
30 秒回溯
适合：Bug 已经发生，来不及录
用法：按「回溯 30s」→ 自动抓回最近 30 秒的操作
不用提前按录制，BugEzy 在背景持续记录
截图标注
适合：快速指出画面问题
用法：按「截图标注」→ 画笔/箭头/框框标出问题 → 加文字说明
三种模式：整页截图 / 可见范围 / 自选区域
键盘模式
适合：吵杂环境（咖啡厅、办公室）
用法：开启键盘模式 → 关闭语音辨识 → 用文字描述 Bug
即时监控
适合：挂著等 Bug 自己出现
用法：开启即时监控 → 页面右下角出现 badge → 有 error 自动变红 + 显示数字
点 badge 展开 error 清单
终端机
适合：Server 端的错误（Node.js、Python 等）
用法：终端机输入 npx bugezy-watch -- npm run dev
自动拦截 stderr / throw / crash

第四步：编辑与上传

  1. 录制停止后进入编辑页
  2. 可以编辑语音文字、加补充说明
  3. 按「AI 校正」修正错字（选用）
  4. 按「AI 精简」浓缩重点（选用）
  5. 按「上传」→ 报告自动储存到云端

第五步：让 AI 帮你修

方法一：在 Claude / Cursor / VS Code 直接问
「读我最新的 BugEzy 报告，告诉我怎么修」
AI 透过 MCP 自动读取报告 → 分析 Console error + Network error → 给出修复建议

方法二：分享报告连结
上传后会产生报告连结，传给同事或贴到 Issue

MCP 连接设置
BugEzy MCP 网址（所有工具通用）：
https://bugezy.dev/mcp
注意：这个网址不能用浏览器开，它是专给 AI 工具连接的协议。用浏览器开只会看到一段错误讯息，属正常现象——请依下方步骤在 AI 工具里设置。
Claude.ai
Settings → Connectors → Add → 贴上网址 → 连接
Claude Desktop
编辑 claude_desktop_config.json，加入：
{
  "mcpServers": {
    "bugezy": {
      "url": "https://bugezy.dev/mcp"
    }
  }
}
Cursor
Settings → MCP → Add Server → 贴上网址
VS Code
Settings → 搜寻 MCP → Add Server → 贴上网址
Claude Code（终端机）
执行： claude mcp add --transport http bugezy https://bugezy.dev/mcp
Zed
设置档加 context_servers

🆘 搞不定？把这段话丢给你的 AI

请帮我设置 BugEzy MCP。
BugEzy 是 Chrome 扩展程序的 Bug 报告工具。
MCP 网址：https://bugezy.dev/mcp
请根据我使用的 AI 工具，告诉我怎么设置。

不管你用 Claude、ChatGPT、Cursor 还是 VS Code，AI 都能根据这段话引导你完成设置。

连接成功后，直接问 AI：
「读我最新的 BugEzy 报告，告诉我怎么修」
AI 就会透过 MCP 自动读取你的 Bug 报告。

領 MCP30：30 天免费体验

MCP 接好之后，输入代码 MCP30 就能領 30 天完整功能体验（可与 BUG10 叠加，共 40 天）。

  1. 照上面的步骤把 MCP 网址加进你的 AI 工具
  2. 跟 AI 说「读我最新的 BugEzy 报告」——要真的成功呼叫一次
  3. 打开 BugEzy 扩展程序 → 活动代码栏位输入 MCP30
最常见的卡关：MCP 网址少了 ?token=
BugEzy 要能认出「这次呼叫是谁打的」，才算你完成对接。认人的依据就是网址结尾的 ?token=…。
如果你复制到的网址是 https://bugezy.dev/mcp（后面没有東西），那 AI 读得到报告、但这次呼叫不会算在你头上，MCP30 就会一直说「请先完成 MCP 对接」。

怎么确认：本页上方那几个网址，在你登入后会自动补上 token。如果没有补上，请先点一次 我的报告（那一步会把登入状态带到本站），再回到这页复制一次。
或者直接从扩展程序 → 高级设置 → MCP 网址复制，那份一定带 token。

常见问题

Q：输入 MCP30 显示「请先完成 MCP 对接」？
A：代表 BugEzy 没有看到任何属于你的 MCP 呼叫纪录。九成是网址少了 ?token=（见上方警告）。补上之后，请 AI 再读一次报告，然后重新输入代码。

Q：显示「目前无法验证 MCP 使用纪录」？
A：这是我们这边的问题，不是你的设置。请稍后再试或来信告诉我们。

Q：设置后 AI 说找不到 BugEzy？
A：确认网址完整（含 https://）、重新连线一次。Claude 需要在 Settings → Connectors 看到 BugEzy 呈现已连接状态。

Q：Gemini 支援吗？
A：Gemini 目前还没有开放通用的 MCP 连接器，等官方支援后我们会第一时间更新这页。

小技巧