ConstructionClock MCP Server

Un servidor local del Model Context Protocol que le da a Claude Desktop dos herramientas de registro de horas de ConstructionClock. Se comunica directamente con la API REST de ConstructionClock con fetch — sin automatización del navegador.

Herramientas

Las horas son ISO-8601 locales, sin sufijo de zona horaria, p. ej. 2026-08-12T08:00:00 (ese es el formato que envía el propio ConstructionClock). employeeId se envía a la API como userId. cc_edit_time también necesita projectId — el endpoint de edición lo requiere, no solo el id de la entrada.

Configuración

Se requiere Node.js 18+ (fetch está integrado). Instalado en esta máquina el 2026-08-13 mediante winget (OpenJS.NodeJS.LTS, Node v24.19.0) y las dependencias ya están instaladas. Para reinstalar las dependencias después de un checkout:

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

El servidor carga .env de forma relativa a su propio archivo, por lo que funciona sin importar el directorio de trabajo desde el que Claude Desktop lo inicie.

Luego pon tu token en .env (copia desde .env.example):

CC_API_TOKEN=your-real-token

Obtén el token del encabezado Authorization de una petición a ConstructionClock capturada en DevTools.

Regístralo con Claude Desktop

Añade esto a tu 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"]
    }
  }
}

Reinicia Claude Desktop. Las dos herramientas cc_* deberían aparecer.

Endpoints (verificados)

Capturados en vivo desde app.constructionclock.com el 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 }

El servidor genera un uuid por cada llamada. Si ConstructionClock llegara a cambiar estos endpoints, todo lo que necesitas editar está en el bloque CONFIG al principio de src/server.js.

Protección de presupuesto

Consulta BUDGET_GUARDRAILS.md — una instrucción permanente para que las sesiones de Claude Desktop revisen las horas presupuestadas frente a las reales en JobTread antes de añadir o editar horas.