Каталог KUDO MCP: ТД «КУДО» — подключение и использование MCP

О каталоге

KUDO MCP — единый полный каталог товаров Торгового дома «КУДО», входящего в Группу компаний «Русские Технические Аэрозоли». Он объединяет информацию о продукции пяти брендов: KUDO, KERRY, AXIOM, RUSH и DONEWELL. Торговый дом занимается производством, продажей, дистрибуцией и продвижением продукции группы. Информация о ТД «КУДО».

Через одно подключение ИИ получает артикулы, названия, описания, характеристики, сведения об упаковке, штрихкоды, коды ТН ВЭД, ссылки на изображения и документы — те сведения, которые заполнены в каталоге для конкретного товара. Доступ только для чтения. Цен, складских остатков и оформления заказов в MCP нет.

Под полным каталогом здесь понимается общий ассортимент всех пяти брендов, разрешённый к публичной публикации и включённый в текущую выгрузку. Архивные, закрытые и ещё не опубликованные позиции могут отсутствовать; доступность, число позиций и время данных проверяются через catalog_status. Пустой результат поиска сам по себе не означает, что товар никогда не выпускался.

Бренды и официальные сайты

На семи сайтах представлены направления продукции и материалы для её применения:

RUSH и DONEWELL также входят в общий MCP-каталог. Их продукция встречается на сайтах перечисленных направлений: например, у KUDO PURFOAM есть разделы монтажной пены RUSH и монтажной пены DONEWELL. Домен сайта не заменяет сведения о бренде и артикуле конкретного товара.

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

Для чего использовать MCP

• Быстро получать сведения о товарах всех пяти брендов в одном разговоре с ИИ.
• Сверять артикулы, характеристики, упаковку и штрихкоды, сравнивать варианты товаров.
• Готовить и обновлять описания и характеристики карточек своего магазина, сайта, маркетплейса или внутреннего справочника на основе данных каталога.
• Находить ссылки на технические листы, декларации и другие документы.
• Готовить ответы покупателям и партнёрам, отмечая отсутствующие сведения и дату использованных данных.

Каталог регулярно обновляется из данных компании. MCP помогает получить свежие сведения для обновления ваших материалов: он сам не изменяет карточки магазина, не публикует тексты и не запускает обновление исходного каталога. Внесение изменений в вашу систему выполняется отдельно, с её доступами и средствами интеграции. После подключения начните с catalog_status, чтобы проверить доступность и время последнего снимка.

Как ИИ получает инструкцию по подбору

При подключении KUDO MCP передаёт ИИ правила работы с каталогом и подбора продукции: KERRY — повседневный уход за автомобилем; AXIOM — профессиональные задачи СТО и предприятий; KUDO — окраска, строительство и ремонт; DONEWELL — практичные решения с разумной стоимостью; RUSH — базовые решения для простых задач. Пригодность конкретного товара проверяется по его характеристикам и применению.

Полная инструкция также доступна через MCP resource kudo://guides/product-selection. Это внутренний адрес ресурса MCP, который клиент может прочитать через resources/read, а не веб-ссылка. Копировать её вручную обычно не нужно: тот же текст включён в ответ при подключении. Передача инструкции модели зависит от клиента. После обновления сервера переподключите MCP или обновите сведения о нём в приложении.

Параметры подключения

Простая отправка ссылки в чат не подключает MCP. Добавьте сервер в настройках MCP/коннекторов своего приложения, затем включите его для разговора.

ChatGPT, веб-версия

Если вашему аккаунту и рабочему пространству доступен Developer mode:

1. В настройках откройте Security and login и включите Developer mode.
2. Откройте раздел Plugins и через кнопку «+» создайте приложение для удалённого MCP.
3. Укажите название KUDO MCP, URL из таблицы и No Authentication.
4. В меню «+» нового разговора выберите Developer mode и включите KUDO MCP.
5. Попросите: «Используй KUDO MCP и проверь, доступен ли каталог и когда он обновлён».

Названия элементов могут отличаться в локализованном интерфейсе. Если добавление недоступно, уточните ограничения аккаунта или правила рабочего пространства у его администратора. Developer mode поддерживает наши четыре инструмента без требования переименовывать их в search/fetch. Официальная инструкция OpenAI.

Claude

