Skip to main content
Glama

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: 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 从不触发它。存在九个审批人,因此必须明确指定 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…

    Related MCP Connectors

    Related MCP Servers