Как подключить AI-клиент к данным Yoolip через MCP

Раздел MCP-доступ позволяет подключить ChatGPT, Claude, Codex или другой совместимый AI-клиент к данным ваших магазинов в Yoolip. После подключения можно задавать вопросы на обычном языке: сравнивать продажи, анализировать рекламу, проверять остатки, смотреть юнит-экономику и находить пропуски в обновлении данных.

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

Что такое MCP

MCP — это способ безопасно предоставить AI-клиенту доступ к разрешённым данным Yoolip. Клиент обращается к инструментам Yoolip, получает результат и использует его для ответа на ваш вопрос.

Вам не нужно передавать AI-клиенту API-ключи Ozon или Wildberries. Авторизация проходит через вход в Yoolip и отдельный экран согласия.

Что понадобится для подключения

Перед началом проверьте:

нужный магазин подключён к Yoolip;
данные магазина загружены и обновлены;
ваш AI-клиент поддерживает удалённый MCP по HTTP и OAuth;
на вашем тарифе AI-клиента доступны пользовательские подключения.

Доступность режима разработчика и пользовательских коннекторов зависит от тарифа ChatGPT или Claude. Yoolip не управляет этими ограничениями.

Адрес MCP-сервера

Используйте адрес:

https://yoolip.ai/mcp

Его также можно скопировать кнопкой Скопировать адрес на странице MCP-доступ.

Не добавляйте к адресу параметры и не вставляйте в AI-клиент API-ключи маркетплейсов. Клиент сам откроет вход в Yoolip и экран согласия.

Как подключить AI-клиент

ChatGPT, Codex, Claude и другие совместимые клиенты подключаются к одному адресу Yoolip и проходят одинаковую OAuth-авторизацию. Различается только место, где в интерфейсе клиента добавляют MCP-сервер.

Общий порядок подключения:

Скопируйте адрес https://yoolip.ai/mcp.
Добавьте его как удалённый MCP-сервер или пользовательское подключение в выбранном AI-клиенте.
Запустите авторизацию: клиент откроет страницу входа в Yoolip.
На экране согласия проверьте имя клиента, адрес возврата и магазины, к которым предоставляется доступ.
Подтвердите подключение.

После успешной авторизации оно появится в блоке Подключения на странице MCP-доступ.

ChatGPT

Откройте Settings → Security and login.
Включите Developer mode.
Перейдите в раздел ChatGPT Plugins и нажмите кнопку добавления плагина.
Укажите понятное название и описание подключения.
В разделе Connection выберите публичный адрес и вставьте https://yoolip.ai/mcp.
Создайте подключение, проверьте найденные инструменты и пройдите авторизацию в Yoolip.

Если режима разработчика или добавления собственного подключения нет, проверьте возможности аккаунта и правила рабочего пространства ChatGPT.

Codex

В приложении Codex или расширении для IDE:

Откройте Settings → MCP servers.
Нажмите Add server.
Укажите название Yoolip, тип Streamable HTTP и адрес https://yoolip.ai/mcp.
Сохраните сервер и перезапустите приложение или расширение, если клиент предложит это сделать.
Нажмите Authenticate и завершите вход в Yoolip.

Если сервер уже добавлен в конфигурацию Codex, OAuth-вход можно запустить в терминале с помощью команды:

codex mcp login yoolip

ChatGPT и Codex используют один MCP-сервер Yoolip, однако подключение, созданное в веб-версии ChatGPT, не переносится в Codex автоматически. Локальную конфигурацию на одном компьютере могут совместно использовать приложение ChatGPT, Codex CLI и расширение Codex для IDE.

Claude

Откройте Настройки → Коннекторы.
Выберите Добавить пользовательский коннектор.
Вставьте адрес https://yoolip.ai/mcp.
Пройдите вход в Yoolip и подтвердите доступ.

Пользовательские коннекторы доступны не на всех тарифах Claude.

Другие MCP-клиенты

Подойдёт клиент, который поддерживает:

