ClickUp MCP 서버

ClickUp 통합을 위한 모델 컨텍스트 프로토콜 서버 구현으로, AI 어시스턴트가 ClickUp 작업 공간과 상호 작용할 수 있습니다.

빠른 시작

1. 데스크톱에 Claude 구성:

지엑스피1

2. 데스크톱용 Claude 재시작

이제 완료되었습니다! 서버가 자동으로 다운로드되어 필요할 때 시작됩니다.

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 ClickUp MCP Server를 자동으로 설치하려면:

npx -y @smithery/cli install @Nazruden/clickup-mcp-server --client claude

Related MCP server: ClickUp MCP Sedrver

환경 변수

필수 환경 변수:

• CLICKUP_CLIENT_ID : ClickUp OAuth 클라이언트 ID

• CLICKUP_CLIENT_SECRET : ClickUp OAuth 클라이언트 비밀번호

• CLICKUP_REDIRECT_URI : OAuth 리디렉션 URI(기본값: http://localhost:3000/oauth/callback )

선택적 환경 변수:

• PORT : 서버 포트(기본값: 3000)

• LOG_LEVEL : 로깅 레벨(기본값: info)

사용 가능한 도구

작업 관리

• clickup_create_task : ClickUp 목록에 새 작업을 만듭니다.

• clickup_update_task : 기존 작업의 속성을 업데이트합니다.

팀 및 목록 관리

• clickup_get_teams : 접근 가능한 모든 팀을 검색합니다.

• clickup_get_lists : 특정 폴더의 모든 목록을 가져옵니다.

이사회 관리

• clickup_create_board : ClickUp 공간에 새 보드를 만듭니다.

개발

1. 저장소를 복제합니다

2. 종속성 설치:

npm install

3. 개발 모드에서 시작:

npm run dev

4. 프로덕션을 위해 빌드:

npm run build

5. 테스트 실행:

npm test

보안

• 모든 토큰은 저장 시 암호화됩니다.

• 보안 인증을 위한 OAuth2 흐름

• 민감한 데이터가 기록되지 않았습니다

• API 남용을 방지하기 위한 속도 제한

문제 해결

일반적인 문제

1. 인증 오류

   • 환경 변수에서 OAuth 자격 증명을 확인하세요.

   • 토큰 만료 확인

   • 적절한 리디렉션 URI를 확인하세요

2. 속도 제한

   • 서버는 자동 속도 제한 처리를 구현합니다.

   • 속도 제한 경고에 대한 로그를 확인하세요.

   • 요청 일괄 처리 구현을 고려하세요

3. 서버가 시작되지 않음

   • 환경 변수가 제대로 설정되었는지 확인하세요

   • 포트 3000을 사용할 수 있는지 확인하세요

   • Claude의 데스크톱 로그를 확인하세요

로그 가져오기

Claude for Desktop 로그는 다음에서 찾을 수 있습니다.

• Windows: %USERPROFILE%\AppData\Local\Claude\Logs\mcp*.log

• macOS: ~/Library/Logs/Claude/mcp*.log

특허

MIT 라이센스 - 자세한 내용은 라이센스 파일을 참조하세요.