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 .env

Registriere den Server bei Claude Code:

claude mcp add tdcflow --scope user /home/yashasvi/Developer/tdcflow-mcp/run.sh

Das Cookie läuft nach sieben Tagen ab. Wenn Aufrufe mit Session cookie is invalid or expired fehlschlagen, aktualisiere es in .env.

Related MCP server: Povio Worklog 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.mjs

Werkzeuge

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 übergibst assignToMe: 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 startedAt und endedAt

• tdcflow_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_task gibt einen Entwurf mit isDraft: true zurück. Ein Lead genehmigt ihn, bevor er live geht.

• Zeit kann nicht gegen eine Entwurfsaufgabe gebucht werden. tdcflow_add_timesheet_entry prü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_tag benötigt projects:write und gibt 403 zurück.

• tdcflow_delete_task benötigt tasks:delete und gibt 403 zurück. Setze stattdessen status auf cancelled.

• Der Aufwand pro Bearbeiter ist in der UI schreibgeschützt, daher setzt kein Tool ihn. Verwende stattdessen estimatedMinutes auf Aufgabenebene.

• Das erneute Zuweisen einer Person, die bereits Bearbeiter ist, gibt 400 zurück. tdcflow_assign_task meldet das als alreadyAssigned, 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.