Bunny Redmine Enterprise MCP 套件介紹、安裝與使用方式
By Appar Insight, 2026年11月5日
AI Agent 可以讀文件、整理需求與撰寫程式，但工作最後仍要回到團隊使用的系統：建立議題、補上處理紀錄、更新狀態、附上畫面，讓下一位成員能接手。若每次都要由人員在 AI 對話與 Redmine 之間複製資料，效率提升只停留在個人操作，工作紀錄也容易遺漏。
Bunny Redmine Enterprise MCP 是約沛科技開源的 Redmine 外掛，直接把 Redmine 變成 MCP Server。Claude、ChatGPT、Cursor、Claude Code 與 VS Code 等支援 MCP 的工具，可以在使用者原有權限範圍內查詢及處理 Redmine 工作。
本文會說明這個套件的用途、設計理由、安裝與連線方式，以及它和常見外接式 Redmine MCP Server 的架構差異。套件採 MIT License；Bunny Redmine 名稱與大白兔圖樣為約沛科技商標。
這個套件把 AI Agent 接到 Redmine 的真實工作裡
Model Context Protocol（MCP） 是讓 AI 應用連接外部資料與工具的開放標準。MCP Client 負責接收使用者指令，MCP Server 則提供可讀取的資料與可執行的動作。對 Redmine 團隊而言，重點是 AI 能否在正確的專案與權限內完成工作，並把結果留下來供團隊追蹤。
Bunny Redmine Enterprise MCP 提供 62 項工具，範圍涵蓋專案、議題、留言、附件、Wiki、版本、工時、查詢與部分管理功能。使用者可以請 AI 找出分配給自己的未完成議題、閱讀附件、建立或更新議題、補登處理時間，也能把測試畫面加上編號與紅框後附回 Redmine。
這項整合最直接的價值，是讓 AI 的產出進入既有工作紀錄。工程師完成修正後，Agent 可以整理變更、上傳驗證畫面、更新狀態及登錄工時；專案經理回到 Redmine 就能看見同一筆議題的處理脈絡，不必另外追查某段 AI 對話。
原生外掛讓身分、權限與工作流程由 Redmine 判斷
這個套件直接安裝在 Redmine 的 plugins 目錄，使用 Redmine 本身的資料模型與權限檢查，不需要另外部署一個 Node.js 或 Python MCP 服務。這項設計減少了一個需要獨立更新、監控與保存密鑰的服務，也讓 Redmine 可以直接識別發出操作的使用者。
每位使用者以自己的 OAuth 2.1 連線或存取權杖連接。Agent 能看到哪些專案、能否新增議題、可以把狀態改到哪一步，仍由該使用者在 Redmine 的角色、工作流程與專案權限決定。當同一個團隊有工程師、測試人員、外部客戶與管理者時，大家可以使用相同的 MCP 入口，取得的資料與可執行動作會跟著各自身分調整。
套件也支援唯讀連線。企業可以先讓 Agent 查詢議題與彙整資訊，確認使用情境與權限配置，再逐步開放寫入工具。高風險的刪除與管理工具預設停用，封鎖帳號、修改密碼、封存專案及授予管理員等操作不開放給 MCP。
安裝後用一個網址連接 Claude ChatGPT 與開發工具
套件支援 Redmine 4.0 到 7.0。正式安裝前，應先在測試環境確認目前 Redmine 版本、既有外掛與備份還原流程。外掛目錄名稱必須保留為 bunny_redmine_enterprise_mcp。
cd /path/to/redmine/plugins
git clone https://github.com/appardev/bunny_redmine_enterprise_mcp.git
cd ..
bundle exec rake redmine:plugins:migrate RAILS_ENV=production
# 重新啟動 Redmine
完成後，MCP Server 位址為：
https://your-redmine.example.com/bunny-mcpClaude 與 ChatGPT 可以把這個網址加入自訂 Connector；Claude Code 可以執行下列指令：
claude mcp add --transport http redmine \
https://your-redmine.example.com/bunny-mcpCursor 與 VS Code 則能在 MCP 設定檔加入相同網址。第一次連線會進入 Redmine 授權畫面，使用者選擇唯讀或讀寫權限後完成 OAuth 流程。若 Redmine 只開放在公司內網，雲端版 Claude 或 ChatGPT 無法直接連入；可改用能從內網存取的 Claude Code、Cursor 或 VS Code。
閱讀 PDF 內容需要主機安裝 pdftotext；畫面標註功能需要 ImageMagick。這兩項為選用功能，不影響一般的議題查詢與更新。
一項完整任務可以從讀取問題走到修正紀錄
套件的示範流程從一筆 UI 問題開始。Agent 先讀取議題說明與附件，進入指定頁面重現問題，再把問題區域加上編號與紅框，上傳到議題並將狀態改為處理中。完成修正後，它會附上修正畫面、更新為已解決，最後登錄實際工時。
這段流程呈現 MCP 整合的重要差異：Agent 除了取得議題文字，還能使用附件、狀態、工作流程與工時等 Redmine 能力。每一步都回寫同一筆議題，測試人員能從歷程核對修正內容，主管也能使用原有報表掌握進度。
實際導入時，不必一開始就讓 Agent 自動執行整段流程。可以先從「整理一筆議題並提出下一步」開始，再依任務風險加入建立留言、上傳附件與更新狀態。付款、正式發布或跨專案大量修改等高影響動作，仍應保留明確的人工確認。
工具開關與稽核紀錄讓管理者看得見 Agent 做了什麼
管理者可以逐項啟用或停用 MCP 工具，並查看工具屬於讀取、寫入、刪除或管理類別。公司若只需要 AI 協助查詢，可以關閉全部寫入工具；若要開放議題處理，也能保留建立留言、更新議題與上傳附件，同時停用不需要的功能。
每次工具呼叫都會寫入活動紀錄，成功、失敗與遭拒絕的操作都會保留。紀錄包含時間、使用者、工具、結果、專案、目標資料、MCP Client、IP、執行時間與參數；管理者可設定保存天數及是否記錄參數。附件內容不會寫入稽核紀錄，只保留檔案大小。
稽核紀錄能協助調查與改善權限設計，仍需要搭配 HTTPS、最小權限、帳號停用、定期備份、外掛更新與 Redmine 安全維護。AI Client 端是否在寫入前再次詢問，也會依產品與使用者設定而不同。
和外接式 Redmine MCP Server 的差異在部署與身分模型
開源社群已有多種 Redmine MCP 實作。常見做法是在使用者電腦或伺服器另行啟動 MCP Server，再使用 Redmine REST API 與 API key 存取資料。這類工具安裝快速、容易獨立開發，也適合個人或小型團隊。Bunny Redmine Enterprise MCP 採用 Redmine 原生外掛，優先處理多人使用、權限沿用與集中稽核。各專案功能持續變動，評估時仍應查閱其最新文件。
| 評估項目 | 常見外接式 MCP Server | Bunny Redmine Enterprise MCP |
|---|---|---|
| 部署位置 | 另行執行 Node.js、Python 或容器服務 | 安裝為 Redmine 外掛，使用既有應用環境 |
| 連線身分 | 通常在 Client 或服務端配置 API key；部分專案支援每位使用者傳入個人 key | 每位使用者以 OAuth 2.1 或個人權杖連線 |
| 權限判斷 | 取決於 API key 所屬帳號與工具本身的限制 | 沿用連線者的 Redmine 專案角色、工作流程與權限 |
| 工具治理 | 依專案提供唯讀模式、允許或拒絕清單等機制 | 管理者在 Redmine 逐項開關工具，高風險功能預設停用 |
| 操作稽核 | 依各專案的日誌設計與部署方式而定 | 集中記錄每次成功、失敗與遭拒的工具呼叫 |
| 升級與維運 | Redmine 與 MCP Server 分別更新 | 外掛隨 Redmine 環境測試、遷移與更新 |
若需求是讓單一開發者在本機快速操作 Redmine，外接式方案具有部署彈性。當多位員工、外部協作者與不同 AI Client 都要連接同一套 Redmine，且公司需要依使用者身分限制資料、集中停用工具及追查操作，原生外掛的設計會更容易納入既有治理方式。
先從唯讀與單一流程開始評估
導入前可以先挑選一條範圍清楚、目前需要反覆查找或複製資料的流程，例如整理待處理議題、從測試回報建立修正工作，或彙整版本進度。先使用唯讀連線確認 Agent 取得的資料範圍，再開放必要的寫入工具，並從活動紀錄檢查實際使用情況。
適合導入的前提，是 Redmine 內的角色、狀態與工作紀錄已具有基本一致性。若同一狀態在各團隊代表不同意義，或大量成員擁有超出工作需要的權限，Agent 會把既有問題放大。整理權限與流程，是連接 AI 前最值得完成的準備。
Bunny Redmine Enterprise MCP 的原始碼、安裝方式與完整工具清單已公開在 GitHub。你可以先在測試環境安裝，使用唯讀連線驗證一項真實工作；若需要評估企業 Redmine 的版本相容、權限設計、內網部署或 AI Agent 流程，也可以聯絡約沛科技討論適合的導入範圍。
