ernestocorona/kanboard-mcp

Добавляет пользователя в проект Kanboard с указанной ролью. Роль по умолчанию: 'project-member', если не указана. Для поиска идентификаторов пользователей используйте list_project_users, для поиска идентификаторов проектов — list_projects; для удаления участника используйте remove_project_user. В случае успеха возвращает { user_id, project_id, role }.

Загружает файл в задачу Kanboard в качестве вложения. Предоставьте либо file_path (локальный файл), либо content_base64 (встроенное содержимое в base64), не оба. project_id определяется автоматически из задачи (указывать не нужно). Максимальный размер файла: 5 МБ (5 242 880 байт). Файлы большего размера возвращают VALIDATION_ERROR до отправки HTTP-запроса. При успехе возвращает { file_id }.

Закрывает (архивирует) активную задачу Kanboard. Задача становится неактивной и покидает активную доску, но сохраняется - это НЕ удаление. Обратимо: восстановите её с помощью reopen_task. Чтобы полностью удалить задачу, используйте delete_task. Возвращает { ok: true, task_id } при успехе.

Добавляет колонку на доску проекта Kanboard. Проект определяется по явному project_id/project_identifier или .kanboard.yaml. Используйте move_column для изменения порядка, update_column для переименования или изменения лимита WIP, delete_column для удаления. В случае успеха возвращает { column_id }.

Создаёт комментарий к задаче Kanboard. Автор комментария автоматически устанавливается как аутентифицированный пользователь (через кэш getMe()); НЕ передавайте user_id — он добавляется на стороне сервера. Чтобы изменить тело комментария, используйте update_comment; чтобы удалить — delete_comment. В случае успеха возвращает { comment_id }.

Создаёт новый проект Kanboard. Требует имя (1–255 символов). Опционально укажите описание, короткий идентификатор, идентификатор владельца, start_date / end_date (строка ISO 8601 или время в секундах с эпохи) и email. После создания настройте доску с помощью create_column / create_swimlane, добавьте участников с помощью add_project_user и отредактируйте атрибуты с помощью update_project. Возвращает { project_id } в случае успеха.

Создаёт подзадачу для существующей задачи Kanboard. Статус: 0 = todo (по умолчанию), 1 = in progress, 2 = done. Для получения списка подзадач задачи используйте list_subtasks; для редактирования — update_subtask. В случае успеха возвращает { subtask_id, task_id }.

Добавляет swimlane в проект Kanboard. Проект определяется по явному project_id/project_identifier или из .kanboard.yaml. Чтобы изменить порядок, используйте move_swimlane, чтобы переименовать — update_swimlane, чтобы удалить — delete_swimlane. Возвращает { swimlane_id } при успешном выполнении.

Создаёт новую задачу в проекте Kanboard. Проект определяется из явно указанного project_id или project_identifier, либо из .kanboard.yaml. Необязательные поля (column_id, owner_id, category_id, swimlane_id) используют значения по умолчанию из .kanboard.yaml, если не заданы. Чтобы создать сразу много задач, используйте create_tasks_batch; чтобы переместить задачу после создания, используйте move_task_position. В случае успеха возвращает { task_id, project_id }.

Массово создаёт задачи в проекте Kanboard с помощью одного пакетного JSON-RPC запроса. Принимает от 1 до 100 задач за один вызов. Неатомарно: возможен частичный сбой. Проверяйте failed[] для ошибок по каждой задаче. Необязательные поля (column_id, owner_id, category_id, swimlane_id) используют значения по умолчанию из .kanboard.yaml, если не указаны. Возвращает { created: [...], failed: [...] }. Никогда не выбрасывает исключение при частичном сбое.

Удаляет колонку Kanboard из доски проекта навсегда. РАЗРУШИТЕЛЬНО и необратимо — требуется явное `confirm: true`. Чтобы переименовать колонку или изменить её лимит WIP, используйте update_column; чтобы изменить порядок — move_column. Возвращает { ok: true, column_id } при успехе.

Навсегда удаляет комментарий Kanboard. РАЗРУШИТЕЛЬНАЯ и необратимая, требует явного `confirm: true`. Чтобы изменить текст комментария вместо удаления, используйте update_comment. Возвращает { ok: true, comment_id } при успехе.

