Получение статуса учёта времени через MCP: что запущено сейчас

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

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

Назначение

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

Операция только для чтения: Этот инструмент только читает данные — он никогда не изменяет учёт времени.

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

Инструменту не требуется никаких параметров. Он возвращает текущий статус учёта для вашего рабочего пространства.

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

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

Когда таймер запущен:

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

Когда таймер не запущен:

{
  "is_running": false,
  "task_id": null,
  "task_title": null,
  "started_at": null
}

Поля ответа

• is_running: Логическое значение, указывающее, активен ли в данный момент таймер
• task_id: Идентификатор отслеживаемой задачи (null, если таймер не запущен)
• task_title: Название задачи (null, если таймер не запущен)
• started_at: Метка времени запуска таймера (null, если таймер не запущен)

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

Пример 1: Проверка статуса учёта

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

{
  "tool": "get_tracking_status",
  "arguments": {}
}

Возвращает: Объект текущего статуса учёта

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

Проверка перед запуском таймера

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

"Check if any timer is running, then start tracking on task #123"

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

1. ИИ вызывает get_tracking_status
2. Если таймер существует, ИИ предупреждает пользователя и просит сначала остановить его
3. Если таймера нет, ИИ переходит к запуску таймера на задаче #123

Проверка текущего таймера

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

"What task am I currently tracking time on?"

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

1. ИИ вызывает get_tracking_status
2. ИИ сообщает: "You're tracking time on: Login Feature (started 2 hours ago)"
3. Или: "No timer is currently running"

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

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

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

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

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

Ответ:

{
  "is_running": false,
  "task_id": null,
  "task_title": null,
  "started_at": null
}

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

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

Всегда возвращает отсутствие таймера

Симптом: Всегда возвращает is_running: false, даже когда таймер должен быть запущен

Причины:

• Таймер был остановлен в другой сессии
• Таймер истёк или был сброшен
• Проблема с рабочим пространством

Решение:

• Проверьте таймер в веб-интерфейсе Workify
• Попробуйте запустить новый таймер
• Проверьте настройки рабочего пространства

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

Эффективное использование get_tracking_status

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

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

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

• start_time_tracking — проверка статуса перед запуском
• stop_time_tracking — проверка статуса перед остановкой
• get_task — получение сведений об отслеживаемой задаче