Руководство по коннектору7 мин чтенияMCP-инструментов: 167 языков

Подключить Éxito к Claude через MCP: товары и заказы

Позволь своему ИИ управлять магазином на маркетплейсе exito.com в Колумбии через API продавца Grupo Éxito: получай список товаров и статус их одобрения, создавай товары с изображениями, описаниями и атрибутами, устанавливай цены и остатки, читай заказы и выписки о выплатах.

HCАвтор: команда HelpCodeОбновлено 7 мин чтения Открытый код на GitHub

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

Grupo Éxito Marketplace

Grupo Éxito Marketplace

Let your AI run your exito.com marketplace store in Colombia through Grupo Éxito's seller API: list your products and their approval status, create products with images, descriptions and attributes, set prices and stock, and read orders and payout statements.

инструментов

16

Регион

INTL

Категория

Электронная коммерция

Аутентификация

Sign-in token

Требуемые env-vars

EXITO_USERNAMEEXITO_PASSWORDEXITO_API_KEYEXITO_LOGIN_URLEXITO_SELLER_ID
Установить в Cloud одним кликом

7 дней бесплатно · Без карты

  • 7 дней бесплатно
    Без банковской карты
  • GDPR и готовность к SOC 2
    Данные в ЕС, журналы аудита
  • Открытый код на GitHub
    Open source · AGPL-3.0
  • Работает с ChatGPT, Claude, Gemini
    Любой MCP-совместимый клиент

Кратко

Позволь своему ИИ управлять магазином на маркетплейсе exito.com в Колумбии через API продавца Grupo Éxito: получай список товаров и статус их одобрения, создавай товары с изображениями, описаниями и атрибутами, устанавливай цены и остатки, читай заказы и выписки о выплатах.

Пошаговая настройка

Подключи Grupo Éxito Marketplace к Claude за 2 минуты

Начни бесплатный пробный период в AnythingMCP Cloud, подключи Grupo Éxito Marketplace в пошаговой настройке и добавь свой MCP URL в Claude. Без кода и без собственного сервера.

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

AnythingMCP есть в каталоге коннекторов Claude: добавьте его в Claude в один клик (откроется в новой вкладке), затем войдите и выберите, какие MCP-серверы может использовать Claude.

Попробуй спросить

Примеры промптов для Grupo Éxito Marketplace

Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.

Grupo Éxito Marketplace · live via MCP
Поделиться
Opus 4.7

Claude — это AI, он может ошибаться. Проверяйте ответы.

💡 Не хочешь ничего устанавливать? Используй cloud.anythingmcp.com напрямую. Войди в аккаунт, нажми Connectors → Grupo Éxito Marketplace, вставь свои учётные данные, создай API-ключ MCP, и всё готово. Без Docker, без git clone, без локального сервера.

Grupo Éxito Marketplace + Claude

Позволь своему ИИ управлять магазином на маркетплейсе exito.com в Колумбии через API продавца Grupo Éxito: получай список товаров и статус их одобрения, создавай товары с изображениями, описаниями и атрибутами, устанавливай цены и остатки, читай заказы и выписки о выплатах.

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

Полные инструкции по настройке встроены в коннектор (они видны в магазине внутри приложения, когда ты выбираешь коннектор). Для этого коннектора нужны следующие переменные окружения:

EXITO_USERNAME, EXITO_PASSWORD, EXITO_API_KEY, EXITO_LOGIN_URL, EXITO_SELLER_ID

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

Настройка занимает около 10 минут после того, как Éxito предоставит тебе доступ к API. Вместе с доступом Éxito присылает инструкции по аутентификации: имя пользователя, пароль, API-ключ и адрес, по которому выдаётся токен. Также тебе понадобится числовой идентификатор продавца.

Песочницы нет: Éxito её не документирует, поэтому каждый вызов, включая запись, действует на твой реальный магазин.

  1. Вставь пользователя API (адрес электронной почты) в EXITO_USERNAME, а пароль API в EXITO_PASSWORD; оба значения указаны в инструкциях Éxito.
  2. Вставь x-api-key из тех же инструкций в EXITO_API_KEY.
  3. Вставь полный адрес запроса токена с https:// в EXITO_LOGIN_URL. Он не опубликован на developers.exito.com, поэтому скопируй его из документа, который прислал Éxito.
  4. Укажи свой числовой идентификатор продавца (idSeller, например 11795) в EXITO_SELLER_ID. exito_marketplace_get_bulk_upload_status также показывает его как data.idSeller.
  5. Установи коннектор. Запусти exito_marketplace_list_categories, чтобы проверить подключение.

Как происходит вход: коннектор запрашивает токен по адресу выдачи токена, используя твоё имя пользователя, пароль и API-ключ, и отправляет его вместе с API-ключом при каждом вызове. Токены обновляются автоматически, не реже чем раз в час. Пароль и ключ хранятся в зашифрованном виде и никогда не показываются ИИ.

Облако и self-hosted работают одинаково: учётные данные те же, а redirect URL настраивать не нужно.

