ClickUp

• AI 에이전트가 OAuth를 직접 설정하지 않고도 대신 ClickUp 작업 및 프로젝트를 생성, 업데이트 또는 조회하기를 원합니다.
• 회의 노트에서 작업 생성, 상태 업데이트, 외부 트리거에 따른 업무 배정 등 프로젝트 관리 워크플로를 자동화해야 합니다.
• 작업 생성, 상태 변경, 마감일 업데이트와 같은 이벤트에 반응하기 위해 ClickUp 웹훅을 프로그래밍 방식으로 등록하려고 합니다.
• ClickUp 계층 구조(워크스페이스 → 스페이스 → 폴더 → 목록 → 작업)를 탐색하여 작업 항목을 찾거나 정리해야 하는 멀티스텝 에이전트를 구축하고 있습니다.

• ClickUp 외의 서드파티 앱과 통합해야 하는 경우 — 대신 api-gateway skill을 사용하세요.
• 이미 자신의 ClickUp OAuth 토큰을 보유하고 있으며 프록시 레이어 없이 ClickUp API를 직접 호출하는 것을 선호하는 경우.

인증은 Maton 게이트웨이에서 처리됩니다. MATON_API_KEY만 있으면 되며, 게이트웨이가 프록시된 모든 요청에 ClickUp OAuth 토큰을 자동으로 주입합니다. OAuth 연결은 ctrl.maton.ai에서 관리됩니다.

담당자, 우선순위(긴급/높음/보통/낮음), 마감일, 태그, 하위 작업, 사용자 정의 필드 및 시간 추정치를 지원하여 작업을 생성, 읽기, 업데이트 및 삭제할 수 있습니다. 작업은 상태, 담당자, 마감일 범위 등으로 필터링할 수 있습니다.

ClickUp 구조의 모든 수준을 포괄합니다: 워크스페이스(팀), 스페이스, 폴더, 리스트, 그리고 태스크. 표준 REST 작업을 사용하여 계층 구조의 모든 수준에서 엔티티를 생성하거나 관리할 수 있습니다.

실시간 ClickUp 이벤트를 수신하기 위해 웹훅을 등록하고 관리하세요 — 작업 생성, 상태 변경, 담당자 업데이트, 마감일 변경, 댓글, 폴더/스페이스 라이프사이클 이벤트 등이 포함됩니다.

여러 ClickUp 계정이 연결되어 있는 경우, Maton-Connection 헤더를 사용하여 요청별로 특정 연결을 지정할 수 있습니다. 지정하지 않으면 게이트웨이는 기본적으로 가장 오래된 활성 연결을 사용합니다.

목록 엔드포인트는 페이지 기반 페이지네이션을 지원합니다(페이지당 최대 100개 항목). 응답에 포함된 last_page 불리언 값을 통해 대용량 결과 집합을 손쉽게 순회할 수 있습니다.

버그 보고서, 지원 티켓 또는 회의 메모가 도착하면, 에이전트가 수동 입력 없이 올바른 담당자, 우선순위 및 마감일과 함께 적절한 목록에 ClickUp 작업을 자동으로 생성할 수 있습니다.

에이전트는 워크스페이스의 스페이스, 폴더, 목록을 탐색하여 작업 상태를 수집한 후, 여러 팀에 걸친 일별 또는 주별 프로젝트 요약 보고서를 생성할 수 있습니다.

taskStatusUpdated 또는 taskAssigneeUpdated와 같은 이벤트에 대한 웹훅을 등록하여, 하위 시스템(Slack 알림, 캘린더 블록, CI/CD 파이프라인)이 ClickUp의 변경 사항에 실시간으로 반응할 수 있도록 합니다.

에이전트는 백로그 목록의 모든 작업을 읽고, 우선순위 및 담당자 가용성에 따라 필터링하며, 작업을 스프린트 폴더로 일괄 이동하거나 업데이트할 수 있습니다. 이를 통해 스프린트 계획 세션을 간소화할 수 있습니다.