Список комментариев к задаче через MCP: хронология и журналы аудита

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

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

Назначение

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

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

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

Инструмент требует ID задачи. Параметры пагинации необязательны.

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

Инструмент возвращает JSON-объект с комментариями и информацией о пагинации:

{
  "comments": [
    {
      "id": 1,
      "content": "Started working on OAuth integration",
      "author_id": 101,
      "author_name": "John Doe",
      "author_email": "john@example.com",
      "created_at": "2026-02-20T14:22:00Z",
      "updated_at": "2026-02-20T14:22:00Z"
    }
  ],
  "total": 5,
  "limit": 25,
  "offset": 0,
  "has_more": false
}

Поля ответа

• comments: массив объектов комментариев (пустой массив, если комментариев нет)
• total: общее количество комментариев к этой задаче (по всем страницам)
• limit: максимальное количество комментариев, возвращённых в этом ответе
• offset: количество пропущенных комментариев (для пагинации)
• has_more: логическое значение, указывающее, доступны ли ещё комментарии

Поля объекта комментария

• id: уникальный идентификатор комментария
• content: текстовое содержимое комментария
• author_id: ID пользователя, создавшего комментарий
• author_name: имя автора комментария
• author_email: email автора комментария
• created_at: временная метка создания комментария
• updated_at: временная метка последнего обновления комментария

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

Пример 1: список всех комментариев

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

{
  "tool": "list_task_comments",
  "arguments": {
    "task_id": 123,
    "limit": 50
  }
}

Возвращает: первые 50 комментариев для задачи 123

Пример 2: пагинация

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

{
  "tool": "list_task_comments",
  "arguments": {
    "task_id": 123,
    "limit": 25,
    "offset": 25
  }
}

Возвращает: комментарии 26–50 (вторая страница)

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

Claude Desktop / общий ИИ

Промпт пользователя:

"Покажи все комментарии к задаче №123"

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

1. ИИ вызывает list_task_comments с task_id: 123
2. ИИ получает массив комментариев
3. ИИ форматирует и представляет комментарии пользователю в хронологическом порядке

Просмотр истории задачи

Промпт пользователя:

"Какие решения были приняты по задаче с функцией входа?"

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

1. ИИ находит задачу с помощью list_tasks с search: "login feature"
2. ИИ вызывает list_task_comments с ID задачи
3. ИИ анализирует комментарии на предмет ключевых слов о решениях
4. ИИ представляет пользователю хронологию решений

Подготовка передачи работы

Промпт пользователя:

"Обобщи историю комментариев для задачи №456 для передачи работы"

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

1. ИИ вызывает list_task_comments, чтобы получить все комментарии
2. ИИ получает хронологию комментариев
3. ИИ обобщает ключевые моменты, решения и следующие шаги из комментариев
4. ИИ представляет пользователю сводку для передачи работы

Распространённые сценарии использования

• Передача задачи — просмотрите историю комментариев для подготовки сводок передачи
• Обновления прогресса — просмотрите предыдущие комментарии перед добавлением новых обновлений
• Управление задачами — поймите контекст задачи и историю решений
• Добавление комментариев — просмотрите существующие комментарии перед добавлением новых

Граничные случаи

Нет комментариев

Ситуация: у задачи нет комментариев

Ответ:

{
  "comments": [],
  "total": 0,
  "limit": 50,
  "offset": 0,
  "has_more": false
}

Обработка: это нормально — пустой массив означает, что у задачи пока нет комментариев

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

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

Ответ:

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

Обработка: проверьте правильность ID задачи

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

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

Ответ:

{
  "error": "forbidden",
  "message": "You don't have permission to access this task's comments"
}

Обработка: проверьте, находитесь ли вы в правильном рабочем пространстве и не является ли задача приватной

Читать руководство по устранению ошибки 403 →

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

Недопустимый ID задачи

Симптом: ошибка валидации 400 или ошибка «не найдено» 404

Причины:

• ID задачи не является числом
• ID задачи не существует
• Задача была удалена

Решение:

• Убедитесь, что ID задачи — допустимое целое число
• Используйте list_tasks или get_task, чтобы найти допустимые ID
• Проверьте, существует ли задача всё ещё в Workify

Отказ в доступе (403)

Симптом: ошибка 403 Forbidden

Причины:

• Задача принадлежит другому рабочему пространству
• Задача приватная, и вы не назначены на неё
• API-ключ не имеет доступа к рабочему пространству

Решение:

• Убедитесь, что обращаетесь к правильному рабочему пространству
• Проверьте разрешения задачи в Workify
• Убедитесь, что API-ключ имеет доступ к рабочему пространству

Читать руководство по устранению ошибки 403 →

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

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

• ✅ Используйте пагинацию (limit/offset) для задач с большим количеством комментариев
• ✅ Просматривайте комментарии перед добавлением новых, чтобы избежать дублирования
• ✅ Используйте комментарии для понимания контекста задачи и истории решений
• ✅ Комбинируйте с get_task для получения полного контекста задачи
• ✅ Сортируйте комментарии в хронологическом порядке (они возвращаются в порядке создания)

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

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

• get_task — получение сведений о задаче (включает недавние комментарии)
• add_task_comment — добавление новых комментариев к задачам
• list_tasks — поиск ID задач перед перечислением комментариев