tdcflow
TDC Flow MCP Server
Ein stdio MCP Server über die TDC Flow REST API, damit Claude Code deine zugewiesenen Aufgaben lesen, Aufgaben und Unteraufgaben vorschlagen, aktualisieren und Zeit mit echten Start- und Endzeitpunkten aus der Git-Historie protokollieren kann.
Einrichtung
Die Authentifizierung erfolgt über das Browser-Session-Cookie. Öffne eine beliebige authentifizierte Anfrage auf tdcflow.tdcapps.com in devtools, kopiere das Cookie __Secure-better-auth.session_token und füge es in .env ein:
cp .env.example .env
$EDITOR .envRegistriere den Server bei Claude Code:
claude mcp add tdcflow --scope user /home/yashasvi/Developer/tdcflow-mcp/run.shDas Cookie läuft nach sieben Tagen ab. Wenn Aufrufe mit Session cookie is invalid or expired fehlschlagen, aktualisiere es in .env.
Related MCP server: Code Time Machine MCP Server
Validierung
test.mjs startet den Server, spricht echtes JSON-RPC über stdio und testet jedes Tool. Schreibtests erstellen ihre eigenen Fixtures und räumen sie danach wieder auf:
node test.mjsWerkzeuge
Lesen:
tdcflow_whoami: der angemeldete Benutzer und die Organisation
tdcflow_list_tasks: standardmäßig deine offenen Aufgaben; filtere nach Bearbeiter, Status, Projekt oder Titel
tdcflow_get_task: eine Aufgabe mit Bearbeitern und Unteraufgaben
tdcflow_list_drafts: vorgeschlagene Aufgaben, die auf Genehmigung warten, deine und die deines Teams
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: wer einen Stundenzettel genehmigen kann
Schreiben:
tdcflow_create_task: eine Aufgabe vorschlagen, oder eine Unteraufgabe mit
parentTaskId. Weist sie dir zu, es sei denn, du übergibstassignToMe: false.tdcflow_update_task: Status, Titel, Daten, Schätzung oder Platzierung ändern
tdcflow_assign_task: eine Aufgabe dir selbst zuweisen
tdcflow_log_time: einen Eintrag mit explizitem
startedAtundendedAttdcflow_add_timesheet_entry: einen dauerbasierten Eintrag an einem Stundenzetteltag
tdcflow_get_timesheet: den wöchentlichen Stundenzettel mit seinen Einträgen und Summen
tdcflow_submit_timesheet: einen Stundenzettel an einen Genehmiger senden
tdcflow_delete_time_entry, tdcflow_delete_task, tdcflow_add_tag
Zeiterfassung aus der Git-Historie
Verwende echte Zeitpunkte anstatt der aktuellen Uhrzeit. Nimm den Bereich aus den Commits selbst:
git log --since=2026-08-20 --author=Yashasvi --date=iso-strict \
--pretty='%ad %h %s'Übergib den ersten und letzten Commit-Zeitstempel eines Arbeitsblocks an tdcflow_log_time als startedAt und endedAt. Das Tool lehnt ein endedAt ab, das gleich oder vor startedAt liegt.
Berechtigungsgrenzen
Der Server zeigt, was das Konto tun kann. Auf Yashasvis Konto:
tdcflow_create_taskgibt einen Entwurf mitisDraft: truezurück. Ein Lead genehmigt ihn, bevor er live geht.Zeit kann nicht gegen eine Entwurfsaufgabe gebucht werden.
tdcflow_add_timesheet_entryprüft dies und schlägt mit einem klaren Grund fehl, anstatt der irreführenden Meldung der API "does not belong to this project".tdcflow_add_tagbenötigtprojects:writeund gibt 403 zurück.tdcflow_delete_taskbenötigttasks:deleteund gibt 403 zurück. Setze stattdessenstatusaufcancelled.Der Aufwand pro Bearbeiter ist in der UI schreibgeschützt, daher setzt kein Tool ihn. Verwende stattdessen
estimatedMinutesauf Aufgabenebene.Das erneute Zuweisen einer Person, die bereits Bearbeiter ist, gibt 400 zurück.
tdcflow_assign_taskmeldet das alsalreadyAssigned, anstatt zu scheitern.
Einreichen eines Stundenzettels
Das Einreichen benachrichtigt eine echte Person und sperrt den Zeitraum, daher löst test.mjs es nie aus. Es gibt neun Genehmiger, daher muss approverId explizit angegeben werden; das Tool listet sie in seiner Fehlermeldung auf, wenn du sie weglässt.
tdcflow_submit_timesheet {
date: '2026-08-26',
note: 'Week of 24 August',
approverId: '019ea732-17d2-704a-9e52-c8dc2af0bfec'
}Stundenzettelzeiträume
Die Zeiträume laufen von Montag bis Sonntag und die API schlüsselt sie nach dem Montagsdatum auf. tdcflow_get_timesheet und tdcflow_add_timesheet_entry ermitteln das aus einem beliebigen Datum innerhalb der Woche.
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