ConstructionClock MCP Server

Локальный сервер на базе Model Context Protocol, который предоставляет Claude Desktop два инструмента для ввода рабочего времени в ConstructionClock. Он обращается к REST API ConstructionClock напрямую через fetch — без браузерной автоматизации.

Инструменты

Время указывается в формате ISO-8601 локальное, без указания часового пояса, например 2026-08-12T08:00:00 (именно в таком формате его отправляет сам ConstructionClock). employeeId передаётся в API как userId. Для cc_edit_time также нужен projectId — эндпоинт редактирования требует его, а не только идентификатор записи.

Установка

Требуется Node.js 18+ (fetch встроен). Он установлен на этой машине 2026-08-13 через winget (OpenJS.NodeJS.LTS, Node v24.19.0), зависимости уже установлены. Чтобы переустановить зависимости после checkout:

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

Сервер загружает .env относительно своего собственного файла, поэтому он работает независимо от рабочей директории, в которой его запускает Claude Desktop.

Затем добавьте свой токен в .env (скопируйте из .env.example):

CC_API_TOKEN=your-real-token

Токен возьмите из заголовка Authorization в перехваченном запросе ConstructionClock в DevTools.

Регистрация в 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_* должны появиться.

Эндпоинты (проверено)

Перехвачено вживую с app.constructionclock.com 2026-08-12:

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

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

uuid генерируется сервером при каждом вызове. Если ConstructionClock когда-либо изменит этот механизм, всё, что нужно поправить, находится в блоке CONFIG в начале src/server.js.

Бюджетное ограничение

См. BUDGET_GUARDRAILS.md — это постоянная инструкция для сессий Claude Desktop: перед редактированием времени сверяй плановые и фактические показатели JobTread.