AgileHero

npx add-mcp 'https://mcp.agilehero.io/mcp'

AgileHero поставляется со встроенным MCP-сервером: добавьте один URL в любой MCP-совместимый AI-ассистент, войдите с помощью своей учетной записи AgileHero, и он будет работать с вашими проектами с вашими правами — 49 инструментов для досок, бэклога, эпиков, вики, онлайн-досок, ретроспектив и дорожной карты. Эта документация генерируется из самого сервера, поэтому она всегда актуальна.

Впервые здесь? Начните с обзора AI-агентов или сразу переходите к подключению вашего клиента ниже. Форматированный текст на этом сервере — это AgileHero Markup (AHM) — строгий проверяемый XML-диалект, разработанный так, чтобы агенты никогда не повреждали человеческий контент. Пишете скрипт вместо подключения ассистента? Справочник REST API использует тот же вход через OAuth.

Подключение вашего AI-клиента

Подключение означает две вещи: добавьте URL конечной точки в ваш клиент, затем войдите с помощью своей учетной записи AgileHero, когда клиент попросит. Никаких ключей создавать или вставлять не нужно. После подключения клиент действует от вашего имени с вашими правами; каждый подключенный клиент указан в разделе Настройки → AI-клиенты в приложении, где вы можете отозвать его в любой момент. Наблюдатели не могут использовать MCP-сервер: рабочее пространство, где вы наблюдатель, не отображается, и все в нем читается как не найденное.

Конечная точка

https://mcp.agilehero.io/mcp

Транспорт

Streamable HTTP (POST)

Вход

Ваш AI-клиент открывает окно браузера; подтвердите один раз, отзовите в любое время в Настройки → AI-клиенты.

Claude Code

Запустите один раз в терминале; Claude Code сохраняет сервер в вашей пользовательской конфигурации и выполняет вход через ваш браузер.

claude mcp add --transport http --scope user agilehero https://mcp.agilehero.io/mcp

• Все флаги должны идти перед именем сервера.
• Затем запустите /mcp в сессии Claude Code и выберите Authenticate (или запустите claude mcp login agilehero) и подтвердите вход в браузере.

Проверка: Запустите claude mcp list — agilehero должен отображаться как подключенный. Если отображается «требуется аутентификация», запустите claude mcp login agilehero.

Документация Claude Code · проверено по документации вендора 2026-09-15

VS Code (GitHub Copilot)

Добавьте в .vscode/mcp.json в рабочем пространстве или запустите «MCP: Open User Configuration» для всех рабочих пространств. Окно браузера откроется для входа при первом запуске сервера.

.vscode/mcp.json

{
  "servers": {
    "agilehero": {
      "type": "http",
      "url": "https://mcp.agilehero.io/mcp"
    }
  }
}

• «type»: «http» обязателен — без него VS Code воспринимает URL как команду для запуска.

Проверка: Запустите «MCP: List Servers», запустите agilehero, завершите вход в браузере и убедитесь, что его инструменты появились в представлении чата.

Документация VS Code (GitHub Copilot) · проверено по документации вендора 2026-09-15

Codex

Добавьте из терминала, затем войдите — конфигурация используется совместно Codex CLI, расширением IDE и настольным приложением ChatGPT.

codex mcp add agilehero --url https://mcp.agilehero.io/mcp
codex mcp login agilehero

• Codex не запускает вход самостоятельно — запустите codex mcp login agilehero после добавления сервера.

Проверка: Запустите codex mcp list — agilehero должен отображаться как аутентифицированный; затем попросите Codex перечислить ваши проекты AgileHero.

Документация Codex · проверено по документации вендора 2026-09-15

Zed

Добавьте в settings.json или используйте Настройки → AI → MCP Servers → Add Remote Server; Zed предложит вам войти.

~/.config/zed/settings.json

{
  "context_servers": {
    "agilehero": {
      "url": "https://mcp.agilehero.io/mcp"
    }
  }
}

• Не указывайте заголовки — Zed запускает вход только если заголовок Authorization не настроен.

Проверка: Перезапустите Zed, подтвердите вход в браузере, когда будет предложено, и попросите перечислить ваши проекты AgileHero — первый успешный вызов подтверждает подключение.

Документация Zed · проверено по документации вендора 2026-09-15

GitHub Copilot CLI

Добавьте в ~/.copilot/mcp-config.json или .mcp.json внутри репозитория.

~/.copilot/mcp-config.json

{
  "mcpServers": {
    "agilehero": {
      "type": "http",
      "url": "https://mcp.agilehero.io/mcp"
    }
  }
}

• Требуется GitHub Copilot CLI 1.0.83 или новее (поддержка Client ID Metadata Document).
• Copilot CLI открывает вход, когда сервер впервые запрашивает его; вы также можете запустить /mcp auth agilehero внутри сессии.

Проверка: Запустите /mcp внутри Copilot CLI — agilehero должен быть указан как подключенный с его инструментами.

Документация GitHub Copilot CLI · проверено по документации вендора 2026-09-15

Claude (веб, десктоп, Cowork)

Добавьте AgileHero как пользовательский коннектор и войдите; коннектор доступен в Claude в вебе, Claude Desktop, Cowork и мобильных приложениях.

Settings → Connectors → Add custom connector
Name: AgileHero
URL: https://mcp.agilehero.io/mcp
Sign in now

• Коннектор также появляется в Claude Code, когда он выполнен вход с той же учетной записью Claude.
• Бесплатный план: один пользовательский коннектор. Team и Enterprise: владелец добавляет коннектор, и каждый участник входит со своей учетной записью AgileHero.

Проверка: Начните новый чат — AgileHero указан в разделе коннекторов, и запрос к Claude перечислить ваши проекты AgileHero работает.

Документация Claude (веб, десктоп, Cowork) · проверено по документации вендора 2026-09-15

ChatGPT

Создайте коннектор в режиме разработчика и войдите через OAuth.

Settings → Connectors → Create (Developer mode)
Name: AgileHero
MCP server URL: https://mcp.agilehero.io/mcp
Authentication: OAuth

• Доступно на Plus, Pro, Business, Enterprise и Edu с включенным режимом разработчика; в рабочем пространстве администратор или владелец публикует коннектор для участников.

Проверка: Откройте новый чат с включенным коннектором AgileHero и попросите ChatGPT перечислить ваши проекты AgileHero.

Документация ChatGPT · проверено по документации вендора 2026-09-15

Другой клиент

Любой MCP-клиент, поддерживающий OAuth с Client ID Metadata Documents: добавьте конечную точку как удаленный (Streamable HTTP) сервер и подтвердите вход в браузере.

Transport: Streamable HTTP
URL: https://mcp.agilehero.io/mcp
Authentication: OAuth (sign in when the client asks)

• Клиенты, поддерживающие только статические токены или заголовки, не могут подключиться — AgileHero использует только вход через OAuth.

