Clockify MCP 서버
이 MCP 서버를 사용하면 LLM(예: Cursor 또는 Claude)이 Clockify 작업 공간과 상호 작용하여 고급 시간 추적 자동화 및 보고 기능을 활용할 수 있습니다. 이 서버를 통해 다음과 같은 작업을 수행할 수 있습니다.
작업 공간의 모든 프로젝트 나열
작업 공간의 모든 사용자 나열
자신 또는 다른 사용자(권한이 있는 경우)의 시간 항목을 추가하고 조회합니다.
모든 프로젝트의 모든 사용자에 대한 타임시트를 가져옵니다.
Clockify 요약 보고서 API를 사용하여 사용자 및 프로젝트별 월별 또는 사용자 정의 날짜 범위 시간 세부 정보를 생성합니다.
LLM과 통합하여 시간 추적 데이터를 자동화, 요약 또는 분석합니다.
특징
listProjects: 인증된 사용자의 모든 프로젝트를 나열합니다.
getTimeEntries: 인증된 사용자에 대한 시간 항목을 나열합니다(선택적 날짜 필터 포함)
addTimeEntry: 프로젝트에 시간 항목 추가
listUsers: 작업 공간에 있는 모든 사용자를 나열합니다.
getUserTimeEntries: 모든 사용자의 시간 항목을 나열합니다(선택적 날짜 필터 포함)
getSummaryReport: 특정 기간 동안 사용자/프로젝트별 시간 요약 보고서를 가져옵니다(선택적으로 userIds/projectIds로 필터링 가능). 모든 사용자 또는 프로젝트에 대한 월별/시간별 분석이 가능합니다.
Related MCP server: XcodeBuildMCP
빠른 시작(Docker — 권장)
Cursor/Claude를 위한 MCP 서버 구성
Cursor 또는 Claude settings.json 에 다음을 추가합니다( YOUR_API_KEY 교체합니다).
지엑스피1
Clockify API 키를 얻는 방법
Clockify 계정 에 로그인하세요.
프로필 아이콘(오른쪽 상단)을 클릭하고 프로필을 선택하세요.
API 섹션까지 아래로 스크롤하세요.
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
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.