Кратко
Платформа электронной коммерции 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 и запусти через этот коннектор.
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 минут.
- В админке VTEX открой Настройки аккаунта, Аккаунт, Безопасность, API ключи (для старых администраторов: Настройки аккаунта, Управление аккаунтом, Ключи приложений) и нажми Сгенерировать ключ. Дай ему имя.
- Назначь роли ключу в Ролях (Менеджер лицензий): для чтения и записи используй предопределенные роли OMS - Полный доступ, Полный доступ к логистике, Каталог, Цены и роль Master Data, или настраиваемую роль с необходимыми ресурсами. Ключ только для чтения подходит для инструментов чтения.
- Скопируй Ключ приложения в
VTEX_APP_KEYи Токен приложения вVTEX_APP_TOKEN(токен показывается только один раз). - Введи имя аккаунта (первая часть
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.
- В Muse открой Settings → Connectors и выбери Add custom connector.
- Вставь URL MCP-сервера
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse откроет страницу входа AnythingMCP: войди и подтверди доступ.
- В чате попроси 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.
Следующие шаги
Это руководство помогло?