Список инструментов #
| Инструмент | Что делает | Обязательные параметры |
|---|---|---|
| list_tasks | Список задач проекта с фильтрами (статус, тип объекта, исполнитель, объект) и пагинацией | projectId |
| create_task | Создаёт задачу; по списку objectIds — задачу на каждый объект | projectId, name, status |
| update_task | Изменяет задачу (taskId); saveAsCopy — сохранить копией | projectId, taskId |
| delete_task | Удаляет задачи по списку id | projectId, tasks |
| list_task_statuses | Справочник статусов задач (id, name, code, sort) | projectId |
| list_task_object_types | Справочник типов объектов задач (project/section/page/keyword/link) | projectId |
| list_task_assignees | Исполнители проекта (id, name, role) | projectId |
| list_task_comments | Список комментариев задачи | projectId, taskId |
| create_task_comment | Создаёт комментарий к задаче | projectId, taskId, text |
| update_task_comment | Изменяет комментарий | projectId, commentId, text |
| delete_task_comments | Удаляет комментарии | projectId, comments |
list_tasks #
Список задач проекта с фильтрами и пагинацией. Сортировка фиксированная, параметр сортировки не поддерживается.
Параметры #
| Имя | Тип | Обязательный | Описание |
|---|---|---|---|
| projectId | number | да | ID проекта |
| id | number | нет | ID задачи |
| statusId | number | нет | ID статуса задачи |
| objectTypeId | number | нет | ID типа объекта |
| assignedToId | number | нет | ID исполнителя |
| objectId | number | нет | ID объекта, к которому привязана задача |
| limit | number | нет | Лимит записей, по умолчанию 100 |
| offset | number | нет | Смещение |
Возвращаемый результат #
Возвращает объект с массивом задач и общим количеством:
{
"tasks": [
{
"id": 15,
"name": "Обновить мета-теги",
"description": null,
"commentsCount": 0,
"deadline": "2026-11-20",
"outdated": false,
"deadlineWeek": 47,
"doneAt": null,
"assignedTo": "Иван Иванов",
"createdBy": "Павел Копков",
"status": "В работе",
"estimateTime": 2,
"usedTime": 0,
"objectType": "Страница",
"objectName": "/catalog/",
"objectId": 231,
"objectURL": "https://example.ru/catalog/",
"createdAt": "2026-11-16",
"updatedAt": "2026-11-16"
}
],
"total": 1
}
Поля ответа #
| Поле | Тип | Описание |
|---|---|---|
| tasks | array | Массив задач |
| total | number | Всего задач по фильтру |
| id | number | ID задачи |
| name | string | Название задачи |
| description | string | Описание в Markdown, до 5000 символов (может быть null) |
| commentsCount | number | Количество комментариев задачи |
| deadline | string | Срок в формате YYYY-MM-DD (может быть null) |
| outdated | boolean | Просрочена ли задача |
| deadlineWeek | number | Номер недели срока |
| doneAt | string | Дата выполнения в формате YYYY-MM-DD (может быть null) |
| assignedTo | string | Имя исполнителя |
| createdBy | string | Имя автора |
| status | string | Название статуса (локализованное) |
| estimateTime | number | Плановое время |
| usedTime | number | Фактически затраченное время |
| objectType | string | Название типа объекта |
| objectName | string | Имя объекта (проект/раздел/страница/ключ/ссылка) |
| objectId | number | ID объекта |
| objectURL | string | URL объекта |
| createdAt | string | Дата создания |
| updatedAt | string | Дата обновления |
create_task #
Создаёт задачу. Если передан массив objectIds, создаётся по одной задаче на каждый объект. Задача создаётся от имени текущего пользователя.
Параметры #
| Имя | Тип | Обязательный | Описание |
|---|---|---|---|
| projectId | number | да | ID проекта |
| name | string | да | Название задачи |
| status | number | да | ID статуса (из list_task_statuses) |
| description | string | нет | Описание в Markdown, до 5000 символов |
| objectType | number | нет | ID типа объекта (из list_task_object_types) |
| objectIds | array | нет | ID объектов — задача создаётся на каждый |
| assignedTo | number | нет | ID исполнителя (из list_task_assignees) |
| deadline | string | нет | Срок в формате YYYY-MM-DD |
| doneAt | string | нет | Дата выполнения в формате YYYY-MM-DD |
| estimateTime | number | нет | Плановое время |
| usedTime | number | нет | Фактическое время |
Возвращаемый результат #
{
"created": true
}
Обратите внимание: id созданной задачи в ответе не возвращается. Чтобы найти задачу, используйте list_tasks (например, по name и дате создания).
update_task #
Изменяет задачу taskId в рамках проекта projectId.
Параметры #
| Имя | Тип | Обязательный | Описание |
|---|---|---|---|
| projectId | number | да | ID проекта (задача должна принадлежать этому проекту) |
| taskId | number | да | ID задачи |
| name | string | нет | Название |
| description | string | нет | Описание в Markdown, до 5000 символов |
| objectType | number | нет | ID типа объекта |
| objectId | number | нет | ID объекта |
| status | number | нет | ID статуса |
| assignedTo | number | нет | ID исполнителя |
| deadline | string | нет | Срок в формате YYYY-MM-DD |
| doneAt | string | нет | Дата выполнения в формате YYYY-MM-DD |
| estimateTime | number | нет | Плановое время |
| usedTime | number | нет | Фактическое время |
| saveAsCopy | boolean | нет | Сохранить копией задачи (по умолчанию false) |
Возвращаемый результат #
{
"updated": true
}
Поле updated — boolean: true, если задача изменена; false, если ни одно поле не изменилось.
delete_task #
Удаляет задачи проекта по списку id.
Параметры #
| Имя | Тип | Обязательный | Описание |
|---|---|---|---|
| projectId | number | да | ID проекта |
| tasks | array | да | Массив ID удаляемых задач |
Возвращаемый результат #
{
"dropped": true
}
list_task_statuses #
Справочник статусов задач проекта.
Параметры #
| Имя | Тип | Обязательный | Описание |
|---|---|---|---|
| projectId | number | да | ID проекта |
Возвращаемый результат #
[
{
"id": 1,
"name": "В работе",
"code": "in_progress",
"sort": 10
}
]
list_task_object_types #
Справочник типов объектов задач: проект, раздел, страница, ключевое слово, ссылка.
Параметры #
| Имя | Тип | Обязательный | Описание |
|---|---|---|---|
| projectId | number | да | ID проекта |
Возвращаемый результат #
[
{
"id": 3,
"name": "Страница",
"code": "page"
}
]
list_task_assignees #
Пользователи проекта, доступные для назначения на задачи.
Параметры #
| Имя | Тип | Обязательный | Описание |
|---|---|---|---|
| projectId | number | да | ID проекта |
Возвращаемый результат #
[
{
"id": 12,
"name": "Иван Иванов",
"role": "SEO-специалист"
}
]
list_task_comments #
Список комментариев задачи. Текст комментария отображается в интерфейсе как Markdown, до 5000 символов.
Параметры #
| Имя | Тип | Обязательный | Описание |
|---|---|---|---|
| projectId | number | да | ID проекта |
| taskId | number | да | ID задачи |
| limit | number | нет | Лимит записей, по умолчанию 1000 |
| offset | number | нет | Смещение |
Возвращаемый результат #
{
"comments": [
{
"id": 1,
"taskId": 5,
"authorId": 1,
"author": "Иван Иванов",
"text": "**Готово**, проверь пожалуйста",
"createdAt": "2026-11-22 11:46:19",
"updatedAt": "2026-11-22 11:46:19"
}
],
"total": 1
}
create_task_comment #
Создаёт комментарий к задаче от имени текущего пользователя.
Параметры #
| Имя | Тип | Обязательный | Описание |
|---|---|---|---|
| projectId | number | да | ID проекта |
| taskId | number | да | ID задачи |
| text | string | да | Текст комментария в Markdown, до 5000 символов |
Возвращаемый результат #
Созданный комментарий в формате из list_task_comments.
update_task_comment #
Изменяет текст комментария. Доступно автору комментария и суперадминистратору (host-admin).
Параметры #
| Имя | Тип | Обязательный | Описание |
|---|---|---|---|
| projectId | number | да | ID проекта |
| commentId | number | да | ID комментария |
| text | string | да | Новый текст комментария в Markdown, до 5000 символов |
Возвращаемый результат #
Обновлённый комментарий в формате из list_task_comments.
delete_task_comments #
Мягко удаляет комментарии по списку id. Доступно автору комментариев и суперадминистратору (host-admin).
Параметры #
| Имя | Тип | Обязательный | Описание |
|---|---|---|---|
| projectId | number | да | ID проекта |
| comments | array | да | Массив ID комментариев |
Возвращаемый результат #
{
"dropped": true
}
Особенности работы с задачами #
create_task,update_taskиdelete_task— первые записывающие инструменты MCP. Они работают от имени пользователя по его Bearer-токену и проверяют права на задачи проекта (project.tasks: create / edit / drop).- Значения полей
status,objectType,assignedTo,objectId— числовые id из соответствующих справочных инструментов. - В ответе
list_tasksстатус, тип объекта, исполнитель и автор возвращаются локализованными именами. - Формат дат —
YYYY-MM-DD. create_taskне возвращает id созданной задачи; для поиска используйтеlist_tasks.update_taskиdelete_taskработают только с задачами проектаprojectId— чужие задачи не изменяются (возвращается ошибка).- Сортировка в
list_tasksфиксированная; параметр сортировки не поддерживается. - Комментарии читаются с правом
project.tasks.view, создаются с правомproject.tasks.edit. Изменять и удалять можно только свои комментарии; суперадминистратор (host-admin) — любые. - Текст комментария — Markdown, до 5000 символов. Удаление комментариев мягкое.
list_tasksвозвращаетcommentsCount— количество комментариев задачи.
Пример сценария #
Запрос агенту: «Покажи открытые задачи проекта X и создай новую задачу на обновление мета-тегов для страницы /catalog/ со сроком на следующую пятницу».
Цепочка вызовов: list_projects → list_tasks / create_task (при необходимости — list_task_statuses и list_task_assignees).
Запрос агенту: «Покажи комментарии к задаче X и добавь комментарий “проверено”».
Цепочка вызовов: list_projects → list_tasks → list_task_comments → create_task_comment.