tdcflow
TDC Flow MCP Server
TDC Flow REST API 上で動作する stdio MCP サーバーです。Claude Code が割り当てられたタスクを読み取り、タスクやサブタスクを提案・更新し、git 履歴から取得した実際の開始・終了時刻で時間を記録できるようにします。
セットアップ
認証にはブラウザのセッションクッキーを使用します。devtools で tdcflow.tdcapps.com 上の認証済みリクエストを開き、__Secure-better-auth.session_token クッキーをコピーして .env に保存してください:
cp .env.example .env
$EDITOR .envサーバーを Claude Code に登録します:
claude mcp add tdcflow --scope user /home/yashasvi/Developer/tdcflow-mcp/run.shクッキーの有効期限は7日間です。Session cookie is invalid or expired で呼び出しが失敗し始めたら、.env 内のクッキーを更新してください。
Related MCP server: Code Time Machine MCP Server
検証
test.mjs はサーバーを起動し、stdio 経由で実際の JSON-RPC を送信して、すべてのツールを実行します。書き込みテストは独自のフィクスチャを作成し、テスト後にそれを削除します:
node test.mjsツール
読み取り:
tdcflow_whoami: サインイン中のユーザーと組織
tdcflow_list_tasks: デフォルトでは自分の未完了タスク。担当者、ステータス、プロジェクト、タイトルで絞り込めます
tdcflow_get_task: 担当者とサブタスクを含む1件のタスク
tdcflow_list_drafts: 承認待ちの提案タスク(自分とチームのもの)
tdcflow_list_projects, tdcflow_list_phases, tdcflow_list_sprints, tdcflow_list_project_members, tdcflow_list_project_tasks
tdcflow_list_users, tdcflow_list_tags, tdcflow_list_time_categories
tdcflow_list_approvers: タイムシートを承認できる人
書き込み:
tdcflow_create_task: タスク、または
parentTaskIdを指定したサブタスクを提案します。assignToMe: falseを渡さない限り、自分に割り当てられます。tdcflow_update_task: ステータス、タイトル、日付、見積もり、配置を変更します
tdcflow_assign_task: タスクを自分に割り当てます
tdcflow_log_time: 明示的な
startedAtとendedAtを持つ1件のエントリを記録しますtdcflow_add_timesheet_entry: タイムシートの1日分に時間ベースのエントリを追加します
tdcflow_get_timesheet: エントリと合計を含む週次タイムシートを取得します
tdcflow_submit_timesheet: タイムシートを承認者に送信します
tdcflow_delete_time_entry, tdcflow_delete_task, tdcflow_add_tag
Git 履歴からの時間記録
現在の時刻ではなく、実際の時刻を渡します。範囲はコミット自体から取得します:
git log --since=2026-08-20 --author=Yashasvi --date=iso-strict \
--pretty='%ad %h %s'作業ブロックの最初と最後のコミットのタイムスタンプを、startedAt と endedAt として tdcflow_log_time に渡します。このツールは startedAt 以前の endedAt を拒否します。
権限の制限
サーバーはアカウントで実行できることをそのまま公開します。Yashasvi のアカウントでは:
tdcflow_create_taskはisDraft: trueのドラフトを返します。リードが承認するまで公開されません。ドラフトタスクに対して時間を計上することはできません。
tdcflow_add_timesheet_entryはこれをチェックし、API の紛らわしい「does not belong to this project」の代わりに明確な理由を示して失敗します。tdcflow_add_tagにはprojects:writeが必要で、403 を返します。tdcflow_delete_taskにはtasks:deleteが必要で、403 を返します。代わりにstatusをcancelledに設定してください。担当者ごとの工数は UI では読み取り専用のため、これを設定するツールはありません。代わりにタスクレベルの
estimatedMinutesを使用してください。すでに担当者である人を再割り当てすると 400 が返ります。
tdcflow_assign_taskは失敗する代わりに、それをalreadyAssignedとして報告します。
タイムシートの送信
送信すると実際の人物に通知され、期間がロックされるため、test.mjs はこれを実行しません。承認者は9人いるため、approverId を明示する必要があります。省略した場合、ツールはエラー内にそれらを一覧表示します。
tdcflow_submit_timesheet {
date: '2026-08-26',
note: 'Week of 24 August',
approverId: '019ea732-17d2-704a-9e52-c8dc2af0bfec'
}タイムシートの期間
期間は月曜から日曜までで、API は月曜日の日付をキーとして使用します。tdcflow_get_timesheet と tdcflow_add_timesheet_entry は、週内の任意の日付から期間を算出します。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Connects AI assistants to TrackingTime for querying time entries, projects, tasks, customers, and team data using natural language.
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to create conventional Git commits, update changelogs, and optionally push changes to remote repositories.22MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants like Claude to navigate git repository history, providing insights into code evolution and helping understand legacy systems.MIT
- AlicenseNot gradedqualityCmaintenanceProvides AI assistants with a Development Time Machine by analyzing git reflogs, commit history, working directory deltas, and shell history for temporal context, including safe git operations and smart commit generation.Apache 2.0
- AlicenseAqualityBmaintenanceEnables AI assistants to perform Git workflows with semantic commit messages, pre-PR secret audits, conflict resolution, and release changelog generation.5MIT