REST API

REST API позволяет управлять задачами, спринтами, проектами, компаниями, биллингом и отчётами из внешних приложений.

Аутентификация

Используется API-ключ или сессия (в зависимости от настроек инстанса). Ключ передаётся в заголовке или в параметрах запроса согласно документации вашего развёртывания.

Основные группы эндпоинтов

• Задачи — создание, обновление, статусы, привязка к спринтам.
• Спринты — список, активный спринт, добавление задач.
• Проекты и компании — метаданные, настройки.
• База знаний — обновление и чтение контента.
• Биллинг — подписка, токены, платежи (если доступно).

Полный список эндпоинтов и параметров см. в OpenAPI-спецификации (docs/openapi.yaml в репозитории) или в документации вашего инстанса.

Справочник интеграции без авторизации

Для онбординга разработчиков и ИИ доступен публичный JSON с правилами подключения (без логина и API-ключа):

• Запрос: GET /api/integration/guide (на том же хосте, где открывается приложение, путь начинается с /api/).
• Дубликат для удобства: GET /api/mcp/integration-guide.
• В ответе: версия схемы (schemaVersion), список публичных эндпоинтов, как получить JWT и MCP-токен, настройка MCP через env и файл magmaster.project.json. Секреты в ответ не попадают.

Вызовы задач, багов и прочих данных по-прежнему требуют авторизации. Эндпоинт не открывает POST /mcp без Bearer — для HTTP MCP нужен токен после POST /api/auth/mcp/exchange.

MCP в Cursor и VSCode