Справочник по инструментам MCP
AB Projects предоставляет инструменты MCP, которые позволяют ИИ-ассистентам (таким как Claude) работать с вашими проектами, задачами и документами. Когда ассистент что-либо меняет с помощью этих инструментов, это проходит тот же путь, что и в приложении: запись в истории изменений с указанной вами заметкой, запись в журнале аудита и Adaptive Card (адаптивная карточка), публикуемая в связанном канале Microsoft Teams — с чётко раскрытой активностью ИИ. Инструменты только для чтения просто возвращают данные и ничего не меняют.
Инструменты для проектов
| Инструмент | Описание | Параметры |
|---|---|---|
ab_get_my_projects |
Список всех проектов, в которых вы являетесь участником, включая статистику, такую как количество задач и показатели выполнения. | Нет |
ab_get_project_members |
Список всех участников проекта с их ролями и идентификаторами участия. Используйте это, чтобы получить идентификатор участия, необходимый для назначения задачи. | project_id обязательный |
ab_get_project_options |
Получить допустимые идентификаторы статуса, типа и среды для проекта. Вызовите это сначала, прежде чем передавать статус, тип или среду в ab_create_task или ab_update_task. |
project_id обязательный |
Инструменты для задач
| Инструмент | Описание | Параметры |
|---|---|---|
ab_get_my_tasks |
Получить ваши активные задачи — просроченные, со сроком выполнения сегодня и в процессе. Возвращает идентификатор задачи, заголовок, приоритет, статус, срок выполнения и прогресс. | project_id необязательный — фильтр по конкретному проекту |
ab_search_tasks |
Поиск задач по ключевому слову во всех ваших проектах. | query обязательный — ключевое слово поиска project_id необязательный — ограничить конкретным проектом |
ab_get_task |
Получить полные сведения о задаче — описание, даты, исполнитель, оценочные/фактические часы, информация о подзадачах, идентификатор родительской задачи, ветка GitHub и 50 последних комментариев встроенно. Статус, тип и среда возвращаются в виде понятных человеку имён. | project_id обязательный task_id обязательный |
ab_create_task |
Создать новую задачу. Записывается запись в журнал изменений, и уведомление публикуется в связанном канале Teams. | project_id обязательный title обязательный description необязательный — поддерживает Markdown priority необязательный — 1 = Высокий, 2 = Средний, 3 = Низкий (по умолчанию: 2) assignee_id необязательный — идентификатор участия исполнителя due_date необязательный — yyyy-MM-dd status / type / environment необязательный — идентификаторы из ab_get_project_optionsparent_task_id необязательный — ключ строки родительской задачи; если задан, это становится подзадачей, и флаг «есть подзадачи» родителя обновляется автоматически note необязательный — причина, отображаемая в журнале изменений и канале Teams |
ab_update_task |
Обновить свойства задачи — заголовок, описание, статус, прогресс, приоритет, исполнитель, тип, среду или родителя. Каждое изменение записывается в историю с предоставленной заметкой. | project_id обязательный task_id обязательный title / description необязательный (Markdown) status необязательный — новый идентификатор статуса progress необязательный — от 0 до 100 priority необязательный — 1/2/3 assignee_id / type / environment необязательный parent_task_id необязательный — переместить под другого родителя; пустая строка для отсоединения note необязательный — причина, отображаемая в журнале изменений и канале Teams |
ab_complete_task |
Отметить задачу как выполненную. Устанавливает прогресс на 100% и записывает запись о завершении в историю изменений. | project_id обязательный task_id обязательный note необязательный — заметка о завершении, отображаемая в журнале изменений и канале Teams |
ab_add_comment |
Добавить комментарий к задаче. Комментарий появляется в потоке задачи и встраивается инструментом ab_get_task, поэтому последующий вызов может прочитать его без второго вызова инструмента. |
project_id обязательный task_id обязательный content обязательный — текст комментария |
Инструменты для расписания
| Инструмент | Описание | Параметры |
|---|---|---|
ab_get_schedule |
Получить ваше расписание на текущую неделю — сгруппированное на просроченные, со сроком выполнения сегодня и со сроком выполнения на этой неделе. | project_id необязательный — фильтр по конкретному проекту |
Инструменты для документов (Wiki)
| Инструмент | Описание | Параметры |
|---|---|---|
ab_get_wiki_tree |
Получить дерево навигации документов (папки и страницы) для проекта. | project_id обязательный |
ab_get_wiki_article |
Прочитать полное содержимое документа, метаданные и информацию о версии. | project_id обязательный article_id обязательный — из ab_get_wiki_tree или ab_search_wiki |
ab_search_wiki |
Список документов в указанном пути папки. | project_id обязательный parent_path необязательный — папка для перечисления (по умолчанию: / для корня) |
ab_create_wiki_article |
Создать новый документ в Markdown. Публикует уведомление в связанном канале Teams. | project_id обязательный title обязательный content обязательный — Markdown parent_path необязательный — папка, например / или /Engineering (по умолчанию: /)tags необязательный — через запятую |
ab_update_wiki_article |
Обновить существующий документ. Создаёт новую версию с заметкой о редактировании и публикует уведомление в канале Teams. | project_id обязательный article_id обязательный content обязательный — обновлённый Markdown edit_note обязательный — что изменилось; отображается в истории версий tags необязательный — обновлённые теги через запятую |
ab_add_wiki_comment |
Добавить комментарий к документу. | project_id обязательный article_id обязательный content обязательный — текст комментария |
Как изменения ИИ остаются видимыми
Когда задача или документ создаётся, обновляется или завершается через инструмент MCP, AB Projects автоматически:
- Записывает изменение в историю изменений элемента с именем пользователя и предоставленной заметкой
- Создаёт запись в журнале операций для целей аудита
- Публикует или обновляет Adaptive Card (адаптивную карточку) в связанном канале Microsoft Teams проекта, при этом активность чётко раскрывается как сгенерированная ИИ
Таким образом, изменения, выполненные ИИ, имеют ту же видимость и прослеживаемость, что и изменения, сделанные напрямую в приложении AB Projects или на вкладке Teams. О том, как подключить ассистента, см. Подключение ИИ-ассистентов через MCP.