Mcp Vtex

io.github.codespar由 GitHub 账号 codespar 发布v0.2.2更新于 Oct 24, 2026

MCP server for VTEX — e-commerce, orders, products, inventory, shipping

已验证STDIO仅桌面效率与工作流商业与电商

概览

AI 生成的概览

让助手读取和修改 VTEX 电商数据，包括商品目录、订单、价格、库存、运费、促销和礼品卡。

可以做什么
通过约 33 个工具把助手连接到 VTEX 店铺账号，覆盖商品目录（商品、SKU、类目）、订单（列表、详情、状态、开票、物流跟踪、取消）、价格与价格表、库存与仓库、运费模拟、促销与优惠券、订阅、Master Data 文档以及礼品卡。读取类工具用于查询商品、订单、库存和运费；写入类工具可创建或更新商品、SKU、类目、价格、库存、仓库、促销、优惠券、订阅和礼品卡，并可对订单开票、更新跟踪信息或取消订单。
适用场景
适合需要操作 VTEX 店铺前台或后台的场景：查询商品目录与订单数据、查看库存和运费估算，或通过对话完成日常的商品、价格、库存和履约更新。
运行要求
通过 npx 从 npm 包 @codespar/mcp-vtex 在本地运行，需要 Node.js 和网络访问。需要 VTEX 账号名以及 app key 和 app token，通过环境变量 VTEX_ACCOUNT_NAME、VTEX_APP_KEY、VTEX_APP_TOKEN 提供；VTEX_ENVIRONMENT 为可选项。凭据需在 VTEX License Manager 中生成。
安装前请注意
app token（VTEX_APP_TOKEN）和 app key 是访问店铺账号 API 的密钥，不要写入共享配置。许多工具会写入或更改线上电商数据，包括创建和更新商品、价格、库存、促销和优惠券，以及取消订单或为订单开票，可能影响客户和营收。请授予尽可能小的 VTEX 权限。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mcp Vtex，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@codespar/mcp-vtex

MCP server for VTEX — e-commerce platform with catalog, orders, inventory, and promotions

[npm] [License: MIT]

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json
{  "mcpServers": {    "vtex": {      "command": "npx",      "args": ["-y", "@codespar/mcp-vtex"],      "env": {        "VTEX_ACCOUNT_NAME": "your-account",        "VTEX_APP_KEY": "your-app-key",        "VTEX_APP_TOKEN": "your-app-token"      }    }  }}

Claude Code

bash
claude mcp add vtex -- npx @codespar/mcp-vtex

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json
{  "servers": {    "vtex": {      "command": "npx",      "args": ["-y", "@codespar/mcp-vtex"],      "env": {        "VTEX_ACCOUNT_NAME": "your-account",        "VTEX_APP_KEY": "your-app-key",        "VTEX_APP_TOKEN": "your-app-token"      }    }  }}

Tools (33)

ToolPurpose
list_productsList products from VTEX catalog
get_productGet product details by ID
create_productCreate a new product in the VTEX catalog
update_productUpdate an existing product in the VTEX catalog
list_skusList SKUs for a product
create_skuCreate a new SKU for a product
list_categoriesList all categories with pagination
create_categoryCreate a new category in the catalog
get_catalogGet the catalog category tree
list_ordersList orders with optional filters
get_orderGet full OMS order details by ID
update_order_statusTransition an order to the handling state (start fulfillment)
invoice_orderIssue a fiscal invoice (nota fiscal) for an order
track_order_invoiceUpdate tracking info for a previously issued invoice
cancel_orderCancel an order
list_customer_ordersList order history for a customer (filtered by email)
get_sku_priceGet pricing details for an SKU (base price, list price, markup, cost, fixed prices per trade policy)
update_sku_priceUpdate base/list/cost price for an SKU
list_price_tablesList all configured price tables (trade policies)
get_inventoryGet inventory/stock for a SKU across warehouses
update_inventoryUpdate inventory quantity for a SKU at a specific warehouse
get_shipping_ratesSimulate shipping rates for items to a postal code
list_warehousesList all warehouses configured in the account
create_warehouseRegister a new warehouse (fulfillment center)
create_promotionCreate a promotion/discount in VTEX
list_couponsList all promotion coupons
create_couponCreate a promotion coupon code
list_subscriptionsList customer subscriptions
create_subscriptionCreate a recurring subscription for a customer (VTEX Subscriptions)
get_masterdata_documentGet a document (customer profile, custom entity) from VTEX Master Data v2
search_masterdataSearch documents in a Master Data entity
create_giftcardCreate a gift card for a customer (GiftCard Hub)
get_giftcardGet gift card details by ID

Authentication

VTEX uses app key and app token headers for API authentication.

Sandbox / Testing

VTEX provides sandbox access via partner accounts. Contact VTEX for developer access.

Get your credentials

  1. Go to VTEX Developer Portal
  2. Access your VTEX admin or create a partner account
  3. Generate an app key and app token from License Manager
  4. Set the environment variables

Environment Variables

VariableRequiredDescription
VTEX_ACCOUNT_NAMEYesVTEX account name
VTEX_APP_KEYYesAPI app key
VTEX_APP_TOKENYesAPI app token
VTEX_ENVIRONMENTNoEnvironment host slug (default vtexcommercestable)

Roadmap

v0.3 (planned)

  • Checkout / cart session management
  • Marketplace seller and offer management
  • Carrier (shipping policy) registration

Want to contribute? Open a PR or request a tool.

Links

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

来源：packages/ecommerce/vtex/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分