ConstructionClock MCP Server

로컬에서 실행되는 Model Context Protocol 서버로, Claude Desktop에 ConstructionClock 시간 입력 도구 두 개를 제공합니다. ConstructionClock REST API와 fetch로 직접 통신하며, 브라우저 자동화가 필요하지 않습니다.

도구

시간 값은 ISO-8601 현지 시간이며 시간대 접미사가 없습니다. 예: 2026-08-12T08:00:00 (ConstructionClock 자체도 이 형식으로 보냅니다). employeeId는 API에 userId로 전달됩니다. cc_edit_time은 projectId도 필요합니다. 편집 엔드포인트가 항목 ID뿐 아니라 프로젝트 ID도 요구하기 때문입니다.

설정

Node.js 18+가 필요합니다 (fetch는 내장되어 있습니다). 2026-08-13에 winget으로 이 머신에 설치했으며 (OpenJS.NodeJS.LTS, Node v24.19.0), 의존성도 이미 설치되어 있습니다. 체크아웃 후 의존성을 재설치하려면:

cd "C:\Users\15049\OneDrive\Desktop\Claude\Tools\ConstructionClock-MCP"
npm install

서버는 .env를 서버 자신의 파일 기준으로 로드하므로, Claude Desktop이 어떤 작업 디렉터리에서 실행하든 정상 작동합니다.

그런 다음 .env에 토큰을 입력하세요 (.env.example에서 복사):

CC_API_TOKEN=your-real-token

토큰은 DevTools에서 캡처한 ConstructionClock 요청의 Authorization 헤더에서 가져옵니다.

Claude Desktop에 등록

다음을 claude_desktop_config.json(%APPDATA%\Claude\claude_desktop_config.json)에 추가하세요:

{
  "mcpServers": {
    "constructionclock": {
      "command": "node",
      "args": ["C:\\Users\\15049\\OneDrive\\Desktop\\Claude\\Tools\\ConstructionClock-MCP\\src\\server.js"]
    }
  }
}

Claude Desktop을 다시 시작하면 cc_* 도구 두 개가 나타나야 합니다.

엔드포인트 (검증됨)

2026-08-12에 app.constructionclock.com 실서버에서 캡처한 내용입니다:

ADD   POST  /api/punches
      { "punches": [ { userId, projectId, uuid, clockedInAt, clockedOutAt } ] }

EDIT  PATCH /api/punch/edit/time
      { id, projectId, date: { dateFrom, dateTo }, uuid }

uuid는 서버가 호출할 때마다 생성합니다. 만약 ConstructionClock이 이 항목들을 변경한다면, 수정해야 할 모든 내용은 src/server.js 상단의 CONFIG 블록에 있습니다.

예산 가드레일

참고: BUDGET_GUARDRAILS.md — Claude Desktop 세션이 시간을 추가하거나 수정하기 전에 JobTread의 예산 대비 실제 시간을 확인하도록 하는 상시 지침입니다.