MCP для AI-агентов

Model Context Protocol — стандарт, по которому AI-ассистенты подключают внешние инструменты. У SearchBooster два MCP-сервера:

Сервер	Адрес	Для чего	Доступ
Каталог	`https://api.searchbooster.net/mcp`	Поиск товаров, подсказки, похожие, виджеты — для AI-консультанта на сайте или в мессенджере	UUID проекта в заголовке `X-MCP-Project-UUID`
Управление	`https://web4.searchbooster.io/api/mcp`	Настройки проекта, синонимы, правила мерчандайзинга, статистика — для команды магазина	API-ключ: `Authorization: Bearer …`

Транспорт — Streamable HTTP (JSON-RPC 2.0).

Каталог: подключение

claude mcp add --transport http searchbooster https://api.searchbooster.net/mcp \
  --header "X-MCP-Project-UUID: PROJECT_UUID"

{
  "mcpServers": {
    "searchbooster": {
      "url": "https://api.searchbooster.net/mcp",
      "headers": { "X-MCP-Project-UUID": "PROJECT_UUID" }
    }
  }
}

curl -X POST https://api.searchbooster.net/mcp \
  -H 'Content-Type: application/json' \
  -H 'X-MCP-Project-UUID: ca8fc618-9ee9-48f1-b9b6-92e810424297' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_products","arguments":{"query":"самоед","limit":3}}}'

Инструменты каталога

Инструмент	Что делает	Аргументы
`search_products`	Поиск товаров с фильтрами и сортировкой	`query`, `limit`, `skip`, `categoryId[]`, `regionId`, `sortBy`, `sortDest`, `params[]`, `userId`
`get_completions`	Подсказки по началу запроса	`query`, `limit`, `regionId`
`find_by_id`	Товар по ID	`id`
`search_grouped`	Варианты одной модели	`id`, `regionId`, `params`
`search_by_category`	Выдача по нескольким категориям	`structureByCategoryId[]`, `query`, `limit`
`get_popular_products`	Популярные товары	`limit`, `categoryId[]`, `regionId`
`get_similar_products`	Похожие товары	`id`, `limit`, `regionId`
`get_widget`	Рекомендации виджета	`id`, `userId`, `limit`, `regionId`, `categoryId[]`
`get_categories_settings`	Дерево категорий	`parentId`, `level`, `maxLevel`

Запросы через MCP помечаются client=mcp и не смешиваются со статистикой поиска на сайте.

Пример промпта: «Подбери щенка до 5 000 ₽, белого окраса, покажи 3 варианта со ссылками и объясни разницу» — агент сам вызовет search_products с фильтром по цене и окрасу.

Управление проектом

Сервер управления позволяет AI-агенту работать с проектом так же, как менеджер в личном кабинете:

проекты и настройки поиска;
синонимы — просмотр, добавление, загрузка CSV;
правила мерчандайзинга;
статистика через query_cube — «какие запросы чаще всего не находят товары на этой неделе?»;
резервные копии настроек: перед каждым изменением сохраняется бэкап.

claude mcp add --transport http searchbooster-admin https://web4.searchbooster.io/api/mcp \
  --header "Authorization: Bearer API_KEY"