Перейти к содержимому

MCP управления проектом

MCP управления предназначен для команды магазина. Агент может читать и, если разрешено, изменять настройки поиска, синонимы, мерчандайзинг, фильтры и фид только в пределах выбранного проекта.

Параметр Значение
Endpoint https://web4.searchbooster.io/api/public-mcp
Авторизация Отдельный MCP-токен и UUID проекта
Безопасный старт Режим «Только чтение» и только необходимые группы операций

Сервер принимает синхронные POST-запросы JSON-RPC 2.0 по Streamable HTTP. SSE не поддерживается.

  1. Откройте проект в личном кабинете.
  2. Перейдите в раздел «Настройки для ИИ-агентов (MCP)».
  3. Нажмите «Выпустить токен» и задайте понятное имя агента.
  4. Для первого подключения выберите режим «Только чтение».
  5. Оставьте только необходимые группы операций.
  6. Скопируйте токен сразу после выпуска: повторно он не показывается.

Если раздел сообщает, что MCP не входит в тариф, отправьте заявку на этой же странице. Выпуск токена доступен пользователю с правом изменения проекта.

Для MCP управления нужны оба заголовка:

Authorization: Bearer MCP_TOKEN
X-MCP-Project-UUID: PROJECT_UUID
Окно терминала
claude mcp add --transport http searchbooster-settings \
https://web4.searchbooster.io/api/public-mcp \
--header "Authorization: Bearer MCP_TOKEN" \
--header "X-MCP-Project-UUID: PROJECT_UUID"

Замените MCP_TOKEN и PROJECT_UUID значениями из личного кабинета. Готовый JSON-конфиг с UUID можно скопировать прямо со страницы проекта.

При выпуске токена выбираются:

  • только чтение — агент видит данные, но не получает инструменты записи;
  • чтение и запись — агент может выполнять разрешённые изменения;
  • группы операций: настройки поиска, синонимы, мерчандайзинг, фильтры и категории, фид и индексация, аналитика.

Проекты и журнал изменений доступны всегда: без них агент не сможет найти проект и показать результат своей работы. Итоговые права — пересечение ограничений токена и максимальных разрешений, установленных SearchBooster для проекта. Токен одного проекта не даёт доступ к другому проекту.

Перед изменением агент должен:

  1. прочитать текущее состояние и справочник доступных полей;
  2. использовать актуальную revision, чтобы не затереть параллельные изменения;
  3. выполнить dryRun, если инструмент его поддерживает, и показать будущий diff;
  4. после подтверждения применить изменение;
  5. проверить запись в журнале.

Изменения записываются в журнал MCP. Последнюю допустимую операцию можно отменить через rollback_change. Агент не может менять тариф и служебные настройки или удалять правила мерчандайзинга.

Передайте разработчику:

  1. ссылку на эту страницу;
  2. UUID проекта или готовый конфиг из личного кабинета;
  3. отдельный токен агента через менеджер секретов или другой защищённый канал.

Не отправляйте токен в обычном письме или мессенджере, не вставляйте его в URL и не сохраняйте конфигурацию с токеном в Git. Для разных агентов выпускайте разные токены. Неиспользуемый или скомпрометированный токен отзовите в личном кабинете.

Попросите агента:

Покажи доступные инструменты SearchBooster и прочитай состояние проекта, ничего не изменяя.

tools/list должен вернуть только разрешённые инструменты. Если MCP настроен в режиме чтения, инструменты записи в список не попадут.

Если подключение не работает, проверьте endpoint, оба заголовка, статус API-доступа в тарифе, права владельца токена и выбранные группы операций. В обращении в поддержку укажите время запроса, MCP-клиент и текст ошибки, но не прикладывайте токен.

Вернуться к обзору MCP →