MCP 서버

ClickUp 작업을 AI 애플리케이션과 통합하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 AI 에이전트는 표준화된 프로토콜을 통해 ClickUp 작업, 공간, 목록 및 폴더와 상호 작용할 수 있습니다.

🚧 상태 업데이트: - 코드 리팩토링이 완료되었습니다. - 향상된 마감일 기능이 이제 ClickUp에서 적절한 시간 표시와 함께 "지금부터 2시간 후"와 같은 상대 시간 표현을 지원합니다. - npx 명령이 @latest를 사용하도록 업데이트되었으며, 새 버전이 출시되면 자동으로 서버를 업데이트합니다. - 서버가 Smithery, Glama, Pulse MCP에 등록되었습니다.

빠른 시작

Cursor Composer Agent와 함께 사용하는 방법:

신임장을 받으세요:
- ClickUp 설정 의 ClickUp API 키
- ClickUp 작업 공간 URL의 팀 ID
설정(또는 버전에 따라 MCP 서버)에서 기능으로 이동하세요.
MCP 서버에 추가:

지엑스피1

자격 증명을 교체하고 저장을 클릭하세요.
자연어를 사용해 ClickUp Workspace와 상호작용하세요!

스미서리 설치

서버는 Smithery에도 호스팅됩니다. Smithery에서 사용 가능한 도구를 미리 보거나 특정 클라이언트 앱에서 실행할 명령을 복사할 수 있습니다.

특징

🎯 작업 관리
- 개별 작업 생성, 업데이트 및 삭제
- 목록, 공간 및 폴더 간에 작업 이동 및 복제
- 여러 작업을 대량으로 생성, 업데이트, 이동 및 삭제
- 작업 세부 정보 및 속성을 보고 수정합니다.
- 자연어와 상대 시간 표현을 사용하여 마감일 설정
📂 작업 공간 구성
- 전체 작업 공간 계층(공간, 폴더, 목록)
- 명확한 관계가 있는 트리 구조
- 작업 공간 구성 요소에 대한 전체 CRUD 작업
- 효율적인 경로 기반 탐색
🔄 통합 기능
- 이름 또는 ID 기반 항목 조회
- 대소문자 구분 없이 이름 일치
- 마크다운 서식 지원
- 내장 API 속도 제한

사용 가능한 도구

도구	설명	필수 매개변수
get_workspace_hierarchy	작업 공간 구조 가져오기	없음
작업 생성	작업 만들기	`name` , ( `listId` / `listName` )
대량 작업 생성	여러 작업 만들기	`tasks[]`
업데이트_작업	작업 수정	`taskId` / `taskName`
업데이트_대량_작업	여러 작업 업데이트	ID 또는 이름이 있는 `tasks[]`
get_tasks	목록에서 작업 가져오기	`listId` / `listName`
get_task	작업 세부 정보 가져오기	`taskId` / `taskName`
삭제_작업	작업 제거	`taskId` / `taskName`
대량 작업 삭제	여러 작업 제거	ID 또는 이름이 있는 `tasks[]`
이동_작업	작업 이동	`taskId` / `taskName` , `listId` / `listName`
대량 작업 이동	여러 작업 이동	ID 또는 이름이 있는 `tasks[]` , 대상 목록
중복 작업	복사 작업	`taskId` / `taskName` , `listId` / `listName`
생성_리스트	공간에 목록 만들기	`name` , `spaceId` / `spaceName`
폴더 생성	폴더 만들기	`name` , `spaceId` / `spaceName`
폴더에_목록_만들기	폴더에 목록 만들기	`name` , `folderId` / `folderName`
폴더 가져오기	폴더 세부 정보 가져오기	`folderId` / `folderName`
업데이트_폴더	폴더 속성 업데이트	`folderId` / `folderName`
폴더 삭제	폴더 삭제	`folderId` / `folderName`
get_list	목록 세부 정보 가져오기	`listId` / `listName`
업데이트_목록	목록 속성 업데이트	`listId` / `listName`
삭제_목록	목록 삭제	`listId` / `listName`

선택적 매개변수와 고급 사용법에 대한 전체 문서를 참조하세요.

사용 가능한 프롬프트

아직 구현되지 않았거나 필요하지 않음. 지금은 도구 결과가 나온 후에 후속 메시지를 보낼 수 있습니다.

즉각적인	목적	특징
요약 작업	작업 개요	상태 요약, 우선순위, 관계
분석_우선순위	우선순위 최적화	분포 분석, 시퀀싱
생성_설명	작업 설명 생성	목표, 기준, 종속성

오류 처리

서버는 다음에 대한 명확한 오류 메시지를 제공합니다.

필수 매개변수가 없습니다
잘못된 ID 또는 이름
항목을 찾을 수 없습니다
권한 문제
API 오류
속도 제한

개발자 지원

이 프로젝트가 유용하다고 생각되면 지원을 고려해 주세요.

기여하다

기여를 환영합니다! 자세한 내용은 기여 가이드를 참조하세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

부인 성명

면책 조항: 이 소프트웨어는 타사 API를 사용하며 타사가 소유한 상표 또는 브랜드를 참조할 수 있습니다. 이러한 API 또는 참조의 사용은 해당 회사와의 제휴 또는 보증을 의미하지 않습니다. 모든 상표 및 브랜드 이름은 해당 소유자의 자산입니다. 이 프로젝트는 독립적인 저작물이며 언급된 타사와 공식적으로 제휴하거나 후원받지 않습니다.

ClickUp MCP Server

Integrations