удалённый MCP по HTTP;
OAuth-авторизацию;
версию протокола 2026-07-28 или 2025-11-25.

Добавьте адрес https://yoolip.ai/mcp в настройки удалённых MCP-серверов. Клиент сам найдёт параметры авторизации, после чего откроет вход в Yoolip и экран согласия. Точное название пункта меню зависит от клиента.

Что проверить перед подтверждением доступа

На экране согласия убедитесь, что:

указан знакомый AI-клиент;
адрес возврата относится к выбранному клиенту;
перечислены нужные магазины.

Если имя клиента или адрес возврата выглядят неожиданно, отмените подключение. После подтверждения доступ появится в блоке Подключения на странице MCP-доступ.

Какие данные можно получить

AI-клиент может читать:

список доступных магазинов и дату обновления их данных;
каталог товаров: название, SKU и артикул продавца;
продажи, заказы, доставки, возвраты и отмены;
трафик, корзины, сессии и конверсии;
рекламу, кампании и связанные показатели;
остатки, резерв и запас в днях;
цены, скидки и ценовой индекс;
рейтинг карточки и количество отзывов;
фактическую прибыль, маржу, ROI и удержания площадки;
суммы движения денег по категориям и дням;
планы поставок и рекомендованные объёмы;
историю обновления данных.

Поисковые фразы и внешний трафик доступны только для магазинов Ozon. Для Wildberries пофразная статистика через MCP не предоставляется.

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

Обычно не нужно указывать название инструмента вручную — AI-клиент выбирает его по смыслу вопроса. Таблица ниже помогает понять, какие данные доступны.

Инструмент	Что возвращает
`yoolip_list_shops`	Доступные магазины, площадку и дату последнего обновления
`yoolip_describe_data`	Каталог доменов, метрик, единиц измерения, измерений и ограничений
`yoolip_get_sync_freshness`	Свежесть данных, пропущенные дни за последние 30 дней и состояние синхронизации
`yoolip_list_products`	Каталог товаров с идентификатором Yoolip, SKU, артикулом, названием и признаком архивности
`yoolip_query_metrics`	Агрегированные показатели продаж, заказов, трафика, рекламы, остатков, цен, юнит-экономики, ДДС и поставок
`yoolip_get_product_metrics`	Показатели по выбранным товарам, при необходимости с разбивкой по дням
`yoolip_query_campaigns`	Метрики рекламных кампаний: показы, клики, расход, корзины, заказы, выручка, CTR, CPC и ДРР
`yoolip_query_search_phrases`	Метрики по поисковым фразам покупателей для Ozon
`yoolip_query_external_traffic`	Кампании и показатели внешнего трафика для Ozon
`yoolip_get_sync_history`	История обновлений: статус, тип, длительность, обработанные товары, ошибки и фазы

Для первого знакомства с подключением попросите AI-клиент сначала определить доступные магазины, каталог метрик и свежесть данных. Это уменьшает риск запроса несуществующего показателя или анализа неполного периода.

Примеры запросов

Можно начать с таких формулировок:

«Покажи список моих магазинов в Yoolip и дату последнего обновления данных».
«Какие показатели доступны по рекламе и юнит-экономике?»
«Проверь, все ли дни за последние 30 дней загружены по магазину Конект».
«Сравни выручку и количество заказов за 01.09.2026–07.09.2026 по дням».
«Покажи товары с отрицательной прибылью за последние 28 дней».
«Сравни рекламные кампании по расходу, заказам, выручке и ДРР».
«Найди товары с остатком меньше чем на 14 дней продаж».
«Покажи планы поставок и рекомендованные объёмы по магазинам».

Для более точного результата указывайте:

магазин;
точные даты начала и окончания периода;
нужные показатели;
необходимую группировку — по дням, товарам, магазинам или кампаниям;
нужен ли итог или подробная таблица.

Если вопрос касается последних данных, сначала попросите проверить их свежесть.

Ограничения

При работе через MCP действуют ограничения:

