手冊

Claude 整合是在 Claude 桌面應用程式（Windows、macOS）中加入擴充功能，透過與 Claude 對話操作 GeckoFlag 的功能。可以搜尋、檢視、建立、更新議題、專案、Wiki 與筆記，並將甘特圖匯出為 Excel。擴充功能在使用者的電腦上執行，只會直接與使用者自己的 GeckoFlag 通訊。所有操作都以 API 權杖擁有者的使用者權限進行。

管理員設定

1. 1開啟側邊欄的 設定，按下 Claude 整合 卡片的 編輯。
2. 2開啟 啟用 Claude 整合（預設為停用）。若也要讓 Claude 建立與變更資料，請一併開啟 允許寫入 並儲存。未允許寫入時，所有權杖都會成為唯讀。
3. 3在 使用者 清單中開啟目標使用者的 編輯，勾選 允許使用 Claude 整合（API），然後按下 更新。這與「允許 AI 輔助登錄」是不同的設定。取消授權後，該使用者的 API 權杖會全部刪除。

建立 API 權杖

1. 1開啟側邊欄的 個人資料，在 API 權杖 區塊指定權杖名稱、有效期限（30 天、90 天、365 天或無期限，預設為 90 天）與權限（唯讀 或 讀取與寫入），然後建立權杖。
2. 2複製顯示的權杖（以 gfk_ 開頭的字串）。權杖只會在建立後顯示一次。請一併記下同一區塊中顯示的「要輸入擴充功能的 URL」。

• 每人最多可建立 5 個權杖，不再使用的權杖隨時可以從個人資料中刪除。
• 建立權杖時，本人會收到通知郵件。變更密碼後，該使用者的權杖會全部刪除。

設定 Claude 桌面應用程式

1. 1開啟 Claude 桌面應用程式的 Settings（設定）→ Extensions（擴充功能），將 GeckoFlag 的擴充功能檔案（.mcpb）拖放到畫面上，然後按下 Install。也可以按兩下檔案，或從 Advanced settings 安裝。擴充功能檔案包含在購買 GeckoFlag 後可下載的檔案中。
2. 2在設定畫面輸入下列項目，然後按下 Save。
   • GeckoFlag URL（必填）：先前記下的 URL。必須使用 https://（http:// 僅限 localhost、*.test、*.local）。
   • API token（必填）：複製的權杖。會以遮罩方式儲存。
   • Export folder（選填）：甘特圖 Excel 的儲存位置。留空則儲存到「下載」資料夾。
   
3. 3請 Claude「確認是否已連線到 GeckoFlag」。若顯示權杖擁有者、GeckoFlag 的版本，以及是否可以寫入，即表示設定完成。

附畫面的詳細步驟，請參閱 Claude 整合使用步驟。建議在 Claude 的擴充功能設定中，將寫入操作設為「每次確認」。

可執行的操作

• 議題: 搜尋（依專案、狀態、負責人、建立者、優先順序、關鍵字、到期日、父議題）、檢視詳情與留言、建立（可指定父議題與通知對象）、變更欄位、發表留言、變更狀態。
• 專案: 檢視清單與詳情、建立（訪客以外）、變更名稱、說明、擁有者與期間，切換完成／未完成，新增與移除成員（擁有者、管理員）。
• Wiki: 檢視、改寫標題與內文、在結尾補充內容（專案成員、管理員）。
• 筆記: 自己筆記的清單、搜尋、檢視、建立、改寫與補充。
• 主檔: 新增議題類型、狀態、優先順序與職稱（部門），以及變更名稱與顏色（管理員）。
• 甘特圖: 將專案的議題（最多 5,000 件）製作成 Excel 檔案並儲存到電腦。期間超過 120 天時，會改為 1 欄 = 1 週。
• 搜尋使用者: 依姓名尋找使用者（只回傳 ID 與角色，不回傳電子郵件地址）。

議題可以用「WEB-12」這類代號指定。寫入需要「讀取與寫入」權杖，以及網站的「允許寫入」兩者皆具備。