Настройки приложения

Основные данные

После создания открывается страница приложения. В пункте «Настройки» находятся общие поля и состояние публикации; возможности конкретного типа вынесены в соседние пункты.

• название используется во всех языковых версиях;
• описание заполняется отдельно на вкладках «Русский» и English в блоке описания: русское описание показывается в русском каталоге, а английское — в английском;
• аватар и обложку можно загрузить, заменить или удалить после создания приложения; для отправки на модерацию обязателен аватар, обложка остаётся необязательной;
• сайт приложения можно указать после создания: домен без протокола сохраняется с https://, а явно указанный http:// или https:// не меняется;
• тип приложения выбирается при создании и в кабинете больше не меняется;
• у готового решения здесь также находится переключатель показа настроек установленных агентов;
• у интеграции на сайте доступ к проекту и доступ от пользователя настраиваются независимо в пункте «OAuth»; выбирать один неизменяемый вариант при создании не нужно.

Тестирование до публикации

Приложение со статусом «Приватное» можно открыть для отдельного проекта, не публикуя его для всех. Это позволяет проверить установку плагина или готового решения до модерации.

1. Выберите обычный тестовый проект. Готовое решение нельзя установить в его собственный исходный проект.
2. Через API вызовите POST /api/apps/{appId}/access с JSON-телом { "project_id": "ID_TEST_PROJECT" }. Нужен пользовательский OAuth-токен с правом can_manage_app_catalog и соответствующий доступ к приложению; проектный API-ключ не подходит. Через User MCP найдите операцию «Открыть доступ проекту» и используйте её полученную схему.
3. В выбранном проекте откройте каталог плагинов или готовых решений. Приватное приложение появится в каталоге этого проекта. Установите его и проверьте нужные инструменты, события или шаги. У готового решения к этому моменту должна быть опубликована версия.

Выдача такого доступа не устанавливает приложение автоматически и не разрешает ему читать данные проекта. Установка и OAuth-подтверждение остаются отдельными действиями. Для проверки «Интеграции на сайте» пройдите проектную OAuth-авторизацию: она доступна и до публикации, без предварительной выдачи доступа к каталогу.

GET /api/apps/{appId}/access возвращает проекты с выданным доступом. DELETE /api/apps/{appId}/access/{projectId} закрывает этот доступ, но не удаляет уже созданную установку и не отзывает её токены. Чтобы прекратить работу приложения в проекте, отдельно удалите установку.

Публикация в каталоге

Блок публикации находится под общими настройками у приложения любого типа. Перед отправкой укажите общее название, заполните описание на русском и английском языках и загрузите аватар. Затем выполните условие для выбранного типа:

• для интеграции на сайте добавьте хотя бы один redirect URI;
• для плагина настройте хотя бы одну возможность: инструменты агента, встроенную страницу или действия приложения;
• для готового решения создайте исходный проект и опубликуйте хотя бы одну версию.

После этого нажмите «Отправить на модерацию».

Пока заявка рассматривается, кабинет показывает статус ожидания и дату отправки; проверка может занять до двух недель. При отклонении исправьте замечания из комментария модератора и отправьте приложение повторно. После одобрения приложение можно скрывать из каталога и показывать снова без повторной модерации. Участник без права управления публикацией видит состояние, но не может отправлять заявку или менять видимость.

Удаление приложения

Кнопка «Удалить» находится слева в нижней строке общих настроек, рядом с кнопкой сохранения. Удалить приложение может только владелец. Кнопка открывает окно подтверждения; окончательное действие выполняется через «Удалить» в этом окне.

После подтверждения приложение исчезает из кабинета и каталога. API отзывает все установки, проектные и пользовательские OAuth-доступы, refresh-токены и неиспользованные коды авторизации; вебхуки и настройки приложения перестают работать. Затем кабинет возвращается к списку приложений.