TDC Flow MCP-сервер

stdio MCP-сервер поверх REST API TDC Flow, позволяющий Claude Code читать ваши назначенные задачи, предлагать задачи и подзадачи, обновлять их и регистрировать время с реальными моментами начала и окончания, взятыми из истории git.

Настройка

Аутентификация — это cookie браузерной сессии. Откройте любой аутентифицированный запрос на tdcflow.tdcapps.com в devtools, скопируйте cookie __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

Cookie истекает через семь дней. Когда вызовы начинают завершаться с ошибкой Session cookie is invalid or expired, обновите его в .env.

Related MCP server: Povio Worklog MCP Server

Проверка

test.mjs запускает сервер, общается по реальному JSON-RPC через stdio и проверяет каждый инструмент. Тесты на запись создают собственные фикстуры и удаляют их после:

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'

Передайте временные метки первого и последнего коммитов рабочего блока в tdcflow_log_time как startedAt и endedAt. Инструмент отклоняет endedAt, если он раньше или равен startedAt.

Ограничения прав

Сервер показывает всё, что может делать учётная запись. На аккаунте Yashasvi:

• tdcflow_create_task возвращает черновик с isDraft: true. Руководитель утверждает его, прежде чем он станет активным.

• Время нельзя забронировать для черновой задачи. tdcflow_add_timesheet_entry проверяет это и завершается с понятной причиной вместо вводящего в заблуждение сообщения API "does not belong to this project".

• tdcflow_add_tag требует projects:write и возвращает 403.

• tdcflow_delete_task требует tasks:delete и возвращает 403. Вместо этого установите status в cancelled.

• Затраты на каждого исполнителя доступны только для чтения в интерфейсе, поэтому ни один инструмент их не устанавливает. Используйте вместо этого 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 вычисляют это по любой дате внутри недели.