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: Povio Worklog 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는 주 내의 모든 날짜에서 이를 계산합니다.