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

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

Платформа электронной коммерции 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 к Meta Muse за 2 минуты

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

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

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

Примеры промптов для 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 + Meta Muse

Платформа электронной коммерции 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 — Добавь коннектор в Muse

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

Muse добавляет удалённые MCP-серверы как пользовательские коннекторы и входит в них через OAuth.

  1. В Muse открой Settings → Connectors и выбери Add custom connector.
  2. Вставь URL MCP-сервера https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
  3. Muse откроет страницу входа AnythingMCP: войди и подтверди доступ.
  4. В чате попроси Muse о том, для чего нужны инструменты VTEX.

Настроить коннектор можно и из чата — в вебе, в приложениях для iOS и Android или в WhatsApp. Отправь Muse это сообщение:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Muse подключается из облака Meta, поэтому localhost не подойдёт.

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

ИнструментЧто он делает
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."
  • "Какие политики доставки и доки активны?"

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

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

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

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

Где доступен Muse? Сейчас Meta предлагает Muse в США и Канаде — в вебе, в приложениях для iOS и Android и в WhatsApp.

Проверяет ли Meta этот коннектор? Нет. Meta не проверяет пользовательские коннекторы. Muse видит только те инструменты, которые ты включил для этого MCP-сервера в AnythingMCP, а отключить коннектор можно в любой момент в Settings → Connectors.

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

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

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

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

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

Коннекторы

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

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

Коннекторы

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

Платформа электронной коммерции 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-сервер: заказы, товары и запасы

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