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

## О каталоге

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

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

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

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

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

| Сайт | Направление |
| --- | --- |
| [KUDO — лакокрасочные материалы](https://kudo-paint.ru/) | Краски, эмали, грунты, лаки, материалы для ремонта и защиты поверхностей |
| [KUDO — клеи и герметики](https://kudo-bond.ru/) | Герметики, клеи, клеи-герметики и сопутствующая строительная химия |
| [KUDO — монтажная пена](https://kudo-purfoam.ru/) | Монтажная пена, клей-пена, напыляемая теплоизоляция, очистители и инструменты |
| [KERRY](https://kerry.ru/) | Автохимия и автокосметика для ухода, обслуживания и ремонта автомобиля |
| [KERRY, English](https://kerry-auto.com/) | Англоязычный каталог и материалы KERRY |
| [AXIOM](https://axiompro.ru/) | Профессиональная автохимия, покрытия, клеи, герметики, очистители, смазки и сопутствующие материалы |
| [AXIOM, English](https://en.axiompro.ru/) | Англоязычный каталог и материалы AXIOM |

RUSH и DONEWELL также входят в общий MCP-каталог. Их продукция встречается
на сайтах перечисленных направлений: например, у KUDO PURFOAM есть разделы
[монтажной пены RUSH](https://kudo-purfoam.ru/products/category/montazhnaya-pena/professionalnaya-montazhnaya-pena-rush/)
и [монтажной пены DONEWELL](https://kudo-purfoam.ru/products/category/montazhnaya-pena/donewell/).
Домен сайта не заменяет сведения о бренде и артикуле конкретного товара.

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

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

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

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

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

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

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

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

| Поле | Значение |
| --- | --- |
| Название | KUDO MCP |
| URL сервера | `https://gkrta.ru/mcp` |
| Транспорт | Streamable HTTP |
| Авторизация | None / No Authentication |
| Логин, пароль, API-ключ | Не требуются |

Простая отправка ссылки в чат не подключает 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](https://developers.openai.com/api/docs/guides/developer-mode).

### Claude

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

Для Team/Enterprise сначала может потребоваться добавление коннектора владельцем
организации. Доступность зависит от плана и настроек организации.
[Инструкция Claude](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp),
[поддержка подключения без авторизации](https://claude.com/docs/connectors/building/authentication).

### Codex CLI

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

```sh
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`
только этот раздел, сохранив остальные настройки:

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

[Документация MCP для Codex](https://learn.chatgpt.com/docs/extend/mcp?surface=cli).

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

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

1. В Cherry Studio откройте **Settings → Model Services → DeepSeek**.
   Укажите API-ключ своего аккаунта [DeepSeek](https://platform.deepseek.com/).
   Адрес 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](https://docs.cherryai.com.cn/pre-basic/providers/deepseek),
[подключение MCP и включение у агента](https://docs.cherryai.com.cn/advanced-basic/extensions/mcp),
[вызов инструментов в DeepSeek API](https://api-docs.deepseek.com/guides/tool_calls/).

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

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

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

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

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

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

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

| Инструмент | Когда нужен |
| --- | --- |
| `catalog_status` | Доступность каталога, количество товаров и время данных |
| `search_products` | Поиск по артикулу, техническому коду, названию, бренду или категории |
| `get_product` | Полная карточка по точному публичному артикулу |
| `get_product_documents` | Записанные ссылки на документы и их реквизиты |

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

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

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

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

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

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

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

| Симптом | Что проверить |
| --- | --- |
| 404 Not Found | Проверьте точный URL: `https://gkrta.ru/mcp` |
| В браузере 405 Method Not Allowed | Обычное открытие URL не является MCP-подключением; проверяйте через клиент |
| Запрашивается OAuth или ключ | Выберите отсутствие авторизации и проверьте URL |
| 429 Too Many Requests | Сделайте паузу; соблюдайте `Retry-After`, если клиент его показывает |
| 503 / временная недоступность | Повторите позже, без частых автоматических повторов |
| Товар не найден | Проверьте `catalog_status`, сократите запрос; технический код сначала передайте в поиск |
| ИИ не использует каталог | Включите KUDO MCP для разговора и явно попросите использовать его инструменты |

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

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

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

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

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

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