Навсегда удаляет проект Kanboard и все его задачи, колонки и свимлайны. РАЗРУШИТЕЛЬНАЯ и необратимая: требует явного `confirm: true`. Чтобы удалить только участника, используйте remove_project_user; чтобы изменить атрибуты проекта, используйте update_project. Возвращает { ok: true, project_id } в случае успеха.

Окончательно удаляет подзадачу Kanboard. РАЗРУШИТЕЛЬНАЯ и необратимая: требует явного указания `confirm: true`. Чтобы отметить подзадачу как выполненную вместо удаления, задайте status=2 через update_subtask. В случае успеха возвращает { ok: true, subtask_id }.

Навсегда удаляет swimlane Kanboard из проекта. РАЗРУШИТЕЛЬНАЯ и необратимая: требует явного указания `confirm: true`. Чтобы переименовать swimlane, используйте update_swimlane; чтобы изменить порядок, используйте move_swimlane. Возвращает { ok: true, swimlane_id } в случае успеха.

Окончательно удаляет задачу Kanboard. ДЕСТРУКТИВНА и необратима: требует явного `confirm: true`. Возвращает { ok: true, task_id } при успехе.

Удаляет вложение файла из задачи Kanboard навсегда. РАЗРУШИТЕЛЬНАЯ и необратимая - требует явного `confirm: true`. Чтобы добавить вложение, используйте attach_file_to_task. Возвращает { ok: true, file_id } в случае успеха.

Получает один проект Kanboard. Укажите ровно один из параметров: project_id (число), project_identifier (короткая строка, например 'PRJ') или project_name (полное имя). Возвращает полный объект проекта. Возвращает NOT_FOUND, если подходящий проект не найден.

Получает одну задачу Kanboard по её числовому идентификатору. Возвращает полную сущность задачи, включая статус, даты, колонку, дорожку и метаданные. Возвращает NOT_FOUND, когда задача не существует.

Перечисляет все категории для проекта Kanboard. Укажите project_id или project_identifier, или настройте .kanboard.yaml в корневом каталоге вашего проекта. Возвращает массив объектов категорий с полями id, name и color_id.

Перечисляет все колонки (стадии доски) для проекта Kanboard. Укажите project_id или project_identifier, или настройте .kanboard.yaml в корне вашего проекта. Возвращает массив объектов колонок с полями id, title, position и task_limit.

Перечисляет открытые задачи, назначенные текущему аутентифицированному пользователю в выбранном проекте. Требует project_id (явно или из .kanboard.yaml). Использует поисковый запрос Kanboard: assignee:me status:open. В режиме приложения (пользователь jsonrpc) возвращает задачи, назначенные системному пользователю jsonrpc. При успехе возвращает { tasks }.

Выводит просроченные задачи с настраиваемой областью видимости. scope="mine" (по умолчанию): просроченные задачи для аутентифицированного пользователя. scope="all": все просроченные задачи во всех проектах (требуется токен администратора). scope="project": просроченные задачи для конкретного проекта (передайте project_id или используйте .kanboard.yaml). Примечание: getOverdueTasksByUser не поддерживается Kanboard JSON-RPC API. Возвращает пустой массив, если просроченных задач нет.

Возвращает проекты, в которых аутентифицированный пользователь является участником. Не перечисляет проекты в экземпляре Kanboard, к которым у пользователя нет доступа. Возвращает массив объектов проектов с id, name, identifier и status.

Выводит список участников проекта Kanboard (пары user_id + username). Укажите project_id или project_identifier, или настройте .kanboard.yaml в корне вашего проекта. Работает для любого пользователя, который может видеть проект: не требует прав администратора. Используйте возвращённые user_id для назначения задач (create_task owner_id), добавления комментариев и т.д.

Перечисляет все подзадачи для указанной задачи Kanboard. Возвращает массив объектов подзадач, включающий поля id, title, status, user_id, time_estimated и time_spent.

Перечисляет активные дорожки для проекта Kanboard. Принимает project_id или project_identifier, либо использует .kanboard.yaml, настроенный в корневой папке проекта. Возвращает массив объектов дорожек с полями id, name, description, position и is_active.

Перечисляет задачи в проекте Kanboard. Возвращает активные задачи по умолчанию (status_id=1). Передайте status_id=0, чтобы перечислить закрытые/неактивные задачи. Проект определяется из явного project_id или project_identifier, или из .kanboard.yaml.