Проверка: Перезапустите клиент, подтвердите вход в браузере, когда будет предложено, и попросите перечислить ваши проекты AgileHero — первый успешный вызов подтверждает подключение.

Документация другого клиента · проверено по документации вендора 2026-09-15

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

Эти клиенты пока не могут войти в AgileHero. Большинство из них не поддерживают Client ID Metadata Documents — метод регистрации OAuth-клиента, который использует AgileHero (текущая рекомендация MCP); мы регулярно проверяем документацию вендоров и перемещаем клиент вверх, как только он соответствует требованиям.

CursorПока нет

Cursor пока не поддерживает Client ID Metadata Documents (его вход через OAuth требует Dynamic Client Registration или предварительно зарегистрированный клиент), поэтому сейчас он не может подключиться к AgileHero.

Документация Cursor · проверено по документации вендора 2026-09-15

OpenCodeПока нет

OpenCode пока не поддерживает Client ID Metadata Documents (его вход через OAuth требует Dynamic Client Registration или предварительно зарегистрированный клиент), поэтому сейчас он не может подключиться к AgileHero.

Документация OpenCode · проверено по документации вендора 2026-09-15

Gemini CLIPока нет

Gemini CLI пока не поддерживает Client ID Metadata Documents (его вход через OAuth требует Dynamic Client Registration или предварительно зарегистрированный клиент), поэтому сейчас он не может подключиться к AgileHero.

Документация Gemini CLI · проверено по документации вендора 2026-09-15

ClineПока нет

Cline пока не поддерживает Client ID Metadata Documents (его вход через OAuth требует Dynamic Client Registration или предварительно зарегистрированный клиент), поэтому сейчас он не может подключиться к AgileHero.

Документация Cline · проверено по документации вендора 2026-09-15

Google AntigravityПока нет

Google Antigravity пока не поддерживает Client ID Metadata Documents (его вход через OAuth требует Dynamic Client Registration или предварительно зарегистрированный клиент), поэтому сейчас он не может подключиться к AgileHero.

Документация Google Antigravity · проверено по документации вендора 2026-09-15

AmpПока нет

Amp пока не поддерживает Client ID Metadata Documents (его вход через OAuth требует Dynamic Client Registration или предварительно зарегистрированный клиент), поэтому сейчас он не может подключиться к AgileHero.

Документация Amp · проверено по документации вендора 2026-09-15

Raycast AIПока нет

Raycast AI пока не поддерживает Client ID Metadata Documents (его вход через OAuth требует Dynamic Client Registration или предварительно зарегистрированный клиент), поэтому сейчас он не может подключиться к AgileHero.

Документация Raycast AI · проверено по документации вендора 2026-09-15

KiroПока нет

Kiro выполняет вход с URL Client ID Metadata Document, который вы предоставляете, а AgileHero пока не размещает Client ID Metadata Document для него.

Документация Kiro · проверено по документации вендора 2026-09-15

WarpПока нет

Warp пока не имеет входа через OAuth для добавленных пользователем серверов, поэтому сейчас он не может подключиться к AgileHero.

Документация Warp · проверено по документации вендора 2026-09-15

JetBrains AI AssistantПока нет

JetBrains AI Assistant не имеет входа через OAuth для удаленных серверов, а мосту mcp-remote потребуется размещенный клиентский документ — AgileHero пока не размещает Client ID Metadata Document для него.

Документация JetBrains AI Assistant · проверено по документации вендора 2026-09-15

ContinueПока нет

Continue не имеет входа через OAuth для Streamable HTTP серверов, а мосту mcp-remote потребуется размещенный клиентский документ — AgileHero пока не размещает Client ID Metadata Document для него.

Документация Continue · проверено по документации вендора 2026-09-15

Инструкции сервера

Каждый MCP-клиент получает эти соглашения во время инициализации:

Сервер MCP AgileHero.

Каждый параметр id и каждый id в ответе — это короткий uid — всегда используйте uid, возвращаемые инструментами list/get/search, никогда не придумывайте свои. Большинству инструментов нужен uid проекта — сначала вызовите list_projects, чтобы обнаружить рабочие пространства и проекты. Предпочитайте search (полнотекстовый, все типы контента) вместо search_cards (подстрока заголовка, один проект).

В инструментах обновления предпочитайте поля дельты add_*/remove_* для коллекций (инкрементальные, безопасные); обычные поля коллекций (assigned_to, labels, checklists, cards_relations, links, attachments) ЗАМЕНЯЮТ предыдущее состояние и не могут комбинироваться с их дельтами. Элементы чек-листа — это { description, checked }. Догоняйте изменения с помощью updated_since в list_cards / list_epics.

Используйте move_card (не update_card) для изменения списка или позиции карточки; пустой list_id означает бэклог.

Инструменты вики, онлайн-досок, ретроспектив и дорожной карты требуют, чтобы рабочее пространство проекта было на плане Pro или пробном. Записи элементов онлайн-досок — это пакетные инструменты и выполняются полностью или не выполняются; uid элементов берутся из get_whiteboard. Элементы ретроспектив управляются с помощью add_retro_items и move_retro_item (move_card отклоняет карточки ретроспектив).

Дневные лимиты: вызовы инструментов учитываются на пользователя на рабочее пространство — 500/день на бесплатном плане, 5000/день на Pro или пробном, сброс в 00:00 UTC. get_ahm_spec и list_projects никогда не учитываются (как и любой вызов, не относящийся к одному рабочему пространству, например, поиск без области). При превышении лимита инструменты возвращают ошибку дневного лимита до сброса или обновления плана.

ВЕСЬ форматированный текст (страницы вики, описания карточек/эпиков, комментарии) — это AgileHero Markup (AHM) — строгий XML, НИКОГДА не markdown или HTML; вызовите get_ahm_spec один раз перед написанием любого. Правки форматированного текста двухэтапные по дизайну: preview_wiki_page_update / preview_description_update (последствия + preview_token), затем соответствующий инструмент обновления с этим токеном.

Полная документация инструментов: https://agilehero.io/docs/mcp

Спецификация AHM: https://agilehero.io/docs/mcp/agilehero-markup

Инструменты (49)

list_projectsтолько чтение

Перечисляет каждое рабочее пространство и проект, к которым имеет доступ пользователь токена, чтобы агент мог определить uid проекта, который требуется большинству других инструментов. Вызывайте это первым, когда uid проекта неизвестен — никогда не просите пользователя вставить его. Возвращает рабочие пространства (uid, name, plan, your role) с их проектами (uid, name, url). Инструменты Pro-столпа (вики, метрики) требуют, чтобы план рабочего пространства был pro или trial.

searchтолько чтение

