Остановка учёта времени через MCP: фиксация результатов и сводок

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

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

Назначение

Инструмент stop_time_tracking останавливает текущий запущенный таймер и фиксирует затраченное время. Используйте этот инструмент, чтобы завершать рабочие сессии, переключаться между задачами или фиксировать время с необязательной сводкой о том, что было выполнено.

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

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

Все параметры необязательны. Если сводка не указана, таймер останавливается без комментария-сводки.

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

Инструмент возвращает объект остановленного учёта с длительностью и сводкой:

{
  "task_id": 123,
  "task_title": "Implement login feature",
  "started_at": "2026-03-19T10:30:00Z",
  "stopped_at": "2026-03-19T12:45:00Z",
  "duration_minutes": 135,
  "duration_hours": 2.25,
  "summary": "Completed OAuth integration",
  "comment_id": 5
}

Поля ответа

• task_id: Идентификатор задачи, для которой вёлся учёт
• task_title: Название задачи (для удобства)
• started_at: Метка времени запуска таймера
• stopped_at: Метка времени остановки таймера
• duration_minutes: Общая длительность в минутах
• duration_hours: Общая длительность в часах (десятичное число)
• summary: Текст сводки, если он был указан (null, если не указан)
• comment_id: Идентификатор созданного комментария, если сводка была указана (иначе null)

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

⚠️ Всегда просматривайте длительность перед остановкой

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

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

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

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

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

"I want to stop the timer. 
First, check what timer is running and show me how long it's been running. 
Show me the summary I'll add (if any), then wait for CONFIRM before stopping. 
If I don't type CONFIRM, don't stop anything."

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

Пример 1: Остановка таймера без сводки

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

{
  "tool": "stop_time_tracking",
  "arguments": {}
}

Возвращает: Объект остановленного учёта с длительностью, комментарий не создаётся

Пример 2: Остановка таймера со сводкой

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

{
  "tool": "stop_time_tracking",
  "arguments": {
    "summary": "Completed OAuth integration and wrote tests"
  }
}

Возвращает: Объект остановленного учёта с длительностью и сводкой, к задаче создаётся комментарий

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

Безопасная остановка таймера с предпросмотром

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

"Stop the timer. Show me how long it's been running first, then wait for CONFIRM."

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

1. ИИ вызывает get_tracking_status, чтобы увидеть текущий таймер
2. ИИ вычисляет длительность: "Timer running for 2 hours 15 minutes on: Login Feature"
3. ИИ показывает предпросмотр и ждёт ввода "CONFIRM"
4. ИИ вызывает stop_time_tracking только после подтверждения
5. ИИ подтверждает, что таймер был остановлен

Остановка со сводкой

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

"Stop the timer and add a summary: 'Completed OAuth integration'. Show me what you'll do first."

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

1. ИИ проверяет get_tracking_status на предмет текущего таймера
2. ИИ показывает: "Stopping timer (2h 15m), adding comment: 'Completed OAuth integration'"
3. ИИ ждёт подтверждения
4. ИИ вызывает stop_time_tracking со сводкой
5. ИИ подтверждает, что таймер остановлен и комментарий добавлен

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

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

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

Нет запущенного таймера

Ситуация: В данный момент нет активного таймера

Ответ:

{
  "error": "no_timer_running",
  "message": "No timer is currently running"
}

Обработка: Это нормально — проверьте, был ли таймер уже остановлен или вообще не запускался

Таймер не найден

Ситуация: Таймер был остановлен или сброшен другим процессом

Ответ: Такой же, как ошибка "no timer running"

Обработка: Проверьте статус таймера с помощью get_tracking_status

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

Нет запущенного таймера

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

Причины:

• Таймер никогда не запускался
• Таймер уже был остановлен
• Таймер был сброшен другим процессом

Решение:

• Вызовите get_tracking_status, чтобы проверить состояние таймера
• Если таймера нет, запустите его с помощью start_time_tracking
• Проверьте, не был ли таймер остановлен в другой сессии

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

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

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

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

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

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