本頁說明開始使用 Claude 整合 的步驟。由 GeckoFlag 管理員啟用功能並授權使用者，再由使用者建立 API 權杖，並在 Claude 桌面應用程式中加入擴充功能。

開始之前

  • GeckoFlag v1.11.0 以上 ― 必須以 HTTPS 公開。
  • GeckoFlag 管理員帳戶 ― STEP 1 與 STEP 2 的設定只有管理員可以進行。
  • Claude 桌面應用程式（Windows、macOS） ― 請先以 Claude 方案的帳戶登入。擴充功能所需的 Node.js 已內建於應用程式中，不需要另外安裝。
  • GeckoFlag 的擴充功能檔案（.mcpb） ― 要加入 Claude 桌面應用程式的檔案。此檔案與 GeckoFlag 本體和手冊一起，包含在購買 GeckoFlag 後可下載的檔案中。

畫面為英文顯示的範例（GeckoFlag 與 Claude 的項目名稱都會依顯示語言而改變）。Claude 桌面應用程式的畫面為 2026 年 10 月時的內容，可能因 Anthropic 的因素而變更。

整體流程

  1. 管理員在 GeckoFlag 的設定畫面啟用 Claude 整合
  2. 管理員為每位要使用的人開啟「允許使用 Claude 整合（API）」
  3. 使用者在個人資料畫面建立並複製 API 權杖
  4. 使用者在 Claude 桌面應用程式安裝擴充功能
  5. 在擴充功能中輸入 GeckoFlag 的 URL 與 API 權杖
  6. 請 Claude 確認是否已連線

STEP 1　啟用 Claude 整合（管理員）

  1. 以管理員身分登入 GeckoFlag，開啟左側選單的「設定」（Settings）。
  2. 按下「Claude 整合」（Claude Integration）卡片的「編輯」（Edit）。
GeckoFlag 的設定畫面。「Claude Integration」卡片（Work from the Claude desktop app）以紅框標示
  1. 開啟「啟用 Claude 整合」（Enable Claude integration）。預設為停用。
  2. 若也要讓 Claude 建立與更新議題或發表留言，請一併開啟「允許寫入」（Allow writing）並儲存。
  • 未允許寫入時 ― 所有權杖都會成為唯讀。即使是以「讀取與寫入」建立的權杖，也只能用於搜尋與檢視。
  • 確認使用狀況 ― 可在同一畫面確認已授權的使用者數，以及已建立的 API 權杖數。
GeckoFlag 的 Claude 整合設定畫面。狀態「Enabled」，以及「Enable Claude integration」「Allow writing (create and update issues, post comments)」兩個核取方塊以紅框標示

STEP 2　授權使用者（管理員）

只有經管理員授權的使用者才能使用 Claude 整合（管理員本人也需要授權）。

  1. 開啟左側選單的「使用者」（Users），按下目標使用者的「編輯」。
  2. 開啟「允許使用 Claude 整合（API）」（Allow Claude integration (API)），然後按下「更新」（Update）。
GeckoFlag 的使用者編輯畫面。左側選單的「Users」與「Allow Claude integration (API)」核取方塊以紅框標示
  • 與「用 AI 建立」是不同的設定 ― 正上方的「允許 AI 輔助登錄」（Allow AI-assisted registration）是 用 AI 建立 的權限。只使用 Claude 整合時，不需要開啟。
  • 取消授權後 ― 該使用者的 API 權杖會全部刪除，無法再從 Claude 使用。

STEP 3　建立 API 權杖

以下步驟由每位要使用 Claude 整合的人各自進行。

  1. 開啟左側選單的「個人資料」（Profile），顯示「API 權杖（Claude 整合）」（API Tokens）區塊。
  2. 記下「要輸入擴充功能的 URL」（URL to enter in the extension）。STEP 5 會用到。
  3. 在「權杖名稱」（Token name）輸入看得出在哪台電腦使用的名稱（例如：工作電腦的 Claude）。
  4. 從 30 天、90 天、365 天或無期限中選擇「有效期限」（Expires in）（預設為 90 天）。
  5. 選擇「權限」（Permission），然後按下「建立權杖」（Create token）。
GeckoFlag 個人資料畫面的「API Tokens (Claude Integration)」區塊。左側選單的「Profile」，以及 Token name、Expires in、Permission 輸入欄以紅框標示
  • 權限的選擇方式 ― 只需搜尋與檢視時選擇「唯讀」（Read only）；若也要讓 Claude 建立與更新議題或發表留言，請選擇「讀取與寫入」（Read and write）。請只在需要時才選擇寫入。
  • 權杖只會在建立後顯示一次。請務必當場複製。請像保管密碼一樣保管權杖，不要讓他人知道。
  • 可建立的數量 ― 每人最多可建立 5 個。不再使用的權杖，隨時可以在同一畫面刪除。
  • 變更密碼後 ― 該使用者的權杖會全部刪除。請重新建立，並再次輸入到擴充功能中。