Глобальный полнотекстовый поиск по продукту (OpenSearch): карточки, эпики, вики-страницы и проекты, сопоставление по заголовкам, описаниям, комментариям, пунктам чек-листов и именам вложений, ранжирование по релевантности с учетом недавности. Используйте это, чтобы найти что угодно по содержимому («карточка, где мы обсуждали миграцию»); используйте search_cards только для поиска по подстроке заголовка внутри одного проекта. Каждый результат содержит тип, готовый к действию uid (карточки передают в get_card/update_card, эпики — в get_epic, wiki_pages — в show_wiki_page, проекты — параметры project_id), deep-link url и фрагменты с подсветкой <mark>, показывающие, почему найден результат. При необходимости ограничьте область поиска с помощью project_id или assigned_to_me. Пагинация через page/per_page; total_count — полное число совпадений.

Параметр	Тип	Обязательный	Описание
query	string	да	Поисковый запрос в свободной форме
project_id	string		Необязательный uid проекта для ограничения области поиска
assigned_to_me	boolean		Только результаты, назначенные пользователю токена
page	integer		Номер страницы (по умолчанию 1)
per_page	integer		Результатов на странице, 1–50 (по умолчанию 20)

get_cardтолько чтение

Читает одну карточку полностью: описание в AgileHero Markup с идентификаторами блоков и description_version (которые принимают preview_description_update / update_description), размещение в списке, эпик, метки, исполнители, автор, тип, оценка, срок выполнения, чек-листы, ссылки, вложения, связанные карточки и обсуждения в виде цепочки. Принимает только uid карточки — параметра project_id нет. Uid карточек берутся из list_cards, search или search_cards.

Параметр	Тип	Обязательный	Описание
id	string	да	Уникальный идентификатор карточки

get_epicтолько чтение

Читает один эпик полностью: описание в AgileHero Markup с идентификаторами блоков и description_version (которые принимают preview_description_update / update_description), название, номер, цвет, даты начала/окончания, исполнители, чек-листы, ссылки, вложения, все карточки в нем (uid, номер, название и их список с категорией — null list означает бэклог — в порядке доски, так что это способ перечислить все карточки эпика и увидеть, какие из них в работе, в процессе или готовы) и обсуждения в виде цепочки. Принимает только uid эпика — параметра project_id нет. Uid эпиков берутся из list_epics или search.

Параметр	Тип	Обязательный	Описание
id	string	да	Уникальный идентификатор эпика

list_wiki_pathsPro · wikiтолько чтение

Перечисляет всё дерево вики проекта в порядке отображения — каждую папку и страницу с uid, названием, типом (страница или папка) и parent_id — чтобы агент мог определить uid страницы, который принимает show_wiki_page, и выбрать parent_id для create_wiki_page. Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
project_id	string	да	Уникальный идентификатор проекта

show_wiki_pagePro · wikiтолько чтение

Получает вики-страницу в формате AgileHero Markup (AHM) с её document_version. Содержимое — это AHM, а не markdown — идентификаторы блоков, якоря <discussion> и ссылки <image/>/<attachment/> являются частью документа; прочитайте get_ahm_spec перед редактированием. Редактирование через preview_wiki_page_update, затем update_wiki_page, используя идентификаторы блоков и document_version, возвращенные здесь. Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
id	string	да	Уникальный идентификатор пути страницы

get_ahm_specтолько чтение

Спецификация AgileHero Markup (AHM) v1.0 — ЕДИНСТВЕННЫЙ формат форматированного текста, который принимает AgileHero (markdown и HTML отклоняются). Прочитайте это ОДИН РАЗ перед написанием или редактированием любого форматированного текста (вики-страницы, описания карточек/эпиков, комментарии): словарь, атрибуты, правила экранирования и рабочий пример. Тот же текст в вебе: https://agilehero.io/docs/mcp/agilehero-markup

create_wiki_pagePro · wiki

Создает вики-страницу (при необходимости внутри папки) с содержимым в AgileHero Markup (AHM). Содержимое должно быть обернуто в <agile-hero-markup version="1.0"> — markdown и HTML отклоняются; сначала прочитайте get_ahm_spec. Возвращает uid новой страницы, url, document_version и содержимое. Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
project_id	string	да	Уникальный идентификатор (uid) проекта
name	string	да	Заголовок страницы
parent_id	string		Необязательный uid папки (из list_wiki_paths)
content	string		Тело страницы в AHM; опустите для пустой страницы

preview_wiki_page_updatePro · wikiтолько чтение

ОБЯЗАТЕЛЬНЫЙ первый шаг каждого обновления вики-страницы: проверяет операции и возвращает вычисленные сервером последствия (добавленные/удаленные/измененные блоки, файлы, которые будут удалены навсегда, обсуждения команды, которые потеряют свои якоря, предупреждения о возможном markdown), а также preview_token, который требует update_wiki_page. Ничего не изменяется. Операции адресуются по блокам (replace_block / insert_after / delete_block / move_block) с содержимым AHM — сначала прочитайте get_ahm_spec, а идентификаторы блоков и document_version получите из show_wiki_page. Просмотрите последствия перед сохранением: указанное удаление файла или открепление обсуждения допустимо только тогда, когда пользователь об этом попросил. Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
id	string	да	Uid пути страницы
document_version	string	да	Из show_wiki_page — подтверждает актуальность
operations	array of object	да	Применяются по порядку к изменяющемуся документу

update_wiki_pagePro · wikiразрушающее

Применяет ранее просмотренное обновление к вики-странице. Требует preview_token из preview_wiki_page_update для ИМЕННО этих операций и этой document_version — сохранение без предварительного просмотра невозможно по дизайну. Каждое сохранение создает версию страницы, которую люди могут откатить в приложении. Возвращает обновленную страницу (AHM + новая document_version) и примененные последствия. Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
id	string	да	Uid пути страницы
document_version	string	да	Версия, на основе которой был сделан предпросмотр
operations	array of object	да	Точные операции, которые были просмотрены
preview_token	string	да	Из preview_wiki_page_update

preview_description_updateтолько чтение

ОБЯЗАТЕЛЬНЫЙ первый шаг каждого редактирования описания карточки или эпика: проверяет операции с блоками и возвращает вычисленные сервером последствия, а также preview_token, который требует update_description. Ничего не изменяется. Содержимое — это AgileHero Markup (AHM, поверхность описания: без таблиц, цветов, выравнивания, обсуждений или вложений файлов) — сначала прочитайте get_ahm_spec; идентификаторы блоков и document_version берутся из get_card / get_epic.

Параметр	Тип	Обязательный	Описание
resource_type	enum: card | epic	да
id	string	да	Uid карточки или эпика
document_version	string	да	Из get_card / get_epic
operations	array of object	да	Применяются по порядку к изменяющемуся описанию

update_descriptionразрушающее

