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

VTEX MCP: подключение к Claude

Платформа электронной коммерции VTEX: заказы (OMS) с обработкой и отслеживанием, каталог продуктов и SKU, поиск в витрине, цены, запасы по складам, доки и политики доставки, а также профили клиентов в Master Data. Ключ приложения и токен приложения.

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

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

VTEX

VTEX

VTEX commerce platform: orders (OMS) with handling and tracking, catalog products and SKUs, storefront search, prices, inventory per warehouse, docks and shipping policies, and customer profiles in Master Data. App key and app token.

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

34

Регион

INTL

Категория

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

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

API Key

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

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

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

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

Кратко

Платформа электронной коммерции VTEX: заказы (OMS) с обработкой и отслеживанием, каталог продуктов и SKU, поиск в витрине, цены, запасы по складам, доки и политики доставки, а также профили клиентов в Master Data. Ключ приложения и токен приложения.

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

Подключи VTEX к Claude за 2 минуты

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

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

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

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

Примеры промптов для VTEX

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

VTEX · live via MCP
Поделиться
Opus 4.7

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

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

VTEX + Claude

Платформа электронной коммерции VTEX: заказы (OMS) с обработкой и отслеживанием, каталог продуктов и SKU, поиск в витрине, цены, запасы по складам, доки и политики доставки, а также профили клиентов в Master Data. Ключ приложения и токен приложения.

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

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

VTEX_ACCOUNT_NAME, VTEX_ENVIRONMENT, VTEX_APP_KEY, VTEX_APP_TOKEN

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