Продажи на Éxito асинхронны:

  1. Выбери самую точную категорию с помощью exito_marketplace_list_categories и прочитай её спецификации через exito_marketplace_get_category_features. Обязательные спецификации нужно передавать; спецификация со списком значений принимает только их.
  2. Создавай товары с помощью exito_marketplace_create_products, до 400 EAN за вызов. Изображения — это публичные URL размером 1000x1000 px (733x1000 px для одежды). Бренд уже должен существовать в Éxito; отсутствующий бренд создаёт твой аккаунт-менеджер в Éxito.
  3. Следи за пакетом через exito_marketplace_get_bulk_upload_status. Пока другой пакет запускается или обрабатывается, новый не принимается.
  4. Команда контента Éxito проверяет каждый товар. exito_marketplace_get_products_waiting показывает товары на проверке, exito_marketplace_get_products_rejected — отклонённые с указанием причины, а exito_marketplace_get_products_pending_seller_approval — те, что отличаются от такого же товара, уже находящегося на маркетплейсе. После одобрения товару нужно до часа, прежде чем для него можно будет создать предложение.
  5. Задай одобренным товарам цену и остаток через exito_marketplace_upsert_offers или, для одного EAN, через exito_marketplace_update_offer_price_stock. exito_marketplace_load_products_and_offers отправляет товары и предложения в одном запросе. Предложения появляются на сайтах примерно в течение 4 часов.

Цены и остатки: цены указываются в целых колумбийских песо выше 8000, без разделителей (45000). Акционная цена должна быть ниже обычной. Чтобы изменить только цену, отправь текущий остаток с IsUpdatedStock 0. Изменение цены более чем на 30% возвращается с кодом PEX и должно быть отправлено повторно с подтверждением цены: перед этим ИИ спросит тебя. Чтобы прекратить продажу товара, установи его остаток в 0: в API нет удаления.

Заказы и выплаты: exito_marketplace_get_orders показывает заказы с exito.com, carulla.com и других сайтов Éxito со статусом, суммами, комиссией и типом доставки. exito_marketplace_get_bills показывает выписки о выплатах. Списки разбиваются на страницы с помощью paginationToken.

Отключено при установке: exito_marketplace_set_order_tracking (отметить товары заказа как отправленные с указанием перевозчика и трек-номера) и exito_marketplace_upload_order_invoice (прикрепить счёт к заказу). Включи их на странице коннектора, если ИИ должен работать с заказами; ИИ просит тебя подтвердить каждый вызов. Создание товаров и установка цен и остатков включены (exito_marketplace_create_products, exito_marketplace_load_products_and_offers, exito_marketplace_upsert_offers, exito_marketplace_update_offer_price_stock).

Читай каждый ответ: пакетные операции записи отвечают HTTP 200 с одним сообщением на каждый отклонённый EAN, поэтому код 200 не означает, что приняты все товары или предложения. Запросы и ответы — на испанском языке.

Не охвачено: транспортные этикетки, модерация Éxito и уведомления о предложениях, а также всё, что веб-приложение Seller Center умеет, а API не предоставляет.

Частые ошибки: если токен не выдаётся, сверь имя пользователя, пароль и API-ключ с инструкциями Éxito и проверь, что EXITO_LOGIN_URL — это адрес токена из этого документа. 401 означает, что токен отклонён. 403 обычно означает, что API-ключ отсутствует или неверен либо API не включён для твоего пользователя: уточни у Éxito, какие 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 — Добавь коннектор в Claude

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

Рекомендуемый путь: работает в веб-версии claude.ai без редактирования конфигурационных файлов.

  1. В Claude открой Plugins (на некоторых тарифах пока Customize) → Connectors.
  2. Нажми + Add, затем Add custom connector.
  3. Введи название, например Grupo Éxito Marketplace, и URL удалённого MCP-сервера https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, затем нажми Continue, оставь найденные настройки и снова нажми Continue.
  4. Выбери Sign in now, нажми Add и войди в AnythingMCP (OAuth), чтобы разрешить доступ.

Все перечисленные ниже инструменты появятся в твоём чате: просто начни вводить запросы.

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