Применяет ранее просмотренное обновление описания к карточке или эпику. Требует preview_token из preview_description_update для ИМЕННО этих операций и этой document_version — сохранение без предварительного просмотра невозможно по дизайну. Возвращает обновленное описание (AHM + новая document_version).

Параметр	Тип	Обязательный	Описание
resource_type	enum: card | epic	да
id	string	да	Uid карточки или эпика
document_version	string	да	Версия, на основе которой был сделан предпросмотр
operations	array of object	да	Точные операции, которые были просмотрены
preview_token	string	да	Из preview_description_update

list_whiteboardsPro · whiteboardтолько чтение

Перечисляет доски проекта (uid, название, количество элементов, url). Используйте get_whiteboard для чтения элементов доски. Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
project_id	string	да	Уникальный идентификатор проекта

create_whiteboardPro · whiteboard

Создает пустую доску в проекте. Добавляйте содержимое с помощью create_whiteboard_elements. Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
project_id	string	да	Уникальный идентификатор проекта
name	string	да	Название доски

get_whiteboardPro · whiteboardтолько чтение

Читает доску как компактное текстовое представление: границы доски плюс одна строка на элемент — «<type> <uid> в <x>,<y> размер <w>x<h> [цвет] [родитель <frame-uid>] [связано <card|epic> <uid>] \"текст\"», соединители как «connector <uid> <from> -> <to>». Uid элементов отсюда — это дескрипторы, которые принимает каждый инструмент записи на доску. Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
id	string	да	Уникальный идентификатор доски

create_whiteboard_elementsPro · whiteboard

Создает до 100 элементов доски за один транзакционный вызов (все или ничего, одно событие реального времени). Нативные размеры, цвета и размещение текста применяются на стороне сервера — обычно достаточно указать только тип + текст (+ цвет). Опустите x/y, и элементы будут расставлены автоматически (по умолчанию сетка; arrange: row|column|grid, origin_x/origin_y/gap для настройки); укажите x/y для полного контроля. Фреймы содержат элементы через parent_id (uid существующего фрейма) или parent_ref (ref фрейма ранее в ЭТОМ вызове). Соединители связывают элементы по uid (source_id/target_id) или batch ref (source_ref/target_ref) — никогда по координатам; якоря вычисляются интерфейсом. Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
whiteboard_id	string	да	Уникальный идентификатор доски
elements	array of object	да	Создаются в порядке массива — refs разрешаются только назад
arrange	enum: grid | row | column		Раскладка для элементов без явных x/y (по умолчанию grid)
origin_x	number		Начальный x авторасстановки (по умолчанию 100)
origin_y	number		Начальный y авторасстановки (по умолчанию 100)
gap	number		Интервал авторасстановки в px (по умолчанию 20)

create_whiteboard_diagramPro · whiteboard

Рисует диаграмму (блок-схему, процесс, граф зависимостей) на доске из семантического графа — узлы, ребра, необязательные группы, БЕЗ координат: сервер выполняет многослойную раскладку сверху вниз с нативными размерами и возвращает созданные uid элементов, привязанные к вашим идентификаторам узлов. Размещается ниже существующего содержимого доски. Транзакционно (все или ничего, одно событие реального времени). Максимум 20 узлов — разделите большие потоки на две диаграммы. Держите фигуры простыми (rectangle), если семантика не требует иного (diamond = решение, stadium = начало/конец, cylinder = хранилище данных). Редактируйте результат с помощью update_whiteboard_elements — раскладка больше не выполняется. Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
whiteboard_id	string	да	Уникальный идентификатор доски
title	string		Заголовок диаграммы (заголовок фрейма или заголовок, если используются группы)
nodes	array of object	да
edges	array of object
groups	array of object
origin_x	number		Необязательный верхний левый x; по умолчанию ниже существующего содержимого
origin_y	number		Необязательный верхний левый y; по умолчанию ниже существующего содержимого

update_whiteboard_elementsPro · whiteboard

Обновление до 100 элементов доски одним вызовом «все или ничего»: перемещение (x/y), изменение размера, изменение порядка (z_index), изменение текста, изменение цвета, смена родителя (parent_id — uid фрейма или "" для отсоединения), а также стрелки/пути/подписи коннекторов. Uid элементов берутся из get_whiteboard; типы элементов изменять нельзя. Изменяются только указанные поля — несвязанные свойства сохраняются. Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
whiteboard_id	string	да	Уникальный идентификатор доски
updates	массив объектов	да

delete_whiteboard_elementsPro · whiteboardдеструктивный

Удаление до 100 элементов доски одним транзакционным вызовом. Удаление фрейма или узла ментальной карты освобождает его дочерние элементы на доске (они НЕ удаляются — укажите их uid явно, чтобы удалить и их). Коннекторы, прикрепленные к удаленным элементам, не удаляются и будут висеть. Uid элементов берутся из get_whiteboard. Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
whiteboard_id	string	да	Уникальный идентификатор доски
ids	массив строк	да	Uid элементов для удаления

review_whiteboardPro · whiteboardтолько чтение

Выполнение детерминированных проверок качества доски: текст, вероятно, выходящий за пределы элемента, видимо перекрывающиеся элементы, коннекторы с несвязанными или висящими конечными точками, цвета вне палитры интерфейса, позиции вне сетки и элементы, родитель которых был удален. Рекомендательный характер — результаты являются предложениями, а не ошибками, и доска с результатами может быть именно тем, что нужно пользователю. Используйте после рисования для проверки, исправляйте не более одного раза и не зацикливайтесь в погоне за пустым отчетом. Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
id	string	да	Уникальный идентификатор доски

convert_whiteboard_elementPro · whiteboard

Преобразование элемента доски в элемент бэклога: стикер в карточку или эпик, или фрейм в эпик (дочерние стикеры фрейма становятся карточками этого эпика; уже преобразованные дочерние элементы переназначаются, а не дублируются). Элемент остается на доске, связанный с тем, во что он был преобразован — get_whiteboard показывает связь. Элемент можно преобразовать только один раз. Текст заметки/фрейма становится заголовком, если вы не передадите свой. Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
id	string	да	Uid элемента (sticky_note или frame, из get_whiteboard)
to	перечисление: card | epic	да	Что создать
title	string		Заголовок карточки / имя эпика; по умолчанию — текст элемента
list_id	string		Только для карточки: uid целевого списка; опустите для бэклога
color	string		Только для эпика: шестнадцатеричный цвет; по умолчанию — цвет элемента

convert_mind_mapPro · whiteboard

Преобразование ментальной карты в элементы бэклога с сопоставлением по узлам: корень может стать новым эпиком (роль "epic") или прикрепиться к существующему (роль "existing_epic" + target_epic_id); другие узлы становятся карточками этого эпика (роль "card") или метками проекта (роль "label" — узлы-метки выше узла-карточки в дереве применяются к этой карточке); роль "skip" игнорирует узел. Передайте uid КОРНЕВОГО элемента как id и каждый узел, который нужно преобразовать, в nodes (неперечисленные узлы игнорируются). Одно преобразование на узел: уже преобразованные узлы отклоняются заранее — отправьте повторно без них. Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
id	string	да	Uid КОРНЕВОГО узла ментальной карты (из get_whiteboard)
nodes	массив объектов	да
target_epic_id	string		Uid эпика, обязателен с ролью "existing_epic" на корне