В доступном интерфейсе Customize → Connectors выберите «+» → Add custom connector, укажите название KUDO MCP и URL из таблицы. OAuth Client ID и Client Secret оставьте пустыми: сервер не требует авторизации. После добавления включите коннектор для разговора через меню «+» → Connectors.

Для Team/Enterprise сначала может потребоваться добавление коннектора владельцем организации. Доступность зависит от плана и настроек организации. Инструкция Claude, поддержка подключения без авторизации.

Codex CLI

Для подключения через Codex CLI выполните:

codex mcp add kudo-mcp --url https://gkrta.ru/mcp
codex mcp list

Откройте новую сессию Codex и проверьте сервер через /mcp. Команда mcp list показывает конфигурацию; успешный вызов catalog_status подтверждает обмен с каталогом. OAuth-вход для KUDO MCP не нужен.

Вместо команды добавления можно дописать в существующий ~/.codex/config.toml только этот раздел, сохранив остальные настройки:

[mcp_servers.kudo-mcp]
url = "https://gkrta.ru/mcp"

Документация MCP для Codex.

DeepSeek (Дипсик) через Cherry Studio

Модель DeepSeek может работать с каталогом через приложение с поддержкой MCP, например Cherry Studio. Приложение подключает инструменты каталога, выполняет запросы модели и передаёт ей результаты.

1. В Cherry Studio откройте Settings → Model Services → DeepSeek. Укажите API-ключ своего аккаунта DeepSeek. Адрес API модели — https://api.deepseek.com; это отдельная настройка от MCP. Загрузите список доступных моделей и выберите модель с поддержкой вызова инструментов.
2. Откройте Settings → MCP → MCP Servers → Add. Назовите сервер KUDO MCP, выберите Streamable HTTP и укажите https://gkrta.ru/mcp. Авторизация не нужна; оставьте ключи и заголовок Authorization пустыми.
3. Включите сервер. В его списке инструментов должны появиться catalog_status, search_products, get_product и get_product_documents.
4. В разделе Work откройте меню своего агента → Edit → MCP и подключите KUDO MCP. Для этого агента выберите настроенную модель DeepSeek. Одного добавления сервера в общие настройки недостаточно: он должен быть включён у агента, которому вы задаёте вопрос.
5. Отправьте новое сообщение: «Используй KUDO MCP. Проверь дату каталога, затем найди очистители KERRY и покажи артикулы и характеристики». Если приложение запрашивает разрешение на вызов инструментов, разрешите чтение из KUDO MCP.

Ключ DeepSeek хранится в настройках провайдера модели в вашем приложении; его не нужно передавать серверу KUDO MCP. Использование API модели оплачивается по условиям DeepSeek, а подключение к MCP-каталогу не требует ключа или подписки.

Эти шаги относятся к Cherry Studio, а не к меню сайта или мобильного приложения DeepSeek. Простая отправка URL в обычный чат DeepSeek не подключает MCP. В другом клиенте нужна поддержка одновременно DeepSeek с вызовом инструментов и удалённого MCP через Streamable HTTP.

Настройка DeepSeek в Cherry Studio, подключение MCP и включение у агента, вызов инструментов в DeepSeek API.

Другие приложения

Нужна поддержка удалённого MCP через Streamable HTTP без авторизации. Не каждый ИИ-чат позволяет добавлять произвольный MCP-сервер. Формат JSON/TOML-конфигурации зависит от клиента; единого файла настроек для всех приложений нет. Локальный stdio и старый SSE-транспорт для этого сервера не используются.

Что спросить у ИИ

После подключения достаточно обычного вопроса, например:

• «Используй каталог KUDO MCP. Найди герметики KUDO и покажи артикулы и названия».
• «Найди очистители KERRY и AXIOM. Сравни выбранные товары по имеющимся характеристикам».
• «Покажи товары RUSH и DONEWELL из доступного каталога, сначала по одному примеру каждого бренда».
• «Покажи характеристики товара с артикулом …, включая упаковку, массу и ТН ВЭД».
• «Найди технический лист и декларацию для этого товара. Дай ссылки и имеющиеся даты».
• «Сравни эти два артикула по характеристикам из каталога. Отметь отсутствующие данные».
• «Сверь мою карточку товара с каталогом ТД „КУДО“ по артикулу … и подготовь исправления описания, характеристик и упаковки. Не заполняй пропуски догадками».
• «Когда были выгружены данные каталога? Можно ли считать этот снимок свежим?»

