Запуск учёта времени через MCP: связывание рабочих сессий с задачами

Справочник разработчика по MCP-инструменту start_time_tracking. Узнайте, как запустить таймер для задачи, предотвратить одновременный запуск нескольких таймеров и использовать шаблоны подтверждения. Включает проверки безопасности, примеры вызовов инструмента, запросы на естественном языке, крайние случаи и устранение неполадок.

Обзор инструмента

Назначение

Инструмент start_time_tracking запускает таймер для конкретной задачи. Используйте этот инструмент, чтобы отслеживать время, потраченное на работу, связывать сессии написания кода с задачами или начинать сессии концентрации. В одном рабочем пространстве одновременно может работать только один таймер.

⚠️ Операция записи: Этот инструмент изменяет данные — всегда используйте шаблоны подтверждения и проверяйте наличие уже запущенных таймеров перед его вызовом.

Входные параметры

Инструменту требуется идентификатор задачи для запуска учёта.

Формат вывода

Инструмент возвращает объект статуса учёта:

{
  "task_id": 123,
  "task_title": "Implement login feature",
  "started_at": "2026-03-19T10:30:00Z",
  "is_running": true
}

Проверки безопасности и шаблоны подтверждения

⚠️ Всегда сначала проверяйте наличие запущенного таймера

Никогда не позволяйте ИИ запускать таймер без проверки уже существующих таймеров. Используйте следующие шаблоны:

• Сначала проверьте статус: Вызовите get_tracking_status, чтобы проверить, не запущен ли уже таймер
• Остановите существующий таймер: Если таймер запущен, сначала остановите его или попросите пользователя подтвердить
• Подтвердите задачу: Покажите название и идентификатор задачи перед запуском таймера
• Токен подтверждения: Требуйте ввода "CONFIRM" перед вызовом start_time_tracking

Узнайте больше о безопасных рабочих процессах записи →

Шаблон безопасного запроса

✅ Шаблон безопасного запроса:

"I want to start tracking time on task #123. 
First, check if any timer is already running. 
If yes, ask me if I want to stop it first. 
Then show me the task title and wait for CONFIRM before starting the timer. 
If I don't type CONFIRM, don't start anything."

Примеры вызовов инструмента

Пример 1: Запуск таймера

Вызов инструмента (JSON):

{
  "tool": "start_time_tracking",
  "arguments": {
    "task_id": 123
  }
}

Возвращает: Статус учёта с task_id, task_title, started_at и is_running=true

Примеры запросов на естественном языке

Безопасный запуск таймера с проверкой статуса

Запрос пользователя:

"Start tracking time on the login feature task. Check if any timer is running first."

Поведение ИИ:

1. ИИ вызывает get_tracking_status, чтобы проверить наличие существующего таймера
2. Если таймер существует, ИИ предупреждает: "Timer already running on task X. Stop it first?"
3. Если таймера нет, ИИ находит задачу с помощью list_tasks или get_task
4. ИИ показывает: "Starting timer on: Login Feature (task #123)"
5. ИИ ждёт ввода "CONFIRM"
6. ИИ вызывает start_time_tracking только после подтверждения

Начало рабочей сессии

Запрос пользователя:

"I'm starting work on task #456. Start the timer, but check for existing timers first."

Поведение ИИ:

1. ИИ проверяет get_tracking_status
2. ИИ убеждается, что задача #456 существует, с помощью get_task
3. ИИ показывает предпросмотр и запрашивает подтверждение
4. После подтверждения ИИ запускает таймер

Типичные сценарии использования

• Основы учёта времени — запуск таймеров в начале работы над задачами
• Рабочий процесс редактора — связывание сессий написания кода с задачами через таймеры
• Ежедневная концентрация — запуск таймера на самой приоритетной задаче дня
• Сначала проверьте статус — всегда проверяйте наличие существующих таймеров перед запуском

Крайние случаи

Таймер уже запущен

Ситуация: Таймер уже запущен для другой задачи

Ответ:

{
  "error": "timer_already_running",
  "message": "Timer is already running for task 456",
  "current_task_id": 456,
  "current_task_title": "Previous Task",
  "started_at": "2026-03-19T09:00:00Z"
}

Обработка: Сначала остановите существующий таймер с помощью stop_time_tracking, затем запустите новый

Задача не найдена (404)

Ситуация: task_id не существует

Ответ:

{
  "error": "not_found",
  "message": "Task with ID 123 not found"
}

Обработка: Убедитесь, что идентификатор задачи указан правильно

Доступ запрещён (403)

Ситуация: Задача существует, но у вас нет прав на учёт времени

Ответ:

{
  "error": "forbidden",
  "message": "You don't have permission to track time for this task"
}

Обработка: Проверьте права доступа к задаче в Workify

Прочитайте руководство по устранению ошибки 403 →

Устранение неполадок

Таймер уже запущен

Симптом: Ошибка о том, что таймер уже запущен

Причины:

• Другой таймер активен для другой задачи
• Предыдущий таймер не был остановлен

Решение:

• Вызовите get_tracking_status, чтобы увидеть текущий таймер
• Вызовите stop_time_tracking, чтобы остановить существующий таймер
• Затем вызовите start_time_tracking для новой задачи

Задача не найдена (404)

Симптом: Ошибка 404 Not Found

Причины:

• Идентификатор задачи не существует
• Задача была удалена
• Неверный формат task_id

Решение:

• Убедитесь, что task_id указан правильно
• Используйте list_tasks или get_task, чтобы найти действительные идентификаторы
• Проверьте, существует ли задача до сих пор

Рекомендации

Безопасное использование start_time_tracking

• ✅ Всегда сначала вызывайте get_tracking_status, чтобы проверить наличие существующих таймеров
• ✅ Останавливайте существующий таймер перед запуском нового (или просите пользователя подтвердить)
• ✅ Убеждайтесь, что задача существует, с помощью get_task перед запуском таймера
• ✅ Показывайте пользователю название и идентификатор задачи перед запуском
• ✅ Требуйте явного подтверждения (токен CONFIRM)
• ✅ Используйте stop_time_tracking при переключении между задачами или завершении работы

Связанные инструменты

Часто используются вместе с:

• get_tracking_status — проверка наличия существующих таймеров перед запуском
• stop_time_tracking — остановка таймера при переключении задач или завершении работы
• get_task — проверка существования задачи перед запуском таймера
• Рабочие процессы наименьших привилегий — безопасные шаблоны рабочих процессов записи