list_retrospectivesPro · retrospectivesтолько чтение

Список ретроспектив проекта: ретроспективы новой модели и проверки здоровья, где рабочее пространство их поддерживает, в противном случае — классические доски ретроспектив. Запись новой модели имеет uid, name, kind (retro | health_check), status (open | live | closed), date (starts_on; closes_on для проверки здоровья), текущий этап, шаблон, uid фасилитатора, количество созданных действий и url; ответ добавляет open_actions_count проекта. Используйте get_retrospective для полной картины. Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
project_id	string	да	Уникальный идентификатор проекта

create_retrospectivePro · retrospectives

Создание ретроспективы: ретроспектива новой модели, где рабочее пространство их поддерживает, в противном случае — классическая доска ретроспектив; ответ — ретроспектива, как ее возвращает get_retrospective (колонки с их uid), так что add_retro_items может следовать немедленно. Ретроспектива новой модели создается из шаблона (по умолчанию went_well), сразу открыта для заметок, и вы — фасилитатор; необязательно: focus, anonymity (по умолчанию — шаблона), participant_ids (ретроспектива с выбранными участниками; опустите для всех участников проекта с правом записи), типы вопросов check_in и feedback, а также голоса. Фасилитатор запускает ее и проводит этапы в приложении. Классические доски принимают только name, date и previous_retrospective_id и отклоняют аргументы новой модели. Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
project_id	string	да	Уникальный идентификатор проекта
name	string	да	Название ретроспективы
template	перечисление: went_well | start_stop_continue | four_ls | mad_sad_glad | kalm | daki | starfish | plus_delta | sailboat | rose_thorn_bud | wrap | hot_air_balloon | three_pigs | project_retro | postmortem | kudos_lessons		Ключ шаблона; по умолчанию went_well
starts_on	string		Дата, ISO-8601 (ГГГГ-ММ-ДД); по умолчанию — сегодня
starts_at	string		Устаревший псевдоним starts_on
focus	string		О чем эта ретроспектива, отображается под ее названием
anonymity	перечисление: anonymous | optional | named		Кто отображается на заметках: anonymous, optional (авторы могут добавить имя) или named
participant_ids	массив строк		Uid пользователей участников (list_project_users); вы всегда среди них
check_in	перечисление: safety | mood | esvp | one_word		Вопрос проверки (по умолчанию safety)
feedback	перечисление: roti | pulse | one_word		Заключительный вопрос обратной связи (по умолчанию roti)
votes	объект		Настройки голосования: budget (auto | fixed | unlimited), per_person (1-20), max_per_topic (1-10)
previous_retrospective_id	string		Только для классических досок: uid более ранней ретроспективы, чья колонка «Действия» отображается как «Прошлые действия»

get_retrospectivePro · retrospectivesтолько чтение

Чтение ретроспективы, как вы можете ее видеть: ретроспектива новой модели или проверка здоровья, где рабочее пространство их поддерживает, в противном случае — классическая доска ретроспектив. Ретроспектива новой модели возвращает настройки, этапы (текущий, таймер, прогресс), колонки (с uid), содержащие темы (группы заметок, с uid), итоги проверки и обратной связи, оставшиеся голоса, очередь обсуждения и отложенные темы, предложения, действия (созданные ею плюс открытые проекта) и, после закрытия, сводку. Конфиденциальность следует за комнатой: до раскрытия вы видите только свои заметки (каждая колонка считает заметки всех), авторы — только на именованных заметках, итоги голосов — только после их раскрытия. Проверка здоровья возвращает ее измерения и участие, ваши собственные оценки, пока она открыта, и агрегаты по измерениям после закрытия. Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
id	string	да	Uid ретроспективы (из list_retrospectives)

add_retro_itemsPro · retrospectives

Добавление элементов в ретроспективу от вашего имени, несколько сразу: заметки в ретроспективу новой модели, где рабочее пространство их поддерживает, карточки на классическую доску ретроспектив в противном случае. Каждый элемент — { column, text, recipient_id? }: column — заголовок колонки (без учета регистра) или uid из get_retrospective; text — до 1000 символов (255 на классических досках); recipient_id, uid пользователя поблагодаренного коллеги, обязателен в колонке kudos новой модели и отклоняется на классических досках. Заметка новой модели начинает свою собственную тему, и другие видят ее после раскрытия заметок; заметки принимаются только пока ретроспектива открыта для заметок или на этапе Write, иначе вызов отклоняется с кодом wrong_stage и текущим этапом. ЧАСТИЧНЫЙ сбой: допустимые элементы добавляются, недопустимые сообщаются по индексу — проверьте массив "failed". Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
retrospective_id	string	да	Uid ретроспективы
items	массив объектов	да

move_retro_itemPro · retrospectives

Перемещение элемента ретроспективы: перегруппировка заметки в ретроспективе новой модели, где рабочее пространство их поддерживает, перемещение карточки в другую колонку классической доски ретроспектив в противном случае. Новая модель, только этап Group: topic_id помещает заметку в эту тему (группу заметок); column (заголовок или uid) делает ее отдельной темой там, на позиции среди тем колонки (опустите для последней). Передайте expected_updated_at, updated_at темы заметки из get_retrospective, чтобы быть отклоненным с кодом stale, если кто-то перегруппировал ее тем временем. Вне Group вызов отклоняется с кодом wrong_stage и текущим этапом; kudos и другие заметки никогда не смешиваются. Классические доски принимают только column и position (position опущена = верх). Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
id	string	да	Uid заметки (классические доски: uid элемента) из get_retrospective
topic_id	string		Uid целевой темы; опустите column
column	string		Заголовок или uid целевой колонки
position	integer		Индекс в целевой колонке (0 = первый)
expected_updated_at	string		updated_at темы заметки при последнем чтении (проверка конфликта)

list_project_usersтолько чтение

Список участников проекта — каждый участник рабочего пространства для стандартного проекта; создатель, владельцы и администраторы рабочего пространства, а также все явно добавленные для частного — чтобы агент мог разрешать uid исполнителей, а не угадывать имена. Возвращает uid каждого участника, полное имя, электронную почту и роль в рабочем пространстве (owner, admin, member или observer). Эти uid — то, что принимает assigned_to в create_card, update_card, create_epic, update_epic и create_roadmap_slot.

Параметр	Тип	Обязательный	Описание
project_id	string	да	Уникальный идентификатор проекта

list_board_listsтолько чтение

