Работа через MCP
Обновлено
Подключение и права
Инструменты появляются при установленном приложении MCP и включённом плагине «Отзывы на сайте». Без MCP обычная работа плагина сохраняется.
В правах MCP плагин регистрирует раздел «Отзывы на сайте», группы «Чтение» (requests_sitereviews.read) и «Запись» (requests_sitereviews.write). Выдайте токену нужные права:
| Право в интерфейсе | Имя права и инструмента | Группа |
|---|---|---|
| Список отзывов | requests_sitereviews_list_reviews |
Чтение |
| Смена состояния отзыва | requests_sitereviews_set_state |
Запись |
| Ответ магазина на отзыв | requests_sitereviews_answer |
Запись |
Если токен работает от имени пользователя через act_as, инструменты дополнительно проверяют его доступ к приложению «Заявки». Для токена без act_as ограничением остаются права самого токена.
Список отзывов
requests_sitereviews_list_reviews читает отзывы одной формы в режиме «Отзыв». В отличие от публичной ленты может возвращать все состояния модерации.
| Аргумент | Назначение |
|---|---|
form_id |
Обязательный ID формы |
state |
pending, published или rejected; без аргумента — все состояния |
rating |
Точная оценка от 1 до 5 |
limit |
От 1 до 100, по умолчанию 20 |
offset |
Сдвиг, по умолчанию 0 |
Результат содержит отзывы с автором, связью с контактом, текстом, частями текста, оценкой, состоянием, датой, ответом и файлами ответа магазина. Средний балл считается по отфильтрованному набору без ограничения limit.
Примеры просьб агенту:
- «Покажи отзывы формы 3 на модерации».
- «Найди отзывы формы 3 с оценкой 1 и покажи ответы магазина».
- «Прочитай все опубликованные отзывы формы 3, последовательно загружая страницы».
Смена состояния
requests_sitereviews_set_state принимает:
| Аргумент | Назначение |
|---|---|
request_ids |
Обязательный массив ID заявок-отзывов, не более 100 |
state |
Обязательное новое состояние: pending — на модерации, published — опубликован, rejected — отклонён |
notify_author |
Отправить письмо о публикации; по умолчанию false |
confirm |
Для нескольких ID обязательно true; для одного не требуется |
При notify_author=true письмо возможно только для published, если включено «Писать автору о публикации отзыва» и заполнен адрес в поле с ролью «Email». Переходы в pending и rejected писем не создают.
В результате массовой операции проверяйте и updated, и errors: ошибка одной заявки не отменяет обработку остальных. Несуществующая заявка или заявка обычной формы не считается отзывом.
Примеры просьб:
- «Опубликуй отзыв 42 без письма автору».
- «Верни отзыв 42 на модерацию».
- «Отклони отзывы 42 и 43. Подтверждаю изменение обоих».
Ответ магазина
requests_sitereviews_answer записывает или заменяет один ответ магазина.
| Аргумент | Назначение |
|---|---|
request_id |
Обязательный ID заявки-отзыва |
text |
Обязательный непустой текст ответа |
notify_author |
Отправить письмо об ответе, по умолчанию false |
Для письма также должны быть включены «Писать автору об ответе магазина» и заполнено поле с ролью «Email». Повторное сохранение того же текста не создаёт повторное письмо. Сохранение ответа не публикует сам отзыв.
Инструмент принимает текст; загрузки или удаления файлов ответа через его аргументы нет. Файлы прикладываются в карточке заявки.
Примеры просьб:
- «Ответь на отзыв 42: “Спасибо за подробный отзыв!”. Письмо не отправляй».
- «Измени ответ на отзыв 42 на согласованный текст и отправь автору письмо».
Какие данные получает агент
Инструмент чтения передаёт подключённому MCP-клиенту данные отзывов, в том числе имя автора, ID связанного контакта, текст и ответ магазина. Инструменты записи возвращают данные изменённых отзывов. Плагин сам не выбирает внешнюю ИИ-модель: получатель данных определяется подключением MCP.