MCP-интеграции

MCP (Model Context Protocol) — открытый протокол, через который внешние инструменты и AI-агенты работают с каталогом RedCatalog2. Адаптер даёт строго типизированный доступ к продуктам и таксономии и позволяет создавать, обновлять, публиковать и архивировать карточки без прямых запросов к API.

Что даёт MCP-доступ

Чтение каталога

Поиск и выборка опубликованных продуктов и таксономии через list_products, get_product и list_taxonomy

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

Создание и обновление продуктов из агента или скрипта: create_product, update_product

Публикация

Перевод карточек между статусами draft, published и archived прямо из инструмента

Инструменты MCP

Всего доступно 10 инструментов. Инструменты записи требуют аутентификации через login.

Чтение каталога

list_products

Список опубликованных продуктов с поиском, фильтрами и пагинацией

resourcestable
search?, category?, tag?, page?, pageSize?
{ items: Product[], pagination }

get_product

Полная публичная карточка продукта по slug

resourcestable
slug: string
Product с полным набором полей

list_taxonomy

Доступные slug’и категорий и тегов

resourcestable
entityType?: program | skill | mcp | api
{ categories: Category[], tags: Tag[] }

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

create_product

Создаёт продукт в статусе draft

toolstable
name, slug?, summary?, descriptionMarkdown?, categorySlugs?, tagSlugs?, …
Созданный Product со статусом draft

update_product

Частичное обновление: меняются только указанные поля

toolstable
slug + любые изменяемые поля
Обновлённый Product

publish_product

Переводит продукт из draft в published

toolstable
slug: string
Product со статусом published и заполненным publishedAt

archive_product

Переводит продукт из published в archived

toolstable
slug: string
Product со статусом archived

create_and_publish_product

Создаёт и сразу публикует продукт одним вызовом

toolstable
Как у create_product
Опубликованный Product

Сессия

login

Открывает админ-сессию по email и паролю

resourcestable
email: string, password: string
Session — токен, роль и данные пользователя

whoami

Показывает текущую админ-сессию

toolstable
—
Session — текущий пользователь и роль

Примеры интеграции

Наполнение каталога из агента

Агент вызывает list_taxonomy, чтобы узнать доступные категории, затем create_product и publish_product — карточка появляется на сайте с SEO-метаданными.

Обновление описаний по расписанию

Скрипт читает продукты через list_products и правит формулировки вызовом update_product, не затрагивая остальные поля.

Снятие продукта с публикации

При отзыве продукта вендором автоматика вызывает archive_product — карточка исчезает с сайта и из sitemap.

Связанные разделы