Список списков канбан-доски проекта, чтобы агент мог разрешить допустимый пункт назначения move_card. Возвращает каждый активный список в порядке отображения с его uid (используется как цель move_card) и отображаемым именем. Бэклог включен как выбираемая запись с идентификатором пустой строки.

Параметр	Тип	Обязательный	Описание
project_id	string	да	Уникальный идентификатор (uid) проекта

list_epicsтолько чтение

Список эпиков проекта, чтобы агент мог разрешать uid эпиков для get_epic и назначения карточек. Возвращает каждый эпик в порядке отображения (позиция по возрастанию) с его uid, номером, именем, описанием (Markdown), цветом, датами начала/конца и количеством карточек.

Параметр	Тип	Обязательный	Описание
project_id	string	да	Уникальный идентификатор (uid) проекта
updated_since	string		Только эпики, чья запись изменилась в эту дату или позже (ISO-8601 дата или дата-время). Предостережение: правки коллекций (чек-листы, ссылки) могут не обновлять время изменения эпика; правки имени/даты/описания — всегда.

list_labelsтолько чтение

Список меток проекта, чтобы агент мог повторно использовать существующую таксономию вместо создания почти дубликатов при записи карточек. Возвращает каждую метку в порядке отображения (позиция по возрастанию) с ее uid, именем и позицией.

Параметр	Тип	Обязательный	Описание
project_id	string	да	Уникальный идентификатор (uid) проекта

list_cardsтолько чтение

Выводит список карточек одной канбан-колонки или бэклога проекта, если list_id опущен или пуст, в порядке отображения на доске (сначала верх колонки, т.е. по убыванию позиции размещения — тот же порядок, который показывает пользовательский интерфейс продукта). Фильтры объединяются по принципу И: epic_id, label_id, assigned_user_id и reporter_id принимают uid (неизвестный uid не соответствует ничему); due_date оставляет карточки со сроком выполнения на указанную дату или раньше. Возвращает сводки карточек, достаточные для действий (uid, заголовок, колонка + позиция, эпик, метки, исполнители, автор, срок выполнения), готовые для get_card / move_card / update_card, с постраничной разбивкой через limit (по умолчанию 50, максимум 100) и offset; total_count — полное количество после фильтрации.

Параметр	Тип	Обязательный	Описание
project_id	string	да	Уникальный идентификатор (uid) проекта
list_id	string		Uid колонки для чтения; опустите или передайте пустую строку для бэклога
epic_id	string		Только карточки этого эпика (uid эпика) в выбранной колонке или бэклоге; чтобы вывести все карточки эпика во всех колонках, используйте get_epic
label_id	string		Только карточки с этой меткой (uid метки)
assigned_user_id	string		Только карточки, назначенные этому пользователю (uid пользователя)
reporter_id	string		Только карточки, созданные этим пользователем (uid пользователя)
due_date	string		Только карточки со сроком выполнения на эту дату или раньше (ISO-8601, например 2026-06-10)
updated_since	string		Только карточки, запись которых изменена на эту дату или время ISO-8601 или позже — фильтр «что изменилось с момента моего последнего запуска». Оговорка: правки в прикреплённых коллекциях (метки, чек-листы, ссылки) могут не обновлять время изменения карточки; правки заголовка/описания/скалярных полей обновляют всегда.
limit	integer		Размер страницы, 1–100 (по умолчанию 50)
offset	integer		Количество карточек для пропуска (по умолчанию 0)

search_cardsтолько чтение

Поиск карточек по подстроке заголовка в пределах одного проекта (канбан-доска и бэклог), точно соответствующий живому поиску карточек в продукте (регистронезависимая подстрока в базе данных только по заголовку карточки — описания и комментарии не ищутся; используйте инструмент search для полнотекстового поиска по всем типам контента), упорядоченный от новых к старым. Возвращает сводки карточек, достаточные для действий (uid, заголовок, размещение в колонке + позиция, эпик, метки, исполнители, автор, срок выполнения); запрос без совпадений возвращает пустой массив cards, а не ошибку. Постраничная разбивка через limit (по умолчанию 50, максимум 100) и offset; total_count — полное количество совпадений.

Параметр	Тип	Обязательный	Описание
project_id	string	да	Уникальный идентификатор (uid) проекта
query	string	да	Текст для сопоставления с заголовками карточек (регистронезависимая подстрока)
limit	integer		Размер страницы, 1–100 (по умолчанию 50)
offset	integer		Количество совпадающих карточек для пропуска (по умолчанию 0)

list_attention_cardsPro · метрикитолько чтение

Выводит список карточек, требующих внимания на канбан-доске проекта — те же списки, что на страницах метрик продукта. Виды: stuck (застрявшие в колонке, не в бэклоге/в Done, без перемещений более 7 дней; сначала самые давно застрявшие), blocking (незавершённые карточки, которыми заблокированы другие карточки), overdue (со сроком выполнения в ближайшие 7 дней или уже просроченные; сначала самые срочные). kind выбирает один список или 'all' (по умолчанию). Опционально фильтр по uid исполнителя или литералу 'unassigned'. Каждая запрошенная секция возвращает сводки карточек, готовые для get_card / move_card / update_card, ограниченные limit с полным total_count. Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
project_id	string	да	Уникальный идентификатор (uid) проекта
kind	enum: stuck | blocking | overdue | all		Какой список внимания вернуть (по умолчанию 'all' = каждый список как отдельная секция)
assignee_id	string		Только карточки, назначенные этому uid пользователя, или 'unassigned' для карточек без исполнителя
limit	integer		Максимум карточек на секцию, 1–100 (по умолчанию 50)

get_metrics_summaryPro · метрикитолько чтение

Одним вызовом возвращает количество карточек, требующих внимания на канбан-доске проекта: overdue_cards_count, blocking_cards_count и stuck_cards_count — те же определения, что в list_attention_cards, который возвращает карточки за каждым счётчиком. Дешёвый вызов; сначала вызовите его, чтобы решить, стоит ли углубляться. Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
project_id	string	да	Уникальный идентификатор (uid) проекта

list_roadmap_slotsPro · дорожная картатолько чтение

Выводит список слотов дорожной карты проекта, пересекающихся с окном дат (по умолчанию: с текущего месяца на пять месяцев вперёд). Слот планирует эпик между двумя датами и может иметь исполнителей; один эпик может занимать несколько слотов, включая пересечения — это предусмотрено дизайном. Возвращает не более 200 слотов — сузьте окно, если достигнут предел. Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
project_id	string	да	Уникальный идентификатор проекта
start_date	string		Начало окна, ISO-8601 (ГГГГ-ММ-ДД); по умолчанию: начало текущего месяца
end_date	string		Конец окна, ISO-8601; по умолчанию: start_date + 6 месяцев

create_roadmap_slotPro · дорожная карта

Планирует эпик на дорожной карте проекта: слот с start_date по end_date, опционально с исполнителями. Эпик может занимать несколько слотов, и пересечения разрешены по дизайну — сначала проверьте list_roadmap_slots, если вы хотите расширить существующий слот, а не добавить новый. Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
project_id	string	да	Уникальный идентификатор проекта
epic_id	string	да	Uid эпика (из list_epics); должен принадлежать этому проекту
start_date	string	да	ISO-8601 (ГГГГ-ММ-ДД)
end_date	string	да	ISO-8601; допускается тот же день, что и start_date
assigned_to	массив строк		Uid пользователей для назначения (участники проекта — см. list_project_users)

update_roadmap_slotPro · дорожная карта

Обновляет слот дорожной карты: переносит или изменяет размер (start_date/end_date), перемещает на другой эпик того же проекта (epic_id) или задаёт исполнителей. Изменяются только переданные поля, КРОМЕ assigned_to, который ЗАМЕНЯЕТ весь набор исполнителей — сначала прочитайте слот и отправьте всех, кто должен остаться. Uid слотов берутся из list_roadmap_slots. Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
id	string	да	Uid слота дорожной карты
epic_id	string		Новый uid эпика (тот же проект)
start_date	string		ISO-8601 (ГГГГ-ММ-ДД)
end_date	string		ISO-8601
assigned_to	массив строк		ЗАМЕНЯЕТ всех исполнителей (uid пользователей, участники проекта); [] очищает

delete_roadmap_slotPro · дорожная картаразрушающее

ОКОНЧАТЕЛЬНО удаляет слот дорожной карты (и его связи с исполнителями). Это действие нельзя отменить — для слотов дорожной карты нет корзины. Сам эпик не затрагивается; для переноса предпочтительнее update_roadmap_slot. Требуется рабочее пространство Pro или пробное.

Параметр	Тип	Обязательный	Описание
id	string	да	Uid слота дорожной карты (из list_roadmap_slots)

create_label

Создаёт новую метку в проекте по имени. Если метка с таким же именем уже существует (без учёта регистра), возвращается существующая метка без изменений, а не создаётся почти дубликат. Новая метка добавляется в конец порядка отображения.

Параметр	Тип	Обязательный	Описание
project_id	string	да	Uid проекта, которому принадлежит метка
name	string	да

create_card

Создаёт карточку на канбан-доске проекта. Обязательны только project_id и title. Опустите list_id, чтобы поместить карточку в бэклог; опустите position, чтобы присоединиться к концу очереди (move_card описывает контракт позиции). description — это разметка AgileHero — никогда не markdown и не HTML; сначала прочитайте get_ahm_spec. epic_id и uid исполнителей должны уже существовать (list_epics, list_project_users), а имена меток, которых ещё нет, создаются в проекте. estimation — это сложность по Фибоначчи (0/1/2/3/5/8/13), а не оценка времени. Чек-листы, ссылки, вложения и связи карточек могут быть переданы в этом же вызове.

Параметр	Тип	Обязательный	Описание
project_id	string	да	Uid проекта, которому принадлежит карточка (карточка создаётся на канбан-доске проекта)
list_id	string		Uid колонки; опустите для размещения в бэклоге
position	integer
type	enum: story | bug | chore | research
title	string	да
description	string		Разметка AgileHero (AHM) — никогда не markdown и не HTML; сначала прочитайте get_ahm_spec. Поверхность описания: без таблиц, цветов, выравнивания и обсуждений.
epic_id	string		Uid эпика; должен уже существовать в проекте
estimation	enum: 0 | 1 | 2 | 3 | 5 | 8 | 13		Оценка сложности в стори-поинтах (шкала Фибоначчи), а не оценка времени
due_date	string		Дата ISO-8601
assigned_to	массив строк		Uid пользователей-исполнителей, доступные через list_project_users
labels	массив строк		Имена меток; неизвестные имена создаются в проекте
checklists	массив объектов		Каждый { name, items: [{ description, checked }] }; элементы сохраняют переданный порядок
cards_relations	массив объектов		Каждый { type, target_card_id (uid карточки на той же доске) }
links	массив объектов		Каждый { url, description }
attachments	массив объектов		Каждый { url, name }; файл загружается по url

update_cardразрушающее

Обновляет существующую карточку по её uid. Для коллекций предпочтительны дельта-поля add_*/remove_* (безопасные инкрементальные правки: add_labels, remove_assignees, add_checklist_items, check_items, …); обычные поля коллекций (labels, assigned_to, checklists, cards_relations, links, attachments) РАЗРУШАЮЩЕ ЗАМЕНЯЮТ предыдущее состояние и не могут комбинироваться со своими дельтами. Используйте move_card для изменения колонки или позиции и preview_description_update / update_description для редактирования описания.

Параметр	Тип	Обязательный	Описание
id	string	да	UID карточки
type	enum: story | bug | chore | research
title	string
epic_id	string
estimation	enum: 0 | 1 | 2 | 3 | 5 | 8 | 13		Оценка сложности в стори-поинтах (шкала Фибоначчи), а не оценка времени
due_date	string		Дата в формате ISO-8601
assigned_to	array of string		UID пользователей-исполнителей, доступны через list_project_users; заменяет исполнителей карточки
labels	array of string		Названия меток; неизвестные названия создаются в проекте; заменяет метки карточки
checklists	array of object		Каждый { name, items: [{ description, checked }] }; элементы сохраняют указанный порядок; заменяет чек-листы карточки
cards_relations	array of object		Каждый { type, target_card_id (UID карточки на той же доске) }; заменяет связи карточки
links	array of object		Каждый { url, description }; заменяет ссылки карточки
attachments	array of object		Каждый { url, name }; файл загружается по url; заменяет вложения карточки
add_labels	array of string		Добавить метки по названию (неизвестные названия создаются); сохраняет существующие метки
remove_labels	array of string		Удалить метки по названию (без учёта регистра); отсутствующие названия игнорируются
add_assignees	array of string		Добавить исполнителей по UID пользователя; сохраняет существующих исполнителей
remove_assignees	array of string		Удалить исполнителей по UID пользователя; отсутствующие UID игнорируются
add_checklist_items	array of object		Добавить элементы: каждый { checklist, description, checked? } — указанный чек-лист создаётся, если его нет
check_items	array of object		Отметить элементы как выполненные, сопоставление по точному описанию внутри указанного чек-листа
uncheck_items	array of object		Отметить элементы как невыполненные (сопоставление как в check_items)
remove_checklist_items	array of object		Удалить элементы; отсутствующие элементы игнорируются
add_relations	array of object		Добавить связи; сохраняет существующие связи
remove_relations	array of object		Удалить соответствующие связи; отсутствующие игнорируются
add_links	array of object		Добавить ссылки: каждая { url, description? }; сохраняет существующие ссылки
remove_links	array of string		Удалить ссылки по точному url; отсутствующие url игнорируются

