ClickUp

• AIエージェントに代わって、OAuthを自分でセットアップすることなく、ClickUpのタスクやプロジェクトの作成・更新・照会を行わせたい場合。
• 会議メモからのタスク作成、ステータスの更新、外部トリガーに基づく作業の割り当てなど、プロジェクト管理ワークフローを自動化する必要がある場合。
• タスクの作成、ステータスの変更、期日の更新などのイベントに対応するために、ClickUpのWebhookをプログラムで登録したい場合。
• ClickUpの階層（ワークスペース → スペース → フォルダー → リスト → タスク）をたどって作業アイテムを検索・整理する必要がある、マルチステップエージェントを構築している場合。

• ClickUp以外のサードパーティアプリと連携する必要がある場合は、代わりにapi-gateway skillを使用してください。
• すでに自分のClickUp OAuthトークンを持っており、プロキシレイヤーなしでClickUp APIを直接呼び出すことを希望する場合。

認証はMatonゲートウェイによって処理されます。必要なのは MATON_API_KEY のみです。ゲートウェイがプロキシされたすべてのリクエストに対して、ClickUp OAuthトークンを自動的に注入します。OAuth接続は ctrl.maton.ai で管理されます。

担当者、優先度（緊急／高／通常／低）、期日、タグ、サブタスク、カスタムフィールド、作業時間見積もりに対応したタスクの作成・取得・更新・削除が可能です。タスクはステータス、担当者、期日の範囲などの条件でフィルタリングできます。

ClickUp構造のすべてのレベルをカバーします：ワークスペース（チーム）、スペース、フォルダー、リスト、タスク。標準的なREST操作を使用して、階層のあらゆるレベルでエンティティを作成または管理できます。

タスクの作成、ステータスの変更、担当者の更新、期日の変更、コメント、フォルダー/スペースのライフサイクルイベントなど、ClickUpのリアルタイムイベントを受信するためのWebhookを登録および管理します。

複数のClickUpアカウントが接続されている場合、Maton-Connection ヘッダーを使用してリクエストごとに特定の接続を指定できます。指定しない場合、ゲートウェイはデフォルトで最も古いアクティブな接続を使用します。

リストエンドポイントはページベースのページネーション（1ページあたり最大100件）をサポートしています。レスポンス内のlast_pageブール値により、大きな結果セットを順番に処理することが簡単になります。

バグレポート、サポートチケット、またはミーティングメモが届いたとき、エージェントは手動入力なしで、適切な担当者、優先度、期限を設定した上で、正しいリストにClickUpタスクを自動的に作成できます。

エージェントはワークスペース内のスペース、フォルダー、リストを横断してタスクのステータスを収集し、複数のチームにわたる日次または週次のプロジェクトサマリーレポートを生成することができます。

taskStatusUpdated や taskAssigneeUpdated などのイベントに対してWebhookを登録することで、ClickUpの変更に対してダウンストリームシステム（Slack通知、カレンダーブロック、CI/CDパイプラインなど）がリアルタイムに反応できるようになります。

エージェントはバックログリスト内のすべてのタスクを読み取り、優先度と担当者の空き状況でフィルタリングし、タスクをスプリントフォルダーに一括移動または更新することができます。これにより、スプリント計画セッションが効率化されます。