не больше 200 строк на одну страницу результата;
максимальное окно запроса по дням — 366 дней;
для показателей конкретных товаров окно ограничено 92 днями;
в одном запросе показателей можно передать не больше 100 товаров;
токен доступа действует 10 минут и продлевается AI-клиентом автоматически;
данные возвращаются в том виде, в котором их рассчитал Yoolip.

Дата запроса и дата последнего обновления — не одно и то же. Если данные ещё не синхронизированы, AI-клиент не сможет получить более свежие значения, чем есть в Yoolip.

Какие данные не передаются

Через MCP никогда не передаются:

API-ключи Ozon и Wildberries;
токены и пароли;
персональные данные покупателей и адреса;
платёжные реквизиты и данные счетов;
данные других пользователей и чужих магазинов;
комментарии к денежным операциям и контрагенты.

Подключение имеет доступ только на чтение. Через него нельзя:

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

Передача данных AI-провайдеру

Когда вы задаёте вопрос, выбранные данные Yoolip передаются подключённому AI-клиенту и его провайдеру. После передачи они обрабатываются по правилам этого провайдера. Yoolip не управляет местом и сроком хранения данных на его стороне.

Подключайте только те AI-сервисы, которым доверяете, и отзывайте доступ, когда он больше не нужен.

Yoolip показывает события подключения и безопасности, но не сохраняет содержание запросов к AI-клиенту и его ответов.

Как отозвать доступ

Откройте раздел MCP-доступ.
Проверьте блок Подключения.
Перейдите к блоку Опасная зона.
Нажмите Отозвать все подключения.
Подтвердите действие, если появится запрос на подтверждение.

Отзыв закрывает доступ немедленно: следующий запрос AI-клиента будет отклонён. Чтобы снова работать с данными Yoolip, подключение потребуется создать заново.

Кнопка недоступна, если активных подключений нет.

Частые проблемы

В ChatGPT нет режима разработчика или пользовательских коннекторов

Доступность зависит от возможностей аккаунта и правил рабочего пространства OpenAI. Yoolip не может включить эту функцию на стороне ChatGPT.

Почему подключение из ChatGPT не появилось в Codex?

Веб-версия ChatGPT не передаёт свою конфигурацию в Codex. Добавьте сервер Yoolip в настройках Codex и пройдите OAuth-авторизацию ещё раз. Приложение ChatGPT, Codex CLI и расширение Codex для IDE могут использовать общую локальную конфигурацию, только если работают на одном компьютере.

В Claude нет пункта «Добавить пользовательский коннектор»

Пользовательские коннекторы доступны не на всех тарифах Claude. Проверьте возможности своего аккаунта.

Клиент не открывает вход в Yoolip

Проверьте, что добавлен точный адрес https://yoolip.ai/mcp, а клиент поддерживает удалённый MCP по HTTP и OAuth. Для других клиентов также важна поддержка версии протокола 2026-07-28 или 2025-11-25.

Подключение не появилось в Yoolip

Убедитесь, что вход и подтверждение на экране согласия были завершены. Без согласия подключение не создаётся.

AI не видит магазин или товар

Попросите AI сначала получить список магазинов и товаров. Проверьте, что нужный магазин подключён к вашему аккаунту Yoolip и доступен текущему подключению.

AI показывает неполные или устаревшие данные

Сначала проверьте свежесть и историю обновления данных. Укажите точный магазин и период. Если в Yoolip есть пропущенные дни или незавершённая синхронизация, сначала нужно устранить проблему с данными.

Можно ли попросить AI пересинхронизировать данные или изменить настройки?

Нет. MCP-доступ работает только на чтение. Изменения и ручные действия выполняются в кабинете Yoolip.

Если ничего не помогло

Напишите в поддержку и укажите:

используемый AI-клиент;
на каком шаге возникла проблема;
дату и время попытки;
текст ошибки без токенов, паролей и других секретных данных;
скриншот экрана.

Контакты поддержки:

Telegram: @supyoolip_bot