Как подключить Ozon Seller к Cursor через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Ozon Seller, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Ozon Seller + Cursor

Управляйте кабинетом продавца Ozon из AI-агента: товары, остатки и цены, отправления FBS и FBO, возвраты, начисления и отчёт о балансе, аналитика продаж, склады, акции, отзывы и вопросы покупателей, а также обновление цен и остатков. Один Client ID и API-ключ.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

OZON_CLIENT_ID, OZON_API_KEY

Шаг 1 — Получите учётные данные

Настройка занимает около 3 минут в личном кабинете продавца Ozon. Коннектор проверен на реальных данных Ozon: инструменты для чтения протестированы на действующем кабинете продавца.

1. В личном кабинете продавца откройте Настройки → Seller API (seller.ozon.ru/app/settings/api-keys) и нажмите Сгенерировать ключ.
2. Задайте название ключа и выберите роль: Admin открывает все инструменты, более узкая роль подходит для тех инструментов, которые она покрывает. Если Ozon спросит, для чего ключ, выберите внешний сервис и укажите AnythingMCP.
3. Сразу скопируйте ключ в OZON_API_KEY: Ozon показывает его только один раз. Client ID с той же страницы (это число) скопируйте в OZON_CLIENT_ID. Установите коннектор.
4. Вызовите ozon_get_api_key_info: он покажет роли ключа и дату окончания его действия. Ключи Ozon действуют 3 месяца, поэтому создайте новый заранее.

Что читает: ваши товары по артикулу (offer_id), Ozon ID товара или SKU с названием, штрихкодами, ценами, НДС, статусом и ошибками модерации; остатки по схемам FBO, FBS и rFBS и по каждому вашему складу; цены с минимальной ценой, ценой с учётом ваших акций, индексом цен и комиссией за продажу по FBO и FBS; отправления FBS, rFBS и FBO за период и одно отправление FBS целиком, с доставкой, трек-номером, отменой и выплатой по каждому товару; возвраты с причиной и статусом; отчёт о балансе, как в разделе Финансы → Баланс, все начисления за день и начисления по отправлениям (до 200 за раз); аналитику продаж; ваши склады; акции Ozon, в которых можно участвовать; отзывы и вопросы покупателей. Контактные данные покупателей коннектор не получает.

Финансы: в сентябре 2026 года Ozon отключил старый метод списка транзакций. Коннектор уже работает с методами, которые его заменили: отчётом о балансе за период до 30 дней, списком начислений за день и начислениями по отправлениям.

Для отправлений нужен период: в списках FBS и FBO ИИ всегда указывает дату начала и дату окончания (не больше года). Для сегодняшних заказов FBS он фильтрует отправления по статусу «ожидает сборки».

Подписки: для отзывов нужна подписка Управление отзывами или Premium Pro, для вопросов покупателей нужна Premium Plus; без них Ozon отклоняет эти запросы. Без Premium Plus аналитика отдаёт только выручку и заказанные товары, за последние 3 месяца и не больше 50 запросов в день. В любом случае аналитику можно запрашивать раз в минуту.

Спрашивает перед каждым изменением: ozon_update_prices и ozon_update_stocks меняют данные в работающем магазине. ИИ показывает каждый товар со старой и новой ценой или остатком и ждёт вашего «да», затем проверяет ответ Ozon и перечитывает значения. Новый остаток заменяет текущий и не должен включать зарезервированные товары, поэтому ИИ сначала смотрит резерв. Цену каждого товара можно менять не чаще 10 раз в час. Ответы на отзывы (ozon_reply_to_review) и на вопросы (ozon_answer_question) публикуются на странице товара, поэтому ИИ показывает точный текст до публикации.

Выключены при установке: ozon_ship_fbs_posting (сборка заказа FBS по грузоместам) и ozon_cancel_fbs_posting (отмена заказа FBS: её нельзя вернуть, и она может повлиять на рейтинг продавца). Администратор включает их осознанно, и ИИ каждый раз просит явного подтверждения.

Лимиты запросов: не больше 50 запросов в секунду на один Client ID, плюс лимиты отдельных методов. При ответе 429 ИИ ждёт столько, сколько Ozon указал в Retry-After. Ozon может заблокировать ключ, который шлёт много одинаковых или ошибочных запросов.

Частые ошибки: 401 Invalid Api-Key означает, что ключ неверный, истёк или относится к другому Client ID. 403 «missing a required role» означает, что ключ работает, но его роль не покрывает этот инструмент; проверьте роли через ozon_get_api_key_info. 403 «restricted to specific IP addresses»: разрешите для ключа доступ из всех сетей.

Коннектор не создаёт и не редактирует карточки товаров, не оформляет заявки на поставку FBO, не печатает этикетки и акты, не ведёт чаты с покупателями, не подключает акции и не управляет ими и не работает с Performance API (реклама).

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Cursor

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты Ozon Seller.

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

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

• «Какие отправления FBS сейчас ожидают сборки и с какого склада?»
• «Покажи баланс на Ozon за первую половину октября: начислено, выплачено, продажи, возвраты и комиссии.»
• «Каких товаров не осталось на моём складе и сколько их ещё лежит на складах Ozon?»
• «Что Ozon начислил и удержал по отправлению 89491381-0072-1? Разбери начисления по статьям.»
• «Подними цену на артикул ART-123 с 1 990 до 2 190 рублей. Перед изменением покажи старую и новую цену.»
• «Покажи новые отзывы с оценкой 1 и 2 за эту неделю и подготовь ответы, я сначала их проверю.»

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT