Создание задачи через MCP: обязательные поля, значения по умолчанию и проверки безопасности

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

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

Назначение

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

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

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

Некоторые поля обязательны, другие — необязательны и имеют разумные значения по умолчанию.

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

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

{
  "id": 789,
  "title": "Follow up with Acme Corp",
  "description": "Schedule a call to discuss the proposal",
  "status": "open",
  "priority": "high",
  "due_date": "2026-03-10",
  "project_id": 456,
  "board_id": 123,
  "assignee_id": 101,
  "created_at": "2026-03-03T10:30:00Z",
  "updated_at": "2026-03-03T10:30:00Z",
  "created_by_id": 99
}

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

⚠️ Всегда подтверждайте перед созданием

Никогда не позволяйте ИИ создавать задачи без явного подтверждения. Используйте эти паттерны:

• Сначала предпросмотр: покажите, какая задача будет создана, перед выполнением
• Токен подтверждения: требуйте «CONFIRM» перед вызовом create_task
• Проверка полей: отобразите все поля (title, description, due_date, project) для проверки

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

Паттерн безопасного промпта

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

"I want to create a task: [description]. 
Show me exactly what you'll create (title, description, project, due date) 
and wait for me to type CONFIRM before creating it. 
If I don't type CONFIRM, don't create anything."

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

Пример 1: минимальная задача (только заголовок)

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

{
  "tool": "create_task",
  "arguments": {
    "title": "Follow up with Acme Corp"
  }
}

Возвращает: задачу, созданную с проектом и доской по умолчанию, status="open", priority="medium"

Пример 2: полная задача

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

{
  "tool": "create_task",
  "arguments": {
    "title": "Implement login feature",
    "description": "Add user authentication with email/password and OAuth support",
    "project_id": 456,
    "board_id": 789,
    "due_date": "2026-03-15",
    "assignee_id": 101,
    "status": "open",
    "priority": "high",
    "tags": ["authentication", "backend"]
  }
}

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

Пример 3: задача со сроком выполнения

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

{
  "tool": "create_task",
  "arguments": {
    "title": "Review API design doc",
    "description": "Review and provide feedback on the new API design",
    "due_date": "2026-03-05",
    "priority": "high"
  }
}

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

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

Безопасное создание с подтверждением

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

"Create a task to follow up with Acme Corp next week. Show me what you'll create before creating it."

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

1. ИИ предлагает задачу: "Title: Follow up with Acme Corp, Due: [next week], Project: [suggested]"
2. ИИ показывает предпросмотр и запрашивает подтверждение
3. Пользователь вводит «CONFIRM»
4. ИИ вызывает create_task с предложенными полями
5. ИИ подтверждает, что задача была создана

Из заметок совещания

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

"I have these action items from a meeting: [list]. Create tasks for each, but show me all tasks first. Don't create until I approve."

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

1. ИИ анализирует пункты действий
2. ИИ предлагает список задач с деталями
3. ИИ показывает предпросмотр: "I'll create these 5 tasks: [list]"
4. Пользователь просматривает и одобряет
5. ИИ вызывает create_task для каждой одобренной задачи

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

• Из заметок совещания в задачи — извлекайте пункты действий и создавайте последующие задачи
• Из спецификации в задачи — превращайте спецификации функций в структурированные деревья задач
• Запуск проекта — создавайте стартовые задачи для новых проектов
• Планирование спринта — превращайте цели спринта в конкретные задачи

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

Отсутствует обязательное поле

Ситуация: title отсутствует или пустой

Ответ:

{
  "error": "validation_error",
  "message": "Title is required",
  "field": "title"
}

Обработка: всегда указывайте заголовок при создании задач

Некорректный ID проекта

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

Ответ:

{
  "error": "validation_error",
  "message": "Project with ID 999 not found",
  "field": "project_id"
}

Обработка: сначала проверьте существование project_id с помощью list_projects

Некорректный формат даты

Ситуация: due_date не в формате ISO (YYYY-MM-DD)

Ответ:

{
  "error": "validation_error",
  "message": "Invalid date format. Use YYYY-MM-DD",
  "field": "due_date"
}

Обработка: используйте формат даты ISO: YYYY-MM-DD (например, "2026-03-15")

Некорректное значение статуса

Ситуация: status не является одним из: open, in_progress, done, blocked

Ответ:

{
  "error": "validation_error",
  "message": "Invalid status. Must be: open, in_progress, done, or blocked",
  "field": "status"
}

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

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

Ошибки валидации (400)

Симптом: 400 Bad Request с ошибкой валидации

Причины:

• Отсутствует обязательное поле (title)
• Некорректный формат поля (date, status, priority)
• Некорректный ID (project_id, board_id, assignee_id не существует)

Решение:

• Убедитесь, что title указан и не пуст
• Проверьте существование всех ID перед их использованием
• Используйте корректные форматы (даты ISO, допустимые значения status/priority)

Читать об устранении ошибок валидации →

Проект не найден

Симптом: ошибка валидации, связанная с project_id

Причины:

• ID проекта не существует
• Проект принадлежит другому рабочему пространству
• Проект был удалён

Решение:

• Используйте list_projects, чтобы найти допустимые ID проектов
• Убедитесь, что проект существует в вашем рабочем пространстве
• Опустите project_id, чтобы использовать проект по умолчанию

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

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

• ✅ Всегда просматривайте сведения о задаче перед созданием
• ✅ Требуйте явного подтверждения (токен CONFIRM)
• ✅ Проверяйте существование project_id и board_id перед использованием
• ✅ Используйте описательные заголовки (а не просто «Task» или «New task»)
• ✅ Включайте описания для сложных задач
• ✅ Устанавливайте подходящие сроки выполнения, когда они известны
• ✅ Используйте теги для организации и фильтрации
• ✅ Добавляйте аудиторские комментарии после создания, когда это уместно

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

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

• list_projects — найдите ID проектов перед созданием задач
• get_task — убедитесь, что задача успешно создана
• Рабочие процессы с минимальными привилегиями — паттерны безопасной записи