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 連接器，等官方支援後我們會第一時間更新這頁。

小技巧