Доступ и права
Обновлено
Какие права выдавать
В русской локали плагин называет свой раздел прав «Темы дизайна». Права выдаются на каждый инструмент; группы помогают выбрать нужные возможности.
| Группа | Что разрешает | Инструменты |
|---|---|---|
| Чтение | Список тем, сведения о теме, чтение файлов и настроек, сравнение с поставкой, ссылки | themes_list, themes_get_info, themes_read_file, themes_diff_file, themes_get_settings, themes_preview_url |
| Настройки | Изменение настроек темы | themes_set_settings |
| Файлы | Запись и добавление файлов, возврат к поставке, отмена операций, сброс кеша | themes_write_file, themes_add_file, themes_revert_file, themes_restore, themes_flush_cache |
Плагин не задаёт значения прав по умолчанию: доступ зависит от токена, пользователя и, при работе внутри бэкенда, роли агента.
Право «Файлы» равносильно доступу к редактору дизайна: шаблоны Smarty могут выполнять код на сервере. Выдавайте эти инструменты доверенному агенту.
Для отмены операции внешнему токену нужны и themes_restore, и право на исходную операцию. Например, отмена изменения настроек требует themes_set_settings, хотя сам инструмент отмены находится в группе «Файлы».
В токене MCP показаны отдельные группы чтения, работы с файлами и изменения настроек темы.
Права пользователя
Внешний токен должен быть действующим, не отозванным, с существующим привязанным пользователем. Пользователь должен быть администратором приложения либо иметь его право на дизайн.
Доступность поселения также зависит от прав пользователя на домен в приложении «Сайт». При записи проверяются все места использования темы, в том числе дочерние темы, блоковые страницы и зеркала доменов. Для унаследованного файла проверяются и целевая тема, и фактическая тема-владелец файла.
Ограничения токена
| Ограничение | Результат |
|---|---|
| Токен ограничен доменами | Изменение возможно, только если все затрагиваемые поселения и зеркала доступны. Неиспользуемую тему таким токеном изменить нельзя |
| Токен ограничен витринами | Изменять темы нельзя: одна тема может обслуживать несколько витрин |
| Включён режим песочницы | Предпросмотр доступен, фактические изменения и сброс кеша блокируются с sandbox_blocked |
| Нет доступа ко всем местам использования | Запись блокируется с permission_denied |
Эти ограничения относятся и к проверке области действия перед предпросмотром записи: одного права на инструмент недостаточно.
Какие данные получает агент
Инструменты возвращают сведения о темах и поселениях, содержимое разрешённых файлов и значения настроек. Эти данные попадают в использующий инструменты MCP-клиент или агент. Учитывайте его собственные правила обработки данных.
Значения настроек, в ключах которых обнаружены password, passwd, secret, token или вариант api_key, скрываются и не изменяются. Это фильтр ключей настроек, а не поиск секретов во всём содержимом файлов.
Резервные копии плагин хранит на сервере Webasyst. Отдельной отправки копий во внешний сервис, собственного webhook или задачи cron в рабочем коде плагина нет.