MCP управления проектом
MCP управления предназначен для команды магазина. Агент может читать и, если разрешено, изменять настройки поиска, синонимы, мерчандайзинг, фильтры и фид только в пределах выбранного проекта.
| Параметр | Значение |
|---|---|
| Endpoint | https://web4.searchbooster.io/api/public-mcp |
| Авторизация | Отдельный MCP-токен и UUID проекта |
| Безопасный старт | Режим «Только чтение» и только необходимые группы операций |
Сервер принимает синхронные POST-запросы JSON-RPC 2.0 по Streamable HTTP. SSE не поддерживается.
Выпуск токена
Заголовок раздела «Выпуск токена»- Откройте проект в личном кабинете.
- Перейдите в раздел «Настройки для ИИ-агентов (MCP)».
- Нажмите «Выпустить токен» и задайте понятное имя агента.
- Для первого подключения выберите режим «Только чтение».
- Оставьте только необходимые группы операций.
- Скопируйте токен сразу после выпуска: повторно он не показывается.
Если раздел сообщает, что MCP не входит в тариф, отправьте заявку на этой же странице. Выпуск токена доступен пользователю с правом изменения проекта.
Подключение
Заголовок раздела «Подключение»Для MCP управления нужны оба заголовка:
Authorization: Bearer MCP_TOKENX-MCP-Project-UUID: PROJECT_UUIDclaude 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"{ "mcpServers": { "searchbooster-settings": { "url": "https://web4.searchbooster.io/api/public-mcp", "headers": { "Authorization": "Bearer MCP_TOKEN", "X-MCP-Project-UUID": "PROJECT_UUID" } } }}curl -X POST https://web4.searchbooster.io/api/public-mcp \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer MCP_TOKEN' \ -H 'X-MCP-Project-UUID: PROJECT_UUID' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Замените MCP_TOKEN и PROJECT_UUID значениями из личного кабинета. Готовый JSON-конфиг с UUID можно скопировать прямо со страницы проекта.
Права и группы операций
Заголовок раздела «Права и группы операций»При выпуске токена выбираются:
- только чтение — агент видит данные, но не получает инструменты записи;
- чтение и запись — агент может выполнять разрешённые изменения;
- группы операций: настройки поиска, синонимы, мерчандайзинг, фильтры и категории, фид и индексация, аналитика.
Проекты и журнал изменений доступны всегда: без них агент не сможет найти проект и показать результат своей работы. Итоговые права — пересечение ограничений токена и максимальных разрешений, установленных SearchBooster для проекта. Токен одного проекта не даёт доступ к другому проекту.
Безопасное изменение настроек
Заголовок раздела «Безопасное изменение настроек»Перед изменением агент должен:
- прочитать текущее состояние и справочник доступных полей;
- использовать актуальную
revision, чтобы не затереть параллельные изменения; - выполнить
dryRun, если инструмент его поддерживает, и показать будущий diff; - после подтверждения применить изменение;
- проверить запись в журнале.
Изменения записываются в журнал MCP. Последнюю допустимую операцию можно отменить через rollback_change. Агент не может менять тариф и служебные настройки или удалять правила мерчандайзинга.
Как передать доступ разработчику
Заголовок раздела «Как передать доступ разработчику»Передайте разработчику:
- ссылку на эту страницу;
- UUID проекта или готовый конфиг из личного кабинета;
- отдельный токен агента через менеджер секретов или другой защищённый канал.
Не отправляйте токен в обычном письме или мессенджере, не вставляйте его в URL и не сохраняйте конфигурацию с токеном в Git. Для разных агентов выпускайте разные токены. Неиспользуемый или скомпрометированный токен отзовите в личном кабинете.
Проверка подключения
Заголовок раздела «Проверка подключения»Попросите агента:
Покажи доступные инструменты SearchBooster и прочитай состояние проекта, ничего не изменяя.
tools/list должен вернуть только разрешённые инструменты. Если MCP настроен в режиме чтения, инструменты записи в список не попадут.
Если подключение не работает, проверьте endpoint, оба заголовка, статус API-доступа в тарифе, права владельца токена и выбранные группы операций. В обращении в поддержку укажите время запроса, MCP-клиент и текст ошибки, но не прикладывайте токен.