Кратко
Платформа электронной коммерции VTEX: заказы (OMS) с обработкой и отслеживанием, каталог продуктов и SKU, поиск в витрине, цены, запасы по складам, доки и политики доставки, а также профили клиентов в Master Data. Ключ приложения и токен приложения.
Пошаговая настройка
Подключи VTEX к Microsoft Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи VTEX в пошаговой настройке и добавь свой MCP URL в Microsoft Copilot. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для VTEX
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → VTEX, вставь свои учетные данные, создай ключ API MCP, и всё готово. Никакого Docker, никакого
git clone, никакого локального сервера.
VTEX + Microsoft Copilot
Платформа электронной коммерции 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 — Добавь коннектор в Microsoft Copilot
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.
- В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
- Укажи Server name (например,
AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер. - В аутентификации выбери API key, установи Type в Header, укажи имя заголовка
X-API-Keyи нажми Create. - В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
- Проверь в панели Test агента: попроси о том, для чего нужны инструменты
VTEX. - Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.
Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.
Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому 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, потому что они отменяют или выставляют счета за заказы для клиента. Включай их на странице коннектора только если ИИ должен их использовать.
Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.
Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.
Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.
Следующие шаги
Это руководство помогло?