Настройка занимает около 5 минут.

  1. В админке VTEX открой Настройки аккаунта, Аккаунт, Безопасность, API ключи (для старых администраторов: Настройки аккаунта, Управление аккаунтом, Ключи приложений) и нажми Сгенерировать ключ. Дай ему имя.
  2. Назначь роли ключу в Ролях (Менеджер лицензий): для чтения и записи используй предопределенные роли OMS - Полный доступ, Полный доступ к логистике, Каталог, Цены и роль Master Data, или настраиваемую роль с необходимыми ресурсами. Ключ только для чтения подходит для инструментов чтения.
  3. Скопируй Ключ приложения в VTEX_APP_KEY и Токен приложения в VTEX_APP_TOKEN (токен показывается только один раз).
  4. Введи имя аккаунта (первая часть https://<account>.myvtex.com) в VTEX_ACCOUNT_NAME и оставь окружение vtexcommercestable.

Коннектор отправляет ключ и токен в заголовках X-VTEX-API-AppKey и X-VTEX-API-AppToken при каждом вызове.

С чего начать: vtex_list_orders (фильтруй по f_status, например ready-for-handling), затем vtex_get_order для получения товаров, адреса и платежа. Для продукта начни с vtex_search_products или vtex_get_sku_by_ref_id, затем vtex_get_sku, vtex_get_price и vtex_get_sku_inventory.

Заказы: vtex_list_orders (нет товаров в списке; максимум 30 страниц по 100, только за последние два года), vtex_get_order, vtex_get_order_group, vtex_get_order_conversation, vtex_get_payment_transaction. Перемести оплаченный заказ с помощью vtex_start_handling_order, запиши заметку с помощью vtex_add_order_interaction и отправь события доставки с помощью vtex_update_tracking_status. Три инструмента установлены, но выключены: vtex_cancel_order (не может быть отменен, возвращает оплаченный заказ), vtex_invoice_order (выставление счета заставляет VTEX зафиксировать платеж и замораживает заказ) и vtex_update_invoice_tracking (изменяет счет). Денежные значения в заказах — целые числа в центах (totalValue 12990 — это 129.90).

Каталог: vtex_list_product_and_sku_ids, vtex_get_product, vtex_get_product_by_ref_id, vtex_list_product_skus, vtex_get_sku, vtex_get_sku_by_ref_id, vtex_get_sku_by_ean, vtex_search_products (поиск в витрине с актуальной ценой и доступным количеством), vtex_get_category_tree, vtex_list_brands. Идентификаторы продуктов и SKU — это числа; RefId — это собственный код продавца.

Цены: vtex_get_price, vtex_get_computed_price, vtex_list_price_tables, vtex_update_price. Ценовые значения — десятичные (49.9), в отличие от значений заказов.

Запасы и логистика: vtex_get_sku_inventory, vtex_update_sku_inventory (устанавливает общее количество на одном складе), vtex_list_warehouses, vtex_list_docks, vtex_list_shipping_policies.

Клиенты (Master Data v1): vtex_search_customers, vtex_get_customer, vtex_update_customer, и vtex_search_documents для любых сущностей (AD хранит адреса, связанные по userId с идентификатором CL). Поиск возвращает максимум 100 строк за вызов, выбранных с помощью range_start и range_end; запрашивай только те поля, которые тебе нужны, потому что ключ без прав на поле получает 403, когда используется _all.

Ограничения и подводные камни: VTEX позволяет около 6000 чтений заказов в минуту на аккаунт и отвечает 429, когда API перегружен. Даты в фильтрах — UTC. Код 403 означает, что роль ключа не имеет ресурса, необходимого для вызова; код 404 на заказ, старше двух лет, ожидаем.

Шаг 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 web без редактирования конфигурационного файла.

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

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

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

ИнструментЧто он делает
vtex_list_ordersСписок заказов за последние два года, по умолчанию от новых к старым: orderId, creationDate, clientName, totalValue в центах, статус и…
vtex_get_orderЧтение одного заказа: статус, значение и итоги в центах, товары (SKU id, refId, имя, количество, цена, цена продажи), clientProfileData…
vtex_get_order_groupЧтение всех заказов одной покупки (группа заказов разбивается на один заказ на продавца): те же поля, что и в vtex_get_order для каждого заказа
vtex_start_handling_orderПеремещение заказа из состояния готовности к обработке в состояние обработки, что сообщает VTEX, что продавец начал его подготовку. VTEX отвечает 204 без тела…
vtex_add_order_interactionЗапись строки в журнал взаимодействия заказа (показано в истории заказа в админке), например, заметка от склада. Не изменяет…
vtex_get_order_conversationЧтение переписки по заказу: сообщения, которые VTEX и магазин отправили клиенту (тема, от, к, дата, тело)
vtex_get_payment_transactionЧтение платежной транзакции заказа: идентификатор транзакции, статус, платежи с методом, значение в центах, рассрочка и история событий.…
vtex_update_tracking_statusОтправка событий отслеживания для счета, который уже имеет номер отслеживания (isDelivered, deliveredDate и список событий с городом, штатом…
vtex_cancel_orderОтмена заказа, который еще не был выставлен, с указанием причины. Не может быть отменен; оплаченные заказы возвращаются VTEX. Установлен выключенным
vtex_invoice_orderОтправка счета за заказ (тип Output для продажи), что переводит его в статус выставленного счета и заставляет VTEX зафиксировать (забрать) платеж. invoiceValue…
vtex_update_invoice_trackingДобавление номера отслеживания, ссылки для отслеживания, перевозчика и даты отправки к существующему счету заказа. Изменяет счет; установлен выключенным…
vtex_list_product_and_sku_idsСписок идентификаторов продуктов с их идентификаторами SKU, опционально в одной категории: данные сопоставляют каждый productId с его идентификаторами SKU, range.total дает общее количество. Страница…
vtex_get_productЧтение одного продукта: Id, Name, DepartmentId, CategoryId, BrandId, LinkId (URL slug), RefId, IsVisible, IsActive, Description, Title…
vtex_get_product_by_ref_idПоиск продукта по его референсному коду (RefId) и чтение тех же полей, что и в vtex_get_product
vtex_list_product_skusСписок SKU продукта: Id, ProductId, IsActive, Name, RefId, поля, связанные с EAN, размеры, вес и единица измерения
vtex_get_skuЧтение одного SKU с его контекстом: Id, ProductId, NameComplete, ProductName, SkuName, AlternateIds (EAN, RefId), изображения, размеры, продавцы…
vtex_get_sku_by_ref_idПоиск SKU по его референсному коду (RefId): Id, ProductId, IsActive, Name, RefId, размеры и вес
vtex_get_sku_by_eanПоиск SKU по его штрих-коду EAN и чтение тех же полей, что и в vtex_get_sku
vtex_search_productsПоиск опубликованного каталога, как это делает витрина: productId, productName, brand, link, категории и товары (SKU) с продавцами и…
vtex_get_category_treeЧтение дерева категорий до заданной глубины: id, name, hasChildren, url и дочерние элементы для каждой категории
vtex_list_brandsСписок всех брендов: id, name, isActive, title, metaTagDescription и imageUrl
vtex_get_priceЧтение цен SKU из API ценообразования: itemId, listPrice, costPrice, markup, basePrice и fixedPrices по торговой политике…
vtex_get_computed_priceЧтение цены, которую таблица цен (торговая политика) фактически взимает за SKU после применения правил ценообразования: tradePolicyId, listPrice, costPrice…
vtex_list_price_tablesСписок идентификаторов таблиц цен аккаунта (например, 1 для основной торговой политики или названия, такие как gold)
vtex_update_priceСоздание или обновление базовой цены SKU: укажи base_price отдельно (markup и cost тогда выводятся), или cost_price с markup в процентах…
vtex_get_sku_inventoryЧтение запасов SKU на каждом складе: warehouseId, warehouseName, totalQuantity, reservedQuantity, hasUnlimitedQuantity, timeToRefill…
vtex_update_sku_inventoryУстановка запасов SKU на одном складе: quantity заменяет общее количество (резервации хранятся отдельно); unlimited_quantity true сохраняет…
vtex_list_warehousesСписок складов: id, name, warehouseDocks (идентификаторы доков с временем и стоимостью) и isActive
vtex_list_docksСписок погрузочных доков: id, name, priority, dockTimeFake, salesChannels, freightTableIds и информация о магазине для забора
vtex_list_shipping_policiesСписок политик доставки (перевозчики и таблицы фрахта): id, name, shippingMethod, isActive, deliveryOnWeekends, maxDimension и business…
vtex_search_customersПоиск профилей клиентов (сущность Master Data CL): email, firstName, lastName, document, phone, isCorporate, corporateName, createdIn и…
vtex_get_customerЧтение одного профиля клиента (сущность CL) по идентификатору документа: поля, указанные в fields
vtex_update_customerИзменение полей профиля клиента (сущность CL); изменяются только указанные поля, например, phone или isNewsletterOptIn
vtex_search_documentsПоиск любой сущности Master Data v1 по ее двухбуквенному акрониму, например, AD для адресов клиентов (фильтр по userId), или настраиваемой сущности:…

Примеры подсказок

  • "Какие заказы VTEX готовы к обработке прямо сейчас?"
  • "Покажи заказ 1478920512345-01 с его товарами, адресом и платежом."
  • "Какова цена и запасы по складам для SKU ref TSHIRT-BLK-M?"
  • "Установи запасы SKU 2001 на складе 1_1 в 80."
  • "Какие политики доставки и доки активны?"

Часто задаваемые вопросы

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

Откуда берутся ключ приложения и токен? В админке VTEX в разделе Настройки аккаунта, Аккаунт, Безопасность, API ключи: сгенерируй ключ, назначь роли, такие как OMS, Логистика, Каталог и Цены, и скопируй ключ приложения и токен приложения (показывается один раз).

Что это охватывает? Заказы (OMS) с обработкой, взаимодействиями и отслеживанием, каталог продуктов и SKU, поиск в витрине, цены и таблицы цен, запасы по складам, доки и политики доставки, а также профили клиентов в Master Data.

Какие инструменты установлены выключенными? vtex_cancel_order, vtex_invoice_order и vtex_update_invoice_tracking, потому что они отменяют или выставляют счета за заказы для клиента. Включай их на странице коннектора только если ИИ должен их использовать.

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

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

Подключи VTEX к Claude за 2 минуты

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

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

Коннекторы

VTEX MCP: подключение к ChatGPT

Платформа электронной коммерции VTEX: заказы (OMS) с обработкой и отслеживанием, каталог продуктов и SKU, поиск в витрине, цены, запасы по складам, доки и политики доставки, а также профили клиентов в Master Data. Ключ приложения и токен приложения.

Коннекторы

VTEX MCP: подключение к Microsoft Copilot

Платформа электронной коммерции VTEX: заказы (OMS) с обработкой и отслеживанием, каталог продуктов и SKU, поиск в витрине, цены, запасы по складам, доки и политики доставки, а также профили клиентов в Master Data. Ключ приложения и токен приложения.

Коннекторы

VTEX MCP: подключение к Cursor

Платформа электронной коммерции VTEX: заказы (OMS) с обработкой и отслеживанием, каталог продуктов и SKU, поиск в витрине, цены, запасы по складам, доки и политики доставки, а также профили клиентов в Master Data. Ключ приложения и токен приложения.

Коннекторы

VTEX MCP: подключение к Gemini CLI

Платформа электронной коммерции VTEX: заказы (OMS) с обработкой и отслеживанием, каталог продуктов и SKU, поиск в витрине, цены, запасы по складам, доки и политики доставки, а также профили клиентов в Master Data. Ключ приложения и токен приложения.

Коннекторы

VTEX MCP: подключение к Meta Muse

Платформа электронной коммерции VTEX: заказы (OMS) с обработкой и отслеживанием, каталог продуктов и SKU, поиск в витрине, цены, запасы по складам, доки и политики доставки, а также профили клиентов в Master Data. Ключ приложения и токен приложения.

Коннекторы

VTEX MCP-сервер: заказы, товары и запасы

Платформа электронной коммерции VTEX: заказы (OMS) с обработкой и отслеживанием, каталог продуктов и SKU, поиск в витрине, цены, запасы по складам, доки и политики доставки, а также профили клиентов в Master Data. Ключ приложения и токен приложения.