Что такое токен, какие бывают области доступа, как работают режимы «Только чтение», «Чтение и черновики» и «Полный доступ» и какие настройки есть у сервера.
Токен доступа
Токен — это пароль для программы. Он привязан к пользователю Joomla: все действия выполняются от его имени и проверяются по его правам. Токен никогда не может больше, чем сам пользователь.
Создаётся в Компоненты → Dharma MCP → Токены доступа → Создать. Поля:
- Название — для вашего удобства («Claude Code», «Отчёты»).
- Пользователь Joomla.
- Области доступа — что разрешено.
- Срок действия — пусто означает бессрочно; для опасных областей лучше короткий.
- Разрешённые IP-адреса — необязательно. Для облачных программ (Claude, ChatGPT) не заполняйте: их адреса меняются.
Само значение токена показывается один раз, потом на сайте остаётся только его «отпечаток». Отозвать токен можно в любой момент: отключить или удалить в списке.
Программы, которые входят через сайт (Claude, ChatGPT), получают токены автоматически: они видны в списке как «OAuth: название программы», доступ живёт час и сам обновляется (общая авторизация действует 30 дней). Отключение такой записи сразу прекращает доступ.
Области доступа
| Область | Что разрешает |
|---|---|
shop:read | читать товары, заказы, остатки, справочники и настройки магазина |
shop:write | менять заказы, товары, цены, остатки, категории, акции, доставку, оплату и другие справочники |
content:read / content:write | читать / менять материалы, меню и модули |
template:read / template:write | читать / менять стили и файлы шаблона |
system:read / system:write | читать / менять настройки Joomla, плагины, кэш, robots.txt, читать базу данных |
customers:pii | видеть персональные данные покупателей (дополнительно нужна общая настройка) |
Выдавайте минимум: чтение — для отчётов, запись — доверенным ассистентам. Области «Шаблон» и «Система» нужны разработчику, а сами наборы по умолчанию выключены (Система → Плагины, группа dharmamcp).
Режимы работы сервера
Выбираются в Компоненты → Dharma MCP → Настройки → Режим работы сервера:
| Режим | Что происходит |
|---|---|
| Только чтение | Ассистент ничего не может изменить. |
| Чтение и черновики (по умолчанию) | Новое создаётся неопубликованным. Любое изменение того, что уже видят посетители (опубликованный текст, цена, статус заказа), и любое удаление выполняется только после вашего подтверждения. |
| Полный доступ | Изменения «вживую» выполняются без подтверждения, но опасные (удаление, файлы, настройки, плагины) и загрузка таблицы цен — всегда с подтверждением. |
Остальные настройки сервера
- Включить MCP-сервер — общий выключатель.
- Требовать HTTPS — оставьте включённым.
- Разрешить вход через сайт (OAuth) и Разрешить программам регистрироваться самим — нужны для Claude и ChatGPT.
- Разрешить выдачу персональных данных и Маскировать персональные данные — по умолчанию данные покупателей скрыты, а при разрешении показываются частично.
- Срок хранения журнала (по умолчанию 90 дней) и Лимит запросов в минуту (по умолчанию 60 на один токен).