Clockify MCP

Clockify MCP 서버

이 MCP 서버를 사용하면 LLM(예: Cursor 또는 Claude)이 Clockify 작업 공간과 상호 작용하여 고급 시간 추적 자동화 및 보고 기능을 활용할 수 있습니다. 이 서버를 통해 다음과 같은 작업을 수행할 수 있습니다.

• 작업 공간의 모든 프로젝트 나열
• 작업 공간의 모든 사용자 나열
• 자신 또는 다른 사용자(권한이 있는 경우)의 시간 항목을 추가하고 조회합니다.
• 모든 프로젝트의 모든 사용자에 대한 타임시트를 가져옵니다.
• Clockify 요약 보고서 API를 사용하여 사용자 및 프로젝트별 월별 또는 사용자 정의 날짜 범위 시간 세부 정보를 생성합니다.
• LLM과 통합하여 시간 추적 데이터를 자동화, 요약 또는 분석합니다.

특징

• listProjects: 인증된 사용자의 모든 프로젝트를 나열합니다.
• getTimeEntries: 인증된 사용자에 대한 시간 항목을 나열합니다(선택적 날짜 필터 포함)
• addTimeEntry: 프로젝트에 시간 항목 추가
• listUsers: 작업 공간에 있는 모든 사용자를 나열합니다.
• getUserTimeEntries: 모든 사용자의 시간 항목을 나열합니다(선택적 날짜 필터 포함)
• getSummaryReport: 특정 기간 동안 사용자/프로젝트별 시간 요약 보고서를 가져옵니다(선택적으로 userIds/projectIds로 필터링 가능). 모든 사용자 또는 프로젝트에 대한 월별/시간별 분석이 가능합니다.

빠른 시작(Docker — 권장)

Cursor/Claude를 위한 MCP 서버 구성

Cursor 또는 Claude settings.json 에 다음을 추가합니다( YOUR_API_KEY 교체합니다).

지엑스피1

Clockify API 키를 얻는 방법

1. Clockify 계정 에 로그인하세요.
2. 프로필 아이콘(오른쪽 상단)을 클릭하고 프로필을 선택하세요.
3. API 섹션까지 아래로 스크롤하세요.
4. API 키가 없으면 '생성'을 클릭하거나 기존 키를 복사하세요.

기여 및 CI/CD

이 프로젝트에서는 GitHub Actions를 사용하여 main 에 푸시할 때마다 Docker 이미지를 자동으로 빌드하고 GitHub Container Registry(GHCR)에 게시합니다.

• 이미지 URL: ghcr.io/inakianduaga/clockify-mcp:latest
• 이미지를 가져오는 방법:
  docker pull ghcr.io/inakianduaga/clockify-mcp:latest

GitHub 프로필이나 저장소의 "패키지" 섹션에서 게시된 이미지를 볼 수 있습니다.

메모리 뱅크 및 최적화

최적화된 규칙과 함께 커서를 사용하여 개발되었습니다. 참고: https://github.com/Bhartendu-Kumar/rules\_template