# 使用範例

本文件提供 Redmine MCP Server 的詳細使用範例，包含在 Claude Code 中的實際對話範例。

## 📋 目錄

1. [基本操作](#基本操作)
2. [議題管理](#議題管理)
3. [專案管理](#專案管理)
4. [搜尋功能](#搜尋功能)
5. [高級用法](#高級用法)

## 🔧 基本操作

### 檢查服務狀態

**用戶輸入：**
```
請檢查 Redmine MCP 服務器狀態
```

**Claude 回應：**
```
✓ 服務器正常運作，已連接到 https://your-redmine.com
```

### 取得服務器資訊

**用戶輸入：**
```
顯示服務器資訊
```

**Claude 回應：**
```
Redmine MCP 服務器已啟動
- Redmine 網域: https://your-redmine.com
- 除錯模式: false
- API 逾時: 30秒
```

## 📝 議題管理

### 查看議題詳情

**用戶輸入：**
```
取得議題 #123 的詳細資訊
```

**Claude 回應：**
```
議題 #123: 修復用戶登入問題

基本資訊:
- 專案: 電商網站 (ID: 1)
- 追蹤器: Bug
- 狀態: 進行中
- 優先級: 高
- 建立者: 張三
- 指派給: 李四
- 完成度: 30%
- 建立時間: 2024-01-15
- 更新時間: 2024-01-20

描述:
用戶回報無法正常登入系統，錯誤訊息顯示「Invalid credentials」
```

### 建立新議題

**用戶輸入：**
```
在專案 ID 1 中建立新議題：
- 標題：優化搜尋功能效能
- 描述：目前搜尋回應時間過長，需要進行效能優化
- 追蹤器 ID：2 (功能)
- 優先級 ID：3 (中)
```

**Claude 回應：**
```
新議題建立成功!

議題 ID: #156
標題: 優化搜尋功能效能
專案: 電商網站
追蹤器: 功能
狀態: 新建
優先級: 中
指派給: 未指派

描述:
目前搜尋回應時間過長，需要進行效能優化
```

### 更新議題狀態

**用戶輸入：**
```
將議題 #123 狀態更新為「已解決」，並加上備註「已修復登入驗證邏輯」
```

**Claude 回應：**
```
議題狀態更新成功!

議題: #123 - 修復用戶登入問題
新狀態: 已解決
備註: 已修復登入驗證邏輯
```

### 更新議題內容

**用戶輸入：**
```
更新議題 #156 的完成度為 60%，並修改描述為「已完成初步效能分析」
```

**Claude 回應：**
```
議題內容更新成功!

議題: #156 - 優化搜尋功能效能
已更新的欄位:
- 描述已更新
- 完成度: 60%

目前狀態:
- 狀態: 進行中
- 優先級: 中
- 完成度: 60%
```

### 指派議題

**用戶輸入：**
```
將議題 #156 指派給用戶 ID 5，備註「請協助進行效能測試」
```

**Claude 回應：**
```
議題指派更新成功!

議題: #156 - 優化搜尋功能效能
動作: 指派給用戶 ID 5
目前指派給: 王五
備註: 請協助進行效能測試
```

### 新增議題備註

**用戶輸入：**
```
為議題 #123 新增備註「測試結果：登入功能正常運作」
```

**Claude 回應：**
```
備註新增成功!

議題: #123 - 修復用戶登入問題
備註類型: 公開
備註內容:
測試結果：登入功能正常運作
```

### 關閉議題

**用戶輸入：**
```
關閉議題 #123，完成度設為 100%，備註「問題已解決並通過測試」
```

**Claude 回應：**
```
議題關閉成功!

議題: #123 - 修復用戶登入問題
狀態: 已關閉
完成度: 100%
關閉備註: 問題已解決並通過測試
```

## 🗂️ 專案管理

### 取得專案列表

**用戶輸入：**
```
顯示所有可存取的專案
```

**Claude 回應：**
```
找到 3 個專案:

ID    識別碼               名稱                           狀態   
----- -------------------- ------------------------------ ----
1     ecommerce-website    電商網站                        正常   
2     mobile-app           行動應用程式                    正常   
3     internal-tools       內部工具                        封存   
```

### 列出專案議題

**用戶輸入：**
```
顯示專案 1 中所有開放的議題，限制 10 筆
```

**Claude 回應：**
```
專案: 電商網站
狀態篩選: open
找到 8 個議題:

ID       標題                                     狀態         指派給          更新時間  
-------- ---------------------------------------- ------------ --------------- ----------
156      優化搜尋功能效能                          進行中        王五            2024-01-20
154      新增購物車提醒功能                        新建          未指派          2024-01-19
152      修復商品圖片載入問題                      進行中        李四            2024-01-18
```

## 🔍 搜尋功能

### 關鍵字搜尋

**用戶輸入：**
```
搜尋包含「效能」關鍵字的議題
```

**Claude 回應：**
```
搜尋關鍵字: '效能'
找到 3 個相關議題:

ID       標題                                 狀態         專案           
-------- ------------------------------------ ------------ ---------------
156      優化搜尋功能效能                      進行中        電商網站       
143      網站載入速度效能優化                  已解決        電商網站       
128      資料庫查詢效能調整                    進行中        內部工具       
```

### 專案內搜尋

**用戶輸入：**
```
在專案 1 中搜尋包含「登入」的議題
```

**Claude 回應：**
```
搜尋關鍵字: '登入'
搜尋範圍: 專案 1
找到 2 個相關議題:

ID       標題                                 狀態         專案           
-------- ------------------------------------ ------------ ---------------
123      修復用戶登入問題                      已關閉        電商網站       
145      第三方登入整合                        新建          電商網站       
```

### 我的議題

**用戶輸入：**
```
顯示指派給我的所有開放議題
```

**Claude 回應：**
```
指派給 張三 的議題:
狀態篩選: open
找到 4 個議題:

ID       標題                                 專案            狀態         更新時間  
-------- ------------------------------------ --------------- ------------ ----------
161      實作用戶權限管理                      電商網站         新建          2024-01-21
159      優化資料庫索引                        內部工具         進行中        2024-01-20
157      更新 API 文件                         電商網站         進行中        2024-01-19
155      修復手機版 UI 問題                    行動應用程式     新建          2024-01-18
```

## 🚀 高級用法

### 批量操作範例

**用戶輸入：**
```
請幫我完成以下操作：
1. 取得專案 1 中所有新建狀態的議題
2. 將優先級為「高」的議題指派給用戶 ID 3
3. 為每個指派的議題新增備註「已指派處理」
```

**Claude 會自動執行這些步驟：**

```
1. 正在取得專案 1 中的新建議題...

專案: 電商網站
狀態篩選: open
找到 3 個新建議題:
- #154: 新增購物車提醒功能 (優先級: 高)
- #158: 更新商品分類頁面 (優先級: 中)
- #160: 增加客戶評論功能 (優先級: 高)

2. 正在指派優先級為「高」的議題...

議題 #154 指派給用戶 ID 3 成功
議題 #160 指派給用戶 ID 3 成功

3. 正在新增備註...

為議題 #154 新增備註成功
為議題 #160 新增備註成功

✅ 批量操作完成！已指派 2 個高優先級議題給用戶 ID 3。
```

### 工作流程自動化

**用戶輸入：**
```
幫我建立一個新的 Bug 報告工作流程：
1. 建立議題「修復商品頁面載入錯誤」
2. 設定為高優先級
3. 指派給 QA 團隊負責人（用戶 ID 7）
4. 新增初步分析備註
```

**Claude 執行流程：**

```
🔄 執行 Bug 報告工作流程...

步驟 1: 建立新議題
新議題建立成功!
議題 ID: #162
標題: 修復商品頁面載入錯誤

步驟 2: 設定高優先級
議題內容更新成功!
已更新的欄位:
- 優先級 ID: 4

步驟 3: 指派給 QA 負責人
議題指派更新成功!
目前指派給: QA-Leader

步驟 4: 新增分析備註
備註新增成功!
備註內容: 需進行初步錯誤重現和環境分析

✅ Bug 報告工作流程完成！議題 #162 已建立並準備開始處理。
```

## 📊 系統狀態查詢

### 取得議題狀態清單

**用戶輸入：**
```
顯示所有可用的議題狀態
```

**Claude 回應：**
```
可用的議題狀態:

ID    名稱              已關閉
----- --------------- --------
1     新建             否      
2     進行中           否      
3     已解決           否      
4     回饋中           否      
5     已關閉           是      
6     已拒絕           是      
```

## 💡 最佳實務建議

### 1. 議題描述撰寫
```
建立議題時包含：
- 問題現象描述
- 重現步驟
- 預期結果
- 實際結果
- 環境資訊
```

### 2. 狀態更新習慣
```
定期更新議題狀態並加上有意義的備註：
- 說明目前進度
- 遇到的問題
- 下一步計畫
```

### 3. 搜尋技巧
```
使用具體關鍵字搜尋：
- 功能名稱（如「登入」、「搜尋」）
- 錯誤類型（如「500錯誤」、「載入失敗」）
- 元件名稱（如「購物車」、「用戶介面」）
```

## 🔧 故障排除範例

### 權限問題
**錯誤訊息：**
```
權限不足：您沒有執行此操作的權限
```

**解決方案：**
1. 確認 API 金鑰對應的用戶有足夠權限
2. 檢查專案是否為公開或用戶是否為專案成員
3. 確認用戶角色設定

### 連線問題
**錯誤訊息：**
```
連線失敗：請檢查網路連線和 Redmine 伺服器狀態
```

**解決方案：**
1. 檢查網路連線
2. 確認 Redmine 服務器是否正常運作
3. 檢查防火牆設定
4. 調整逾時設定

---

更多使用技巧和範例，請參考 [README.md](../README.md) 或開啟 Issue 詢問。