MCP-серверы YClients и Ozon одним деплоем
MCP Servers — Combined Deployment
Docker-compose деплой двух MCP-серверов за одним nginx: YClients с полным доступом к API записи и Ozon с чтением витрины через браузер
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Инструменты YClients создают и меняют записи, клиентов, кассовые операции, фискальные чеки и остатки склада
- Ozon-сервер обходит защиту от ботов эмуляцией браузера для чтения витрины
- Стоит начинать с токена только на чтение, если YClients такой выдает
Установка
Ручная установка
docker compose up --buildПосле cp .env.example .env и заполнения YCLIENTS_PARTNER_TOKEN. Проверка: curl http://localhost/health.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Репозиторий поднимает через docker-compose и nginx два независимых MCP-сервера под общими путями /yclients/mcp и /ozon/mcp. yclients-mcp-server на Python и FastMCP собран из официальной OpenAPI-спецификации YClients и дает 32 инструмента на 305 операций: записи, клиенты, сотрудники, услуги, кассы и финансы, лояльность, склад, фискализация чеков, аналитика. Раз в неделю workflow сверяет спецификацию и обновляет код инструментов. ozon-mcp-server на Node.js и Playwright не использует официальный Seller API, а водит headless-браузер по витрине Ozon.ru, обходя защиту от ботов естественной навигацией, и отдает поиск товаров, карточки, категории и фильтры без авторизации.
Для кого. Для разработчиков сервисов на YClients, которым нужен агент для записи и финансов, и заодно быстрый поиск товаров на Ozon без интеграции с Seller API.
Подходит, если
- Нужно, чтобы агент создавал и менял записи, клиентов и кассовые операции в YClients
- Нужен быстрый поиск товаров и цен на Ozon без официального Seller API и токена
- Нужен единый docker-compose деплой на Timeweb Cloud App Platform или свой сервер
Не подходит, если
- Нужен только один из двух сервисов: проще поставить его отдельно, не разворачивая весь монорепозиторий
- Нужен доступ к личному кабинету продавца Ozon: сервер только читает открытую витрину
- Важна стабильность контракта: спецификация YClients меняется, а Ozon может в любой момент усилить защиту от ботов
Пример запроса к агенту
Покажи свободные окна на завтра в YClients и подбери на Ozon аналог этого товара подешевлеОграничения
Монорепозиторий без лицензии в корне (у подпроектов MIT), ноль звезд, один автор, релизов нет. README документирует деплой только двух серверов, YClients и Ozon, хотя в репозитории есть и отдельные MCP-серверы для Google Calendar и решения капчи, не связанные с этой связкой. Ozon-сервер зависит от обхода антибот-защиты сайта через Playwright и может сломаться при ее обновлении. Шаги установки самого расширения в YClients README не описывает, только API.
Как отключить. Остановите стек docker compose down и удалите записи yclients и ozon из конфигурации MCP-клиента.
MCP
- Транспорт
- http
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| YCLIENTS_PARTNER_TOKEN обязательная, секрет | Партнерский токен YCLIENTS из Маркетплейса, обязателен для сервера записи |
| YCLIENTS_USER_TOKEN секрет | Пользовательский токен для операций с данными конкретной компании |
Проверка безопасности
- Инструменты YClients создают и меняют записи, клиентов, кассовые операции, фискальные чеки и остатки склада
- Ozon-сервер обходит защиту от ботов эмуляцией браузера для чтения витрины
- Стоит начинать с токена только на чтение, если YClients такой выдает
Коротко о README
README монорепозитория описывает связку yclients-mcp-server и ozon-mcp-server за nginx через docker-compose: структура каталогов, команды локального запуска и проверки через curl, переменные окружения YCLIENTS_PARTNER_TOKEN и YCLIENTS_USER_TOKEN, шаги деплоя на Timeweb Cloud App Platform с выбором Docker Compose как типа деплоя и конфиг для Claude Desktop и Claude Code. Отдельные README серверов дают полный список инструментов YClients по разделам API и описывают технику обхода антибот-защиты Ozon через естественную навигацию и эмуляцию поведения человека.
Частые вопросы
Нужен ли токен для инструментов Ozon?
Нет, ozon-mcp-server просто читает открытую витрину браузером. Токен YCLIENTS_PARTNER_TOKEN нужен только для сервера YClients.
Что будет, если Ozon изменит защиту от ботов?
README прямо предупреждает, что защита Ozon может измениться и сервер потребует обновлений, гарантий стабильности нет.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма