Получение одной задачи через MCP: поля, статус и контекст

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

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

Назначение

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

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

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

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

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

Инструмент возвращает полный объект задачи со всеми доступными полями:

{
  "id": 123,
  "title": "Implement login feature",
  "description": "Add user authentication with email/password and OAuth support",
  "status": "in_progress",
  "priority": "high",
  "due_date": "2026-02-28",
  "project_id": 456,
  "board_id": 789,
  "assignee_id": 101,
  "assignee_name": "John Doe",
  "created_at": "2026-01-15T10:30:00Z",
  "updated_at": "2026-02-20T14:22:00Z",
  "created_by_id": 99,
  "comments": [
    {
      "id": 1,
      "content": "Started working on OAuth integration",
      "author_id": 101,
      "author_name": "John Doe",
      "created_at": "2026-02-20T14:22:00Z"
    }
  ],
  "tags": ["authentication", "backend"],
  "estimated_hours": 8,
  "actual_hours": 4.5
}

Поля ответа

• id: уникальный идентификатор задачи
• title: заголовок/название задачи
• description: полное описание задачи
• status: текущий статус (open, in_progress, done, blocked)
• priority: приоритет задачи (low, medium, high, urgent)
• due_date: срок выполнения в формате ISO (YYYY-MM-DD) или null
• project_id: ID проекта, к которому относится задача
• board_id: ID доски, на которой находится задача
• assignee_id: ID пользователя, назначенного на эту задачу
• assignee_name: имя назначенного пользователя
• created_at: метка времени создания задачи
• updated_at: метка времени последнего обновления задачи
• created_by_id: ID пользователя, создавшего задачу
• comments: массив объектов комментариев с содержимым, автором и метками времени
• tags: массив строк-тегов
• estimated_hours: оценочное время на выполнение (если задано)
• actual_hours: фактически залогированное время (если отслеживается)

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

Пример 1: получение задачи по ID

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

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

Возвращает: полный объект задачи со всеми полями

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

Вот как пользователи обычно взаимодействуют с get_task через естественный язык:

Claude Desktop / общий ИИ

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

"Show me details for task #123"

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

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

Cursor / контекст IDE

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

"What are the acceptance criteria for the login feature task?"

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

1. ИИ находит задачу с помощью list_tasks с поиском: "login feature"
2. ИИ вызывает get_task с ID задачи
3. ИИ извлекает критерии приёмки из описания или комментариев
4. ИИ представляет критерии в удобном для IDE формате

Подготовка к обновлениям

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

"Show me the current state of task #456 before I update it"

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

1. ИИ вызывает get_task, чтобы прочитать текущее состояние
2. ИИ показывает текущие сведения о задаче
3. ИИ ждёт, пока пользователь укажет изменения
4. Затем ИИ может показать различия перед вызовом update_task

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

• Передача задачи — получите полный контекст задачи для передачи новому владельцу
• Критерии приёмки — просмотрите сведения о задаче, чтобы предложить или проверить критерии приёмки
• Управление задачами — просмотрите сведения о задаче перед внесением обновлений или изменений
• Проверка перед обновлением — прочитайте текущее состояние перед обновлением полей задачи

Краевые случаи

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

Ситуация: 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"
}

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

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

Некорректный ID задачи

Ситуация: ID задачи не является допустимым целым числом

Ответ:

{
  "error": "validation_error",
  "message": "Invalid task_id format",
  "field": "task_id"
}

Обработка: убедитесь, что task_id является допустимым целым числом

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

Некорректный ID задачи

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

Причины:

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

Решение:

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

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

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

Причины:

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

Решение:

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

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

Лучшие практики

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

• ✅ Всегда вызывайте get_task перед update_task, чтобы прочитать текущее состояние
• ✅ Используйте get_task, чтобы убедиться в существовании задачи перед попыткой обновления
• ✅ Просматривайте комментарии к задаче, чтобы понять контекст и историю
• ✅ Проверяйте статус задачи перед его изменением
• ✅ Используйте сведения о задаче для подготовки передач работы и сводок
• ✅ Убедитесь, что задача относится к ожидаемому проекту/доске перед выполнением операций

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

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

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