ConstructionClock MCP Server

Ein lokaler Model Context Protocol-Server, der Claude Desktop zwei Zeiterfassungs-Werkzeuge für ConstructionClock bereitstellt. Er kommuniziert direkt über fetch mit der ConstructionClock-REST-API – ohne Browser-Automatisierung.

Werkzeuge

Zeitangaben sind ISO-8601 lokal, ohne Zeitzonensuffix, z. B. 2026-08-12T08:00:00 (das ist genau das Format, das ConstructionClock selbst sendet). employeeId wird an die API als userId übergeben. cc_edit_time benötigt ebenfalls die projectId – der Bearbeitungsendpunkt verlangt sie, nicht nur die Eintrags-ID.

Einrichtung

Node.js 18+ ist erforderlich (fetch ist eingebaut). Node.js wurde auf diesem Rechner am 2026-08-13 per winget installiert (OpenJS.NodeJS.LTS, Node v24.19.0); die Abhängigkeiten sind bereits installiert. Um die Abhängigkeiten nach einem Checkout neu zu installieren:

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

Der Server lädt .env relativ zu seiner eigenen Datei und funktioniert also unabhängig davon, aus welchem Arbeitsverzeichnis Claude Desktop ihn startet.

Dann legst du deinen Token in .env ab (Kopie aus .env.example):

CC_API_TOKEN=your-real-token

Den Token erhältst du aus dem Authorization-Header einer in den DevTools aufgezeichneten ConstructionClock-Anfrage.

Bei Claude Desktop registrieren

Füge dies deiner claude_desktop_config.json hinzu (%APPDATA%\Claude\claude_desktop_config.json):

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

Starte Claude Desktop neu. Die beiden cc_*-Werkzeuge sollten erscheinen.

Endpunkte (verifiziert)

Live von app.constructionclock.com am 2026-08-12 aufgezeichnet:

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

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

uuid wird vom Server pro Aufruf generiert. Falls ConstructionClock diese jemals ändert, steht alles, was du zum Bearbeiten brauchst, im CONFIG-Block am Anfang von src/server.js.

Budget-Leitplanke

Siehe BUDGET_GUARDRAILS.md – eine ständige Anweisung für Claude Desktop-Sitzungen, die budgetierten gegenüber den tatsächlichen Stunden in JobTread zu prüfen, bevor Zeiteinträge hinzugefügt oder bearbeitet werden.