ClickUp

• 您希望 AI 代理能代表您建立、更新或查詢 ClickUp 任務與專案，而無需自行設定 OAuth。
• 您需要自動化專案管理工作流程——例如從會議記錄建立任務、更新狀態，或根據外部觸發條件指派工作。
• 您希望以程式化方式註冊 ClickUp Webhook，以回應任務建立、狀態變更或截止日期更新等事件。
• 您正在建構一個多步驟代理，需要遍歷 ClickUp 階層結構（工作區 → 空間 → 資料夾 → 清單 → 任務）以尋找或整理工作項目。

• 您需要與 ClickUp 以外的第三方應用程式整合 — 請改用 api-gateway skill。
• 您已擁有自己的 ClickUp OAuth token，並希望直接呼叫 ClickUp API，而不透過代理層。

驗證由 Maton 閘道處理。您只需提供 MATON_API_KEY；閘道會自動將您的 ClickUp OAuth 權杖注入每個代理請求中。OAuth 連線於 ctrl.maton.ai 進行管理。

建立、讀取、更新及刪除任務，支援指派人員、優先順序（緊急／高／普通／低）、截止日期、標籤、子任務、自訂欄位及時間估算。任務可依狀態、指派人員、截止日期範圍等條件進行篩選。

涵蓋 ClickUp 結構的每個層級：工作區（團隊）、空間、資料夾、清單與任務。使用標準 REST 操作，在階層結構的任意層級建立或管理任何實體。

註冊並管理 Webhook，以接收即時的 ClickUp 事件——包括任務建立、狀態變更、指派人更新、截止日期變更、留言，以及資料夾／空間的生命週期事件。

如果您已連接多個 ClickUp 帳戶，您可以在每個請求中使用 Maton-Connection 標頭來指定特定的連線。否則，閘道器將預設使用您最早建立的有效連線。

列表端點支援以頁面為基礎的分頁功能（每頁最多 100 筆資料）。回應中的 last_page 布林值讓您可以輕鬆地逐頁瀏覽大型結果集。

當錯誤回報、支援工單或會議記錄送達時，代理程式可自動在正確的清單中建立 ClickUp 任務，並指派適當的負責人、優先順序與截止日期，完全無需任何手動操作。

代理程式可以遍歷工作區中的空間、資料夾和清單，收集任務狀態，然後跨多個團隊產生每日或每週的專案摘要報告。

為 taskStatusUpdated 或 taskAssigneeUpdated 等事件註冊 Webhook，讓下游系統（Slack 通知、行事曆區塊、CI/CD 管線）能夠即時回應 ClickUp 的變更。

代理程式可以讀取待辦清單中的所有任務，依優先順序與負責人的可用時間進行篩選，並將任務批次移動或更新至 Sprint 資料夾中，從而簡化 Sprint 計畫會議的流程。