Clockify Timer MCP Server

Clockify 타이머를 관리하기 위한 최소한의 MCP 서버입니다. 타이머를 시작/중지하고, 실행 중인 항목을 확인하고, 최근 항목을 볼 수 있습니다 — 모두 Claude를 통해서입니다.

도구

설정

1. Clockify API 토큰 가져오기

Clockify 프로필 설정으로 이동 → "API"까지 스크롤 → API 키를 생성하거나 복사합니다.

2. Claude Desktop 구성하기

claude_desktop_config.json에 추가합니다:

{
  "mcpServers": {
    "clockify": {
      "command": "npx",
      "args": ["tsx", "/ABSOLUTE/PATH/TO/clockify-mcp/src/index.ts"],
      "env": {
        "CLOCKIFY_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

3. 사용하기

• "API 리팩터링 작업 타이머 시작해 줘"

• "지금 실행 중인 타이머가 뭐야?"

• "타이머 중지해 줘"

• "최근 시간 항목 5개 보여 줘"

• "Acme 프로젝트에서 회의 준비 시간 추적을 청구 가능으로 시작해 줘"

보안 참고 사항

• 공유 가변 상태 없음 — 클라이언트 구성은 불변이며 전역 싱글턴이 없습니다.

• 모든 Clockify ID 검증은 URL 보간 전에 24자 16진수 패턴과 대조됩니다 (경로 탐색 방지).

• axios 없음 — 네이티브 fetch를 사용하므로 HTTP 의존성 취약점이 없습니다.

• 오류 정화 — API 오류는 잘리며 인증 헤더를 절대 누출하지 않습니다.

• 빠른 실패 — API 토큰이 없으면 즉시 종료됩니다.

• npm audit 취약점 0개 (생성 시점 기준).