Вместо многоточия используйте настоящий артикул. Если точный артикул неизвестен, начните с короткого фрагмента названия или кода. Поиск текстовый, не смысловой: при отсутствии результатов попробуйте более короткое ключевое слово.

Доступные инструменты

ИИ получает описания и схемы аргументов от сервера. Пользователю не нужно составлять JSON для обычного вопроса. Сервер также передаёт общую инструкцию; её использование моделью зависит от клиента.

article — основной артикул товара. source_article — отдельный технический код: не отбрасывайте его суффиксы, чтобы получить основной артикул. Найдите товар по этому коду и используйте article из результата.

Поиск возвращает до 50 кратких карточек за вызов, по умолчанию 20. Фильтр brand требует точного написания с учётом регистра. Следующая страница запрашивается через next_cursor с теми же query и brand. При смене снимка поиск нужно начать заново. Не запускайте множество параллельных запросов и не загружайте весь каталог, если для задачи достаточно нескольких карточек.

Как понимать результат

• extracted_at — время исходного снимка, а не момент ответа ИИ. Данные обновляются периодически; ответы могут кэшироваться до минуты.
• stale=true означает, что снимку больше 36 часов. ИИ должен сообщить об устаревании, а не выдавать данные за актуальные на текущую минуту.
• available=false означает недоступный каталог. Это не доказательство отсутствия товара.
• found=false или пустой поиск означает отсутствие совпадения в доступном снимке, а не обязательное прекращение производства.
• null — данных нет. Это не нулевое значение и не отрицательный ответ. Единицы измерения указаны в именах полей: мм, г, °C, дни.
• Сервис возвращает ссылки на документы, но не скачивает их и не подтверждает доступность или действительность. Пустой список означает отсутствие записанных ссылок. Имеющиеся даты и номер декларации сами по себе не подтверждают её текущий статус.

При получении характеристик полезно просить ИИ указывать артикул, название, дату снимка и недостающие сведения. Обновить каталог или изменить товары через MCP нельзя.

Если подключение не работает

Проверьте подключение в выбранном приложении вызовом catalog_status: в ответе должны быть доступность каталога и время снимка.

Ограничение ответственности и данные пользователей

Характер информации. KUDO MCP предоставляет справочные сведения о продукции. Сервис работает только в режиме чтения: через него нельзя изменять каталог или загружать файлы. В каталоге возможны неточности, неполнота и задержки обновления; ИИ-помощник может неверно истолковать данные или дополнить ответ сведениями, которых в каталоге нет. Перед выбором, применением продукции или публикацией товарной карточки сверяйте информацию с актуальной маркировкой, инструкцией производителя, техническим листом и паспортом безопасности. При расхождениях уточняйте сведения у представителя соответствующего бренда. Ответ ИИ не заменяет эти документы и профессиональную оценку пригодности продукта для конкретной задачи.

Пределы ответственности. ТД «КУДО» не гарантирует отсутствие ошибок в сведениях, полученных через MCP, точность выводов сторонних ИИ-сервисов и бесперебойную доступность каталога. В пределах, допускаемых применимым законодательством, ТД «КУДО» не несёт ответственности за последствия использования неточных или неверно истолкованных сведений и решений, принятых исключительно на основе ответов ИИ без проверки по документам производителя. Эти условия не ограничивают права потребителей, гарантии на продукцию и ответственность, которые не могут быть исключены или ограничены законом.

Данные пользователей. Публичный MCP не требует регистрации, не запрашивает имя, телефон, адрес электронной почты и другие данные для идентификации пользователя. Мы не создаём пользовательские профили и не ведём историю переписки с ИИ. Для выполнения вызовов приложение передаёт серверу параметры поиска и запросов к каталогу; они обрабатываются для получения результата и могут кратковременно находиться в оперативном кэше. Для обеспечения работоспособности, диагностики и защиты от злоупотреблений используются технические журналы и сводная статистика работы сервиса. Для поиска достаточно артикула или ключевых слов; персональные данные, пароли и конфиденциальные сведения для этого не нужны.

Сторонние приложения. ИИ-помощник и приложение, через которое вы подключаетесь к MCP, работают по собственным условиям и политикам конфиденциальности. Они могут обрабатывать и хранить переписку, запросы и полученные ответы. ТД «КУДО» не управляет обработкой данных этими сервисами; перед использованием ознакомьтесь с их правилами.