tdcflow
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…
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