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 .envClaude 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: 담당자 및 하위 작업이 포함된 단일 작업
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이 포함된 단일 항목tdcflow_add_timesheet_entry: 타임시트 날짜에 기간 기반 항목 추가
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에 전달하세요. 도구는 endedAt이 startedAt과 같거나 이전이면 거부합니다.
권한 제한
서버는 계정이 할 수 있는 작업을 그대로 표시합니다. Yashasvi의 계정에서:
tdcflow_create_task는isDraft: true인 초안을 반환합니다. 리드가 승인한 후에만 활성화됩니다.초안 작업에는 시간을 기록할 수 없습니다.
tdcflow_add_timesheet_entry는 이를 확인하고 API의 오해를 불러일으키는 "이 프로젝트에 속하지 않음" 대신 명확한 이유로 실패합니다.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…
This server cannot be deployed
Maintenance
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