ClickUp MCP 서버

ClickUp API를 위한 MCP 서버를 사용하면 Claude가 ClickUp 작업 공간과 상호 작용할 수 있습니다.

도구

1. clickup_authenticate

   • API 토큰과 작업 공간 ID를 사용하여 ClickUp API로 인증합니다.

   • 필수 입력 사항:

     • api_token (문자열): 인증을 위한 ClickUp API 토큰

     • workspace_id (문자열): 인증을 위한 ClickUp 작업 공간 ID

   • 반환: 사용자 정보 및 인증 상태

2. clickup_get_task

   • ClickUp에서 작업 ID로 작업 검색

   • 필수 입력 사항:

     • api_token (문자열): 인증을 위한 ClickUp API 토큰

     • task_id (문자열): 검색할 ClickUp 작업의 ID

   • 반환: 설명, 상태 및 메타데이터를 포함한 자세한 작업 정보

3. clickup_get_task_by_custom_id

   • 사용자 정의 ID로 ClickUp에서 작업 검색

   • 필수 입력 사항:

     • api_token (문자열): 인증을 위한 ClickUp API 토큰

     • custom_id (문자열): 검색할 ClickUp 작업의 사용자 정의 ID

     • workspace_id (문자열): API 요청에 필요한 작업 공간 ID

   • 반환: 설명, 상태 및 메타데이터를 포함한 자세한 작업 정보

4. clickup_get_tasks

   • ClickUp에서 ID로 여러 작업을 검색합니다.

   • 필수 입력 사항:

     • api_token (문자열): 인증을 위한 ClickUp API 토큰

     • workspace_id (문자열): ClickUp 작업 공간 ID

     • task_ids (string[]): 검색할 작업 ID 목록

   • 반환: 전체 정보가 포함된 작업 목록

Related MCP server: clickup-custom-mcp

설정

1. ClickUp API 토큰을 받으세요:

   • ClickUp 계정에 로그인하세요

   • 설정 → 앱으로 이동

   • "API 토큰 생성"을 클릭하세요

   • API 토큰을 복사하세요

2. 작업 공간 ID 받기:

   • 브라우저에서 ClickUp을 엽니다.

   • 작업 공간 ID는 URL: https://app.clickup.com/{workspace_id}/home 에 있습니다.

   • 숫자로 시작하는 숫자입니다

Claude Desktop과 함께 사용

claude_desktop_config.json 에 다음을 추가하세요.

엔피엑스

지엑스피1

도커

{
  "mcpServers": {
    "clickup": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CLICKUP_API_TOKEN",
        "-e",
        "CLICKUP_WORKSPACE_ID",
        "mcp/clickup"
      ],
      "env": {
        "CLICKUP_API_TOKEN": "your-api-token",
        "CLICKUP_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

문제 해결

오류가 발생하면 다음 사항을 확인하세요.

1. 귀하의 API 토큰은 유효하며 만료되지 않았습니다.

2. 작업공간 ID가 정확합니다

3. ClickUp 작업 공간에 필요한 권한이 있습니다.

4. 액세스하려는 작업 ID가 존재하며 액세스할 수 있습니다.

짓다

Docker 빌드:

docker build -t mcp/clickup .

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.