mcp-vtex — MCP-сервер для Claude Code: что делает и как установить
Подключает магазин на платформе VTEX к ИИ-ассистенту. Управляет каталогом, складскими остатками и заказами прямо из диалога.
claude mcp add mcp-vtex -e VTEX_APP_TOKEN=<VTEX_APP_TOKEN> -- npx -y @codespar/mcp-vtexЧто делает mcp-vtex
MCP-сервер открывает агенту доступ к 33 инструментам API электронной коммерции VTEX. Он умеет запрашивать карточки товаров, создавать артикулы SKU и менять категории каталога. Также поддерживается отслеживание статуса заказов, оформление фискальных счетов и отмена покупок.
В набор входят операции с ценовыми таблицами и остатками на складах. Дополнительно можно моделировать расчёт доставки или выпускать подарочные карты. Сервер умеет работать с базой Master Data v2 и регулярными подписками VTEX Subscriptions.
Для подключения требуются переменные окружения VTEX_ACCOUNT_NAME, VTEX_APP_KEY и VTEX_APP_TOKEN из личного кабинета платформы. Без этих данных запросы к магазину завершатся ошибкой авторизации.
Какие задачи решает
- обновить базовые и розничные цены артикулов SKU
- проверить остатки товара на конкретном складе
- сформировать фискальный счёт для оформленного заказа
- создать скидочный промокод для маркетинговой акции
Примеры запросов агенту
- Проверь остатки товара с артикулом 1024 на всех складах.
- Выстави статус обработки для заказа 123456789.
- Создай новый промокод на скидку в каталоге VTEX.
Как установить mcp-vtex
Командой платформы
claude mcp add mcp-vtex -e VTEX_APP_TOKEN=<VTEX_APP_TOKEN> -- npx -y @codespar/mcp-vtexВместо <…> подставьте свои значения
Командой платформы
codex mcp add vtex --env VTEX_APP_TOKEN=<VTEX_APP_TOKEN> -- npx -y @codespar/mcp-vtexВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"vtex": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-vtex"
],
"env": {
"VTEX_APP_TOKEN": "<VTEX_APP_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"vtex": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-vtex"
],
"env": {
"VTEX_APP_TOKEN": "<VTEX_APP_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e VTEX_APP_TOKEN=<VTEX_APP_TOKEN> vtex npx -y @codespar/mcp-vtexВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-vtex
Как установить mcp-vtex в Claude Code?
Выполните команду claude mcp add mcp-vtex -e VTEX_APP_TOKEN=<VTEX_APP_TOKEN> -- npx -y @codespar/mcp-vtex.
Что умеет MCP-сервер mcp-vtex?
Сервер предоставляет 33 инструмента для работы с каталогом VTEX, ценами, складскими остатками, заказами и документами Master Data.
Какие учётные данные нужны для работы?
Нужны переменные VTEX_ACCOUNT_NAME, VTEX_APP_KEY и VTEX_APP_TOKEN, которые генерируются в License Manager портала разработчиков VTEX.
