TDC Flow MCP Server

一个基于 TDC Flow REST API 的 stdio MCP 服务器，让 Claude Code 可以读取你被分配的任务、提出任务和子任务、更新它们，并从 git 历史中获取真实的开始和结束时刻来记录时间。

设置

身份验证使用浏览器会话 cookie。在 devtools 中打开 tdcflow.tdcapps.com 上的任何已认证请求，复制 __Secure-better-auth.session_token cookie，并将其放入 .env 中：

cp .env.example .env
$EDITOR .env

向 Claude Code 注册服务器：

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

该 cookie 七天后过期。当调用开始失败并提示 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 从不触发它。存在九个审批人，因此必须明确指定 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 会根据周内的任何日期计算出该周期。