Изменяет порядок колонки на доске проекта Kanboard. Укажите column_id и новую позицию (отсчёт от 1) — обязательно, по умолчанию не задано. Только изменение порядка — чтобы переименовать колонку или изменить её лимит WIP, используйте update_column. Возвращает { ok: true, column_id, position } при успехе.

Перемещает свимлайн в рамках проекта Kanboard. Требует swimlane_id и новую позицию с отсчётом от 1 (обязательно - без значения по умолчанию). Изменяет только порядок - для переименования свимлайна используйте update_swimlane. Возвращает { ok: true, swimlane_id, position } в случае успеха.

Перемещает задачу Kanboard в другую колонку, позицию или дорожку — это единственный способ изменить размещение задачи на доске. Укажите ровно одно из column_id или column_name (column_name определяется без учёта регистра). Если swimlane_id опущен, он определяется из .kanboard.yaml или первой активной дорожки. Проект определяется из явно указанного project_id или project_identifier, либо из .kanboard.yaml. Для изменения других атрибутов задачи (заголовок, даты, исполнитель) используйте update_task. При успехе возвращает { ok: true, task_id, column_id, swimlane_id, position }.

Отвязывает пользователя от проекта Kanboard (не удаляет пользователя). РАЗРУШАЕТ связь проекта и пользователя: требует явного `confirm: true`. Возвращает { ok: true, project_id, user_id } в случае успеха.

Открывает заново закрытую (неактивную) задачу Kanboard, восстанавливая её на активную доску. Обратная операция к close_task. При успехе возвращает { ok: true, task_id }.

Обновляет существующую колонку Kanboard (частичное обновление). Изменяются только переданные поля; пропущенные поля сохраняют свои текущие значения, а проверка выполняется перед любой записью, поэтому неверный вызов ничего не меняет. Должно быть передано как минимум одно поле помимо 'column_id', иначе VALIDATION_ERROR. НЕ для изменения порядка - используйте move_column; для удаления колонки используйте delete_column. Возвращает { ok: true, column_id } при успехе.

Обновляет тело существующего комментария Kanboard. Чтобы удалить комментарий, используйте delete_comment. В случае успеха возвращает { ok: true, comment_id }.

Обновляет атрибуты существующего проекта Kanboard (частичное обновление). Изменяются только те поля, которые передаются; пропущенные поля сохраняют свои текущие значения, а проверка выполняется перед любой записью, поэтому неверный вызов ничего не изменяет. Необходимо указать хотя бы одно поле кроме 'project_id' — иначе VALIDATION_ERROR. Этот инструмент обновляет только атрибуты проекта: для управления участниками используйте add_project_user / remove_project_user, для управления колонками — create_column / move_column, а для удаления проекта — delete_project. Возвращает { ok: true, project_id } при успешном выполнении.

Обновляет существующую подзадачу Kanboard (частичное обновление). Изменяются только переданные поля; пропущенные поля сохраняют текущие значения. Проверка выполняется до любой записи, поэтому некорректный вызов ничего не меняет. Поля 'subtask_id' и 'task_id' обязательны как идентификаторы. Необходимо также указать хотя бы одно из полей: title, status, user_id, time_estimated или time_spent. Status: 0 = к выполнению, 1 = в работе, 2 = выполнено. В случае успеха возвращает { subtask_id, task_id }.

Обновляет существующую swimlane в Kanboard (частичное обновление). Изменяются только те поля, которые вы передаёте; пропущенные поля сохраняют свои текущие значения. Проверка выполняется до любой записи, поэтому недопустимый вызов ничего не изменяет. Необходимо передать хотя бы одно поле кроме 'swimlane_id', иначе VALIDATION_ERROR. НЕ для переупорядочивания: используйте move_swimlane; для удаления swimlane используйте delete_swimlane. В случае успеха возвращает { ok: true, swimlane_id }.

Обновляет атрибуты существующей задачи Kanboard (частичное обновление). Изменяются только те поля, которые вы передаете; пропущенные поля сохраняют свои текущие значения. Проверка выполняется перед любой записью, поэтому недопустимый вызов ничего не изменяет. Должно быть указано хотя бы одно поле помимо 'task_id', иначе VALIDATION_ERROR. Изменения колонки и swimlane должны использовать move_task_position вместо этого. В случае успеха возвращает { ok: true, task_id }.