GeckoFlag 的 Claude 整合，是在 Claude 桌面應用程式中加入擴充功能，讓您透過與 Claude 對話來操作 GeckoFlag 的功能。只要用平常的說法提出要求，例如「列出由我負責、本週到期的議題」「把今天的會議備忘加到 Wiki」，Claude 就會選擇需要的操作，搜尋、檢視、建立、更新議題、專案、Wiki 與筆記。也可以將甘特圖匯出為 Excel。
與「用 AI 建立」的差異
GeckoFlag 已經提供運用 AI 的「用 AI 建立」功能。「用 AI 建立」是在 GeckoFlag 畫面中建立輸入建議的功能，Claude 整合則是透過與 Claude 對話操作 GeckoFlag 的功能。兩者的設定彼此獨立。
| 用 AI 建立 | Claude 整合 | |
|---|---|---|
| 使用場所 | GeckoFlag 的各輸入畫面 | Claude 桌面應用程式的對話 |
| 可以做什麼 | 建立議題、留言、專案與 Wiki 的輸入建議（儲存由人進行） | 搜尋、檢視、建立、更新議題、專案、Wiki 與筆記，將甘特圖匯出為 Excel 等 |
| 需要什麼 | Anthropic 的 API 金鑰（由管理員在設定畫面註冊） | Claude 桌面應用程式，以及每位使用者的 API 權杖 |
| 費用 | 依 API 使用量計費（支付給 Anthropic） | GeckoFlag 不另收費用（需要 Claude 方案） |
| 支援版本 | v1.9.0 以上 | v1.11.0 以上 |
Claude 整合可以做什麼
Claude 會依對話內容，自動選用適合的 GeckoFlag 操作。只有在管理員與使用者雙方都允許寫入時，才能建立與變更資料。
- 搜尋與檢視議題 ― 依專案、狀態、負責人、建立者、優先順序、關鍵字、到期日、父議題篩選搜尋，並讀取詳情與留言。
- 建立與更新議題 ― 可以建立議題（可指定父議題與通知對象）、變更欄位、發表留言、變更狀態。也能在留言的同時變更負責人、優先順序與日期。
- 專案 ― 可以確認清單與詳情、新增專案、變更名稱、說明、擁有者與期間、切換完成／未完成，以及新增與移除成員（移除前一定會先確認）。
- Wiki ― 可以讀取專案的 Wiki、改寫內文，或在結尾補充內容。
- 筆記 ― 可以對自己的筆記進行清單、搜尋、檢視、建立、改寫與補充。
- 主檔設定（管理員） ― 可以新增議題類型、狀態、優先順序與職稱（部門），以及變更名稱與顏色。
- 將甘特圖匯出為 Excel ― 將專案的議題製作成甘特圖格式的 Excel 檔案，儲存到電腦中。
- 以代號指定議題 ― 可以用「WEB-12」這類議題代號指定。Claude 會在回覆中一併提供議題代號與畫面的 URL。
- 保留格式 ― 讀寫說明、留言、Wiki 與筆記時，會保留標題、項目符號、表格、連結、粗體等格式。
- 使用您習慣的語言 ― Claude 會以使用者對話時使用的語言回覆。
提出要求的範例
不需要記住特殊指令。只要用平常的說法提出要求，Claude 就會選擇並執行需要的操作。
| 想做的事 | 要求範例 |
|---|---|
| 尋找議題 | 「列出由我負責、本週到期的議題」 |
| 建立議題 | 「在 WEB 專案建立一個名為『修正聯絡表單』的議題」 |
| 記錄處理內容 | 「在 WEB-3 留言記錄處理內容，並把狀態改成完成」 |
| 建立專案 | 「建立一個代號為 SAMPL、名稱為『範例案件』的專案」 |
| 新增成員 | 「把陳先生加入 SAMPL」 |
| 記錄到 Wiki | 「把今天的會議備忘補充到 SAMPL 的 Wiki」 |
| 調整設定 | 「在狀態中新增紫色的『待審查』」 |
| 甘特圖 | 「將 WEB 專案的甘特圖匯出為 Excel」 |
| 彙整 | 「撰寫 SAMPL 本週的報告」「把 Wiki 上的待辦事項建立成議題」 |
將甘特圖匯出為 Excel
只要要求「將甘特圖匯出為 Excel」，就會將專案的議題（最多 5,000 件）製作成甘特圖格式的 Excel 檔案，儲存到電腦中。
- 父子關係一目了然 ― 每個議題佔一列，子議題會縮排排列在父議題正下方。右側為時間軸。
- 支援長期間 ― 可以指定期間以及日／週單位。期間超過 120 天時，會自動切換為 1 欄 = 1 週（最長約 5 年）。
- 可在 Excel 中調整 ― 修改開始日期與結束日期後，橫條也會跟著移動（不會反映到 GeckoFlag）。
- 也會顯示未輸入日期的議題 ― 以建立日期等代替，並以灰色斜體顯示及註明原因。
- 支援 15 種語言 ― 標題等文字會以 GeckoFlag 使用者設定的語言輸出（阿拉伯文為由右至左的工作表）。
- 不會覆寫 ― 若已有同名檔案，會加上編號另存新檔。
使用所需條件
- GeckoFlag v1.11.0 以上 ― Claude 整合已於 v1.11.0 新增。若您使用的是更早的版本，請先更新。
- Claude 桌面應用程式（Windows、macOS） ― 加入 GeckoFlag 的擴充功能（.mcpb 檔案）後使用。擴充功能檔案包含在購買 GeckoFlag 後可下載的檔案中。擴充功能執行所需的 Node.js 已內建於應用程式中，不需要另外安裝。
- Claude 方案 ― GeckoFlag 不另收費用。使用 Claude 需要 Anthropic 的 Claude 方案。
- 以 HTTPS 公開的 GeckoFlag ― 擴充功能連線至 GeckoFlag 時需要使用 HTTPS。
導入流程
- 管理員在 GeckoFlag 的「設定 → Claude 整合」中啟用功能，並視需要允許寫入。
- 管理員為每位要使用的人開啟「允許使用 Claude 整合（API）」。
- 使用者在個人資料畫面建立 API 權杖。
- 使用者在 Claude 桌面應用程式安裝擴充功能，並輸入 GeckoFlag 的 URL 與 API 權杖。
- 請 Claude「確認是否已連線到 GeckoFlag」，即可完成準備。
權限與安全性
- 三項授權齊備才能運作 ― 只有在「管理員啟用功能」「依使用者授予使用權限」「使用者的 API 權杖」三者齊備時才能使用。功能停用時，API 本身會處於不存在的狀態。
- 與畫面相同的權限 ― 所有操作都以 API 權杖擁有者的權限進行。在 GeckoFlag 畫面中看不到或無法執行的操作，透過 Claude 也無法執行。沒有權限的專案與議題會被視為「不存在」。
- 寫入需雙重授權 ― 建立與變更需要網站的「允許寫入」與權杖的「讀取與寫入」兩者皆具備。也可以只以唯讀方式使用。
- 無法從 Claude 刪除 ― 無法從 Claude 刪除專案、議題、留言、Wiki、筆記等。要求刪除時，會引導您在 GeckoFlag 畫面中進行。
- 安全的權杖管理 ― API 權杖是無法推測的隨機值，伺服器只儲存其雜湊值。權杖只會在建立後顯示一次，建立時本人會收到通知郵件。變更密碼後，該使用者的權杖會全部失效。
- 次數限制與存取限制 ― 每個權杖每分鐘最多 60 次，連續使用錯誤權杖的連線來源會被暫時封鎖。GeckoFlag 依 IP 位址設定的存取限制也同樣適用於 API。
- 每次寫入前都可確認 ― 在 Claude 端的設定中，將 GeckoFlag 的寫入操作設為「每次確認」，執行前一定會要求您確認（建議的設定）。
資料處理
- 擴充功能在您的電腦上執行 ― 擴充功能只會直接與您的 GeckoFlag 通訊，不會經過 GeckoFlag 開發者或第三方的伺服器。
- Claude 讀取的內容會傳送給 Anthropic ― Claude 讀取的議題、Wiki、筆記等內容，會作為對話的一部分傳送給 Anthropic（Claude）。已指示 Claude 只在使用者要求時才讀取筆記。
- 不遵從內容中寫的指示 ― 已指示 Claude 將議題等處寫的文字視為「資料」處理，不遵從其中寫的指示。
- 操作紀錄 ― 來自 Claude 的操作會記錄為 API 權杖擁有者的操作（不會顯示「經由 Claude」）。
- 導入前的確認 ― 導入前，請確認公司內部規定或與客戶的合約中，是否限制將資訊傳送至外部服務。
無法執行的操作與使用注意事項
- 無法刪除（專案、議題、留言、主檔、Wiki、筆記）、編輯留言，以及附加與檢視圖片或檔案。
- 無法新增或編輯使用者、變更網站設定、操作看板、書籤與通知設定，也無法檢視他人的筆記（管理員也不行）。
- 每次只寫入 1 件。一次要求多個議題時，Claude 會逐件依序執行。
- 透過留言變更狀態等時，會和在畫面上操作一樣留下歷程，並傳送通知郵件。
- 擴充功能在電腦上執行，因此只能在已開啟 Claude 桌面應用程式的電腦上使用。
- AI 的回覆可能有誤。建立與變更的內容，也請在 GeckoFlag 畫面中確認。