ConstructionClock MCP Server

Claude Desktop に ConstructionClock のタイムエントリツールを 2 つ提供する、ローカルの Model Context Protocol サーバーです。ブラウザ自動化は一切行わず、fetch で ConstructionClock REST API と直接通信します。

ツール

時刻は ISO-8601 ローカル時刻で、タイムゾーン接尾辞なし です。例: 2026-08-12T08:00:00 (これは ConstructionClock 自体が送信する形式です)。employeeId は API には userId として送信されます。cc_edit_time にも projectId が必要です — 編集エンドポイントはエントリ ID だけでなく、projectId を必要とするためです。

セットアップ

必要要件は 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_* の 2 つのツールが表示されるはずです。

エンドポイント (確認済み)

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 の予算対実績 (budgeted-vs-actual) 時間を確認するための常設指示です。