Задачи и MCP

Привязка todo-листа к компании, todoListId в URL и работа встроенных todo-инструментов

Зачем `todoListId` в MCP URL

Многие инструменты Timelix работают не абстрактно, а с конкретным списком задач. Поэтому в контексте MCP (ToolExecutionContext) передаётся todoListId:

либо как query-параметр в legacy URL
либо через MCP-токен доступа

Если todoListId отсутствует, инструменты, которые его валидируют, вернут понятную ошибку.

Откуда список берётся в продукте

У блока компании (type: company) в content может храниться поле todoListId — ID блока, который считается корнем задач этой компании.

Когда Timelix строит mcpServerUrl для чата или N8N, он поднимает родителя роли-агента. Если это компания и там заполнен todoListId, параметр уходит в URL как todoListId.

Зачем ещё нужен `timezone`

В MCP URL можно передать и timezone, например Europe/Moscow. Этот параметр нужен инструментам, которые создают или меняют календарное расписание задач, прежде всего createTodo и updateTodo.

Для преобразования в UTC используется getTimezoneOffset из features/TimelixTools/context.ts.

Рекомендуемый путь тот же: не собирать URL вручную, а использовать mcpServerUrl, который уже сформировал Timelix.

Какие todo-tools от этого зависят

В built-in реестре Timelix от todoListId зависят, в том числе:

readTodos — чтение задач из текущего списка, включая подзадачи, планы и состояние focus/backlog
createTodo — создание новой задачи, в том числе сразу с расписанием через scheduledDate / scheduledTime
updateTodo — обновление задачи, её статуса, приоритета, планов, положения в focus/backlog и календарного расписания
deleteTodo — мягкое или полное удаление задачи
addTaskPlan — создание плана выполнения как дочернего plan-блока задачи
proposeTask — предложение задачи пользователю вместо мгновенного создания

todoListId напрямую валидируют в первую очередь readTodos и createTodo. Остальные todo-инструменты чаще опираются уже на todoId, planId и proposal-данные.

Точные аргументы и поведение см. в features/TimelixTools/definitions/todos/.

Практическая настройка

Укажите у компании корректный todoListId.
Убедитесь, что роль агента является ребёнком этой компании.
Передавайте в MCP URL agentId, чтобы сервер загрузил правильный набор инструментов.
Если задачи используют даты и расписание, передавайте timezone.

Связанные разделы

MCP-сервер Timelix — полный список query-параметров
Блоковая модель данных — почему компания и роль являются блоками

Зачем todoListId в MCP URL