ClickUp

• 您希望 AI 代理代表您创建、更新或查询 ClickUp 任务和项目，而无需自行设置 OAuth。
• 您需要自动化项目管理工作流程——例如根据会议记录创建任务、更新状态，或根据外部触发器分配工作。
• 您希望以编程方式注册 ClickUp Webhook，以响应任务创建、状态变更或截止日期更新等事件。
• 您正在构建一个多步骤代理，需要遍历 ClickUp 层级结构（工作区 → 空间 → 文件夹 → 列表 → 任务）以查找或整理工作项。

• 您需要与 ClickUp 以外的第三方应用集成 — 请改用 api-gateway skill。
• 您已拥有自己的 ClickUp OAuth 令牌，并希望直接调用 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 计划会议流程。