delete_carddestructive

Мягкое удаление карточки по её UID: она исчезает с доски и из всех списков, её связи с другими карточками удаляются, любые сессии оценки по ней деактивируются, а связанные с ней элементы whiteboard отвязываются. Эпик, к которому она относилась, не удаляется. Восстановление через MCP невозможно.

Параметр	Тип	Обязательный	Описание
id	string	да	UID карточки

move_card

Переместить карточку в другой список (или изменить её позицию в том же списке). Перемещать можно только карточки на канбан-доске; карточки на ретроспективных досках отклоняются. Передайте пустую строку для list_id, чтобы переместить карточку в бэклог канбана. Список отображается сверху вниз от самой высокой позиции, поэтому позиция 0 — это НИЗ списка. Если опустить position, карточка добавляется в конец очереди (низ, позиция 0) в бэклоге и в списках to_do и in_progress, или в начало списка done.

Параметр	Тип	Обязательный	Описание
id	string	да	UID карточки
list_id	string	да	UID целевого списка; пустая строка перемещает в бэклог (только канбан)
position	integer		Размещение в целевом списке: 0 — низ, самая высокая позиция — верх. Должно быть от 0 до количества других карточек, уже находящихся в целевом списке. Опустите, чтобы добавить в конец очереди (позиция 0) в бэклоге и в списках to_do и in_progress, или в начало списка done.

create_epic

Создать эпик в проекте. Обязательны только project_id и name. description — это AgileHero Markup, никогда не markdown или HTML; сначала прочитайте get_ahm_spec. UID исполнителей берутся из list_project_users. Чек-листы, ссылки и вложения можно указать в этом же вызове. Возвращает UID нового эпика — то, что create_card / update_card принимают как epic_id, и что планирует create_roadmap_slot.

Параметр	Тип	Обязательный	Описание
project_id	string	да	UID проекта, к которому относится эпик
name	string	да
description	string		AgileHero Markup (AHM) — никогда не markdown или HTML; сначала прочитайте get_ahm_spec. Поверхность описания: без таблиц, цветов, выравнивания и обсуждений.
color	string		Шестнадцатеричный цвет, например #0060F0
start_date	string		Дата в формате ISO-8601
end_date	string		Дата в формате ISO-8601
assigned_to	array of string		UID пользователей-исполнителей, доступны через list_project_users
checklists	array of object		Каждый { name, items: [{ description, checked }] }; элементы сохраняют указанный порядок
links	array of object		Каждый { url, description }
attachments	array of object		Каждый { url, name }; файл загружается по url

update_epicdestructive

Обновить существующий эпик по его UID; изменяются только указанные поля. Для коллекций предпочтительнее использовать дельта-поля add_*/remove_* (безопасные инкрементальные правки); обычные поля коллекций (assigned_to, checklists, links, attachments) РАЗРУШИТЕЛЬНО заменяют предыдущее состояние и не могут комбинироваться со своими дельтами. Используйте preview_description_update / update_description для редактирования описания.

Параметр	Тип	Обязательный	Описание
id	string	да	UID эпика
name	string
color	string		Шестнадцатеричный цвет, например #0060F0
start_date	string		Дата в формате ISO-8601
end_date	string		Дата в формате ISO-8601
assigned_to	array of string		UID пользователей-исполнителей, доступны через list_project_users; заменяет исполнителей эпика
checklists	array of object		Каждый { name, items: [{ description, checked }] }; заменяет чек-листы эпика
links	array of object		Каждый { url, description }; заменяет ссылки эпика
attachments	array of object		Каждый { url, name }; файл загружается по url; заменяет вложения эпика
add_assignees	array of string		Добавить исполнителей по UID пользователя; сохраняет существующих исполнителей
remove_assignees	array of string		Удалить исполнителей по UID пользователя; отсутствующие UID игнорируются
add_checklist_items	array of object		Добавить элементы: каждый { checklist, description, checked? } — указанный чек-лист создаётся, если его нет
check_items	array of object		Отметить элементы как выполненные, сопоставление по точному описанию внутри указанного чек-листа
uncheck_items	array of object		Отметить элементы как невыполненные (сопоставление как в check_items)
remove_checklist_items	array of object		Удалить элементы; отсутствующие элементы игнорируются
add_links	array of object		Добавить ссылки: каждая { url, description? }; сохраняет существующие ссылки
remove_links	array of string		Удалить ссылки по точному url; отсутствующие url игнорируются

delete_epicdestructive

Мягкое удаление эпика по его UID. Его карточки НЕ удаляются — они остаются на доске, отвязанные от эпика. Слоты дорожной карты эпика УДАЛЯЮТСЯ навсегда (слот планирует эпик, поэтому без него он бессмысленен), а связанные с эпиком элементы whiteboard отвязываются.

Параметр	Тип	Обязательный	Описание
id	string	да	UID эпика

create_comment

Добавить комментарий к карточке или эпику. Укажите ровно один из card_id или epic_id. Содержимое — это AgileHero Markup (AHM, поверхность комментария: без таблиц, медиа, цветов, выравнивания и обсуждений) — никогда не markdown или HTML; сначала прочитайте get_ahm_spec. Комментарий приписывается вошедшему пользователю, от имени которого действует этот клиент, и появляется в последующих ответах get_card / get_epic. Комментарии нельзя редактировать через MCP; delete_comment удаляет ваши собственные (исправляйте ошибки удалением + повторной публикацией). Передайте parent_comment_id, чтобы ответить на существующий комментарий. Ветки имеют глубину один уровень: ответ на ответ прикрепляется к корню ветки этого ответа, поэтому не пытайтесь вкладывать ответы. Родительский комментарий должен быть на той же карточке или эпике — UID из любого другого места отклоняется.

Параметр	Тип	Обязательный	Описание
card_id	string		UID карточки для комментария (взаимоисключающе с epic_id)
epic_id	string		UID эпика для комментария (взаимоисключающе с card_id)
content	string	да	Текст комментария в формате AgileHero Markup (AHM)
parent_comment_id	string		Необязательный UID комментария на ТОЙ ЖЕ карточке или эпике для ответа. Опустите для комментария верхнего уровня. Ответ на ответ нормализуется к корню ветки этого ответа (ветки имеют глубину один уровень).

delete_commentdestructive

Удалить комментарий, который опубликовали ВЫ (комментарии приписываются вошедшему пользователю, от имени которого действует этот клиент — чужие комментарии удалить нельзя). Схема исправления: удаление + публикация исправленного комментария через create_comment. Удалённый комментарий, имеющий ответы, остаётся видимым как заглушка в своей ветке. UID комментариев берутся из get_card / get_epic.

Параметр	Тип	Обязательный	Описание
id	string	да	UID комментария