ИнструментЧто делает
exito_marketplace_get_productsПоказывает список товаров продавца на маркетплейсе Éxito с названием, EAN, VTEX PLU, изображением, датами создания и обновления, ценой, акционной ценой, остатком…
exito_marketplace_get_products_waitingТовары, ожидающие одобрения командой контента Éxito (модерация), с EAN, названием, изображением, датой обработки и родительской ссылкой
exito_marketplace_get_products_rejectedТовары, отклонённые командой контента Éxito и требующие исправления, с EAN, названием, изображением, Reason и Comment отклонения
exito_marketplace_get_products_pending_seller_approvalТовары, требующие твоего решения, потому что они отличаются от такого же товара, уже находящегося на маркетплейсе: в каждой строке есть oldProduct и…
exito_marketplace_get_bulk_upload_statusСтатус твоего последнего пакета создания товаров (exito_marketplace_create_products). data.status: 4 запускается, 1 обрабатывается, 2 завершён…
exito_marketplace_list_categoriesВсе категории маркетплейса Éxito с Id, IdParent, Name и ProductType (Technology или Clothing)
exito_marketplace_get_categoryОдна категория по id: Id, IdParent, Name и ProductType
exito_marketplace_get_category_featuresГруппы спецификаций категории: для каждой спецификации — specName, label, обязательность и допустимые значения (values[].label; an…
exito_marketplace_get_ordersЗаказы, полученные через сайты Éxito (exito.com, carulla.com и другие), с номером заказа, каналом, датами, статусом, суммами, комиссией…
exito_marketplace_get_billsВыписки о выплатах (billing) продавца: номер счёта, номер заказа, платёжное поручение, назначение, дата платежа, комиссия, итог, IVA и…
exito_marketplace_create_productsСоздаёт товары (или изменяет существующие: отправь тот же EAN повторно; ModifyImage "1" заменяет изображения) с названием, HTML-описанием…
exito_marketplace_load_products_and_offersОтправляет товары вместе с их предложениями в одном запросе: у каждого элемента есть Product (поля exito_marketplace_create_products) и…
exito_marketplace_upsert_offersСоздаёт или обновляет предложения (цена, акционная цена, остаток, доставка и обещанный срок доставки) для EAN, уже одобренных Éxito, на всех сайтах Éxito…
exito_marketplace_update_offer_price_stockИзменяет цену и/или остаток одного существующего предложения (один EAN). Éxito требует EAN, Stock и Price при каждом обновлении: чтобы изменить только цену…
exito_marketplace_set_order_trackingОтмечает товары заказа как отправленные с указанием перевозчика и трек-номера (заказы со стандартной доставкой)
exito_marketplace_upload_order_invoiceПрикрепляет счёт заказа в виде PDF или ZIP в формате base64

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

  • "Какие из моих товаров Éxito отклонил и почему?"
  • "Покажи заказы, назначенные мне на этой неделе, которые ещё нужно отправить."
  • "Какая цена и остаток у EAN 7701234567890 на exito.com?"
  • "Установи остаток EAN 7701234567890 в 25 единиц и оставь цену прежней."
  • "Подсчитай сумму комиссии в моих выписках о выплатах за октябрь."

FAQ

Работает ли это с Claude Code так же, как с Claude Desktop? Да, укажи в обоих https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

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

Это руководство помогло?

Подключи Grupo Éxito Marketplace к Claude за 2 минуты

Начни бесплатный пробный период в AnythingMCP Cloud, подключи Grupo Éxito Marketplace в пошаговой настройке и добавь свой MCP URL в Claude. Без кода и без собственного сервера.

Похожие руководства

Коннекторы

Подключить Éxito к ChatGPT через MCP: цены и остатки

Позволь своему ИИ управлять магазином на маркетплейсе exito.com в Колумбии через API продавца Grupo Éxito: получай список товаров и статус их одобрения, создавай товары с изображениями, описаниями и атрибутами, устанавливай цены и остатки, читай заказы и выписки о выплатах.

Коннекторы

Подключить Éxito к Microsoft Copilot через MCP

Позволь своему ИИ управлять магазином на маркетплейсе exito.com в Колумбии через API продавца Grupo Éxito: получай список товаров и статус их одобрения, создавай товары с изображениями, описаниями и атрибутами, устанавливай цены и остатки, читай заказы и выписки о выплатах.

Коннекторы

Подключить Éxito к Cursor через MCP: загрузка каталога

Позволь своему ИИ управлять магазином на маркетплейсе exito.com в Колумбии через API продавца Grupo Éxito: получай список товаров и статус их одобрения, создавай товары с изображениями, описаниями и атрибутами, устанавливай цены и остатки, читай заказы и выписки о выплатах.

Коннекторы

Подключить Éxito к Gemini CLI через MCP: заказы

Позволь своему ИИ управлять магазином на маркетплейсе exito.com в Колумбии через API продавца Grupo Éxito: получай список товаров и статус их одобрения, создавай товары с изображениями, описаниями и атрибутами, устанавливай цены и остатки, читай заказы и выписки о выплатах.

Коннекторы

Подключить Éxito к Meta Muse через MCP: заказы магазина

Позволь своему ИИ управлять магазином на маркетплейсе exito.com в Колумбии через API продавца Grupo Éxito: получай список товаров и статус их одобрения, создавай товары с изображениями, описаниями и атрибутами, устанавливай цены и остатки, читай заказы и выписки о выплатах.

Коннекторы

Éxito MCP-сервер: товары, предложения и заказы

Позволь своему ИИ управлять магазином на маркетплейсе exito.com в Колумбии через API продавца Grupo Éxito: получай список товаров и статус их одобрения, создавай товары с изображениями, описаниями и атрибутами, задавай цены и остатки, читай заказы и выписки о выплатах.