STEP 4　在 Claude 安裝擴充功能

  1. 開啟 Claude 桌面應用程式，按下左下角的帳戶名稱，開啟「設定」（Settings）。
Claude 桌面應用程式的首頁畫面。左下角的帳戶選單已開啟，「Settings」以紅框標示
  1. 開啟左側選單的「擴充功能」（Extensions）。
  2. 將 GeckoFlag 的擴充功能檔案（.mcpb）拖放到此畫面。也可以從「進階設定」（Advanced settings）的「安裝擴充功能」選擇檔案，或按兩下檔案進行安裝。
Claude 設定畫面的「Extensions」。尚未安裝擴充功能，顯示「Advanced settings」按鈕與「Drag .MCPB or .DXT files here to install」的說明
  1. 顯示 GeckoFlag 擴充功能的說明後，確認內容並按下「安裝」（Install）。
GeckoFlag 擴充功能的安裝畫面。顯示擴充功能的說明與注意事項，右上角的「Install」按鈕以紅框標示

安裝畫面會顯示 Claude 的標準注意事項，例如「允許擴充功能存取您的電腦」「開發者資訊未經 Anthropic 驗證」。GeckoFlag 的擴充功能只會與您輸入的 GeckoFlag URL 通訊，並且只在將甘特圖匯出為 Excel 時儲存檔案。

STEP 5　設定連線目標與權杖

  1. 安裝後會開啟設定畫面（Configure）。輸入下列項目，然後按下「儲存」（Save）。
GeckoFlag 擴充功能的設定畫面。有 GeckoFlag URL（必填）、API token（必填）、Export folder 輸入欄，以及「Cancel」「Save」按鈕
項目輸入內容
GeckoFlag URL
（必填）		在 STEP 3 記下的「要輸入擴充功能的 URL」（例如：https://pm.example.com）。必須是以 https:// 開頭的 URL。
API token
（必填）		在 STEP 3 複製的 API 權杖（以 gfk_ 開頭的字串）。會以遮罩方式儲存。
Export folder
（選填）		甘特圖 Excel 檔案的儲存位置。留空則儲存到「下載」資料夾。
  1. 「擴充功能」清單中顯示「GeckoFlag」，即表示安裝完成。請確認擴充功能已啟用。若要變更設定，可從「設定」（Configure）重新開啟。
Claude 設定畫面的「Extensions」。「Installed on your computer」中顯示「GeckoFlag」，並有「Configure」按鈕
  • 想在寫入前確認時（建議） ― 在同一畫面開啟 GeckoFlag 擴充功能，將建立與更新議題等寫入操作設為「每次確認」，Claude 執行前一定會要求您確認。

STEP 6　確認連線

  1. 在 Claude 開啟新的對話，並要求「確認是否已連線到 GeckoFlag」。
  2. 若 Claude 回答權杖擁有者的姓名、GeckoFlag 的版本，以及是否可以寫入，即表示設定完成。

之後只要用平常的說法提出要求即可，例如「列出由我負責、本週到期的議題」。提出要求的範例，請參閱 Claude 整合頁面。

遇到問題時

大多數情況下，Claude 會在對話中說明原因與解決方法。常見的例子如下。

  • Claude 不使用 GeckoFlag ― 擴充功能已停用或尚未安裝。請在設定的「擴充功能」中啟用 GeckoFlag，然後重新開啟對話。
  • 找不到 API（404） ― 可能是 Claude 整合已停用、GeckoFlag 版本過舊，或 URL 有誤。請確認管理員設定、GeckoFlag 的版本與輸入的 URL。
  • 權杖遭拒（401） ― 可能是權杖有誤、已過期或已被刪除（變更密碼也會刪除權杖）。請在個人資料畫面重新建立，並再次輸入到擴充功能中。
  • 未獲得使用授權 ― 請管理員在使用者編輯畫面開啟「允許使用 Claude 整合（API）」。
  • 無法寫入（403） ― 可能是使用了「唯讀」權杖，或網站的「允許寫入」為關閉。請建立「讀取與寫入」權杖，或請管理員授權。
  • 找不到議題或專案 ― 可能是代號有誤，或您不是該專案的成員。請確認代號，或請擁有者將您加入成員。
  • 被重新導向 ― http 與 https、有無 www 等不一致。請輸入在瀏覽器開啟時最終顯示的 URL。
  • 遭網站拒絕 ― GeckoFlag 依 IP 位址設定的存取限制也適用於 API。請從允許的位置使用，或請管理員重新檢視允許範圍。
  • 次數限制（429） ― 每個權杖每分鐘最多 60 次。若連續使用錯誤的權杖，請等候最多約 15 分鐘後再試一次。
  • 沒有回應 ― 伺服器可能速度緩慢或已停止運作。若是寫入操作，可能已經儲存，請先在 GeckoFlag 畫面確認後再重試。
  • Apache 伺服器持續出現 401 ― 通常會自動處理。若持續發生，請確認 GeckoFlag 的 webroot/.htaccess 是否為最新版本。
返回「Claude 整合」