mcp-vtex

@codespar/mcp-vtex

VTEX 用 MCP サーバー — カタログ、注文、在庫、プロモーションを備えた e コマースプラットフォーム

クイックスタート

Claude Desktop

~/.config/claude/claude_desktop_config.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

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

Cursor / VS Code

.cursor/mcp.json または .vscode/mcp.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"
      }
    }
  }
}

ツール（33）

ツール	用途
list_products	VTEX カタログの商品を一覧表示します
get_product	ID を指定して商品詳細を取得します
create_product	VTEX カタログに新しい商品を作成します
update_product	VTEX カタログ内の既存商品を更新します
list_skus	商品の SKU を一覧表示します
create_sku	商品の新しい SKU を作成します
list_categories	ページネーションを使用してすべてのカテゴリを一覧表示します
create_category	カタログに新しいカテゴリを作成します
get_catalog	カタログのカテゴリツリーを取得します
list_orders	オプションのフィルターを指定して注文を一覧表示します
get_order	ID を指定して OMS の注文詳細をすべて取得します
update_order_status	注文を処理中の状態に移行します（フルフィルメントを開始）
invoice_order	注文の税務請求書（nota fiscal）を発行します
track_order_invoice	発行済みの請求書の追跡情報を更新します
cancel_order	注文をキャンセルします
list_customer_orders	顧客の注文履歴を一覧表示します（メールアドレスで絞り込み）
get_sku_price	SKU の価格詳細（基本価格、表示価格、マークアップ、原価、取引ポリシーごとの固定価格）を取得します
update_sku_price	SKU の基本価格、表示価格、原価を更新します
list_price_tables	設定済みの価格テーブル（取引ポリシー）をすべて一覧表示します
get_inventory	倉庫ごとの SKU の在庫数を取得します
update_inventory	特定の倉庫における SKU の在庫数を更新します
get_shipping_rates	郵便番号を指定して商品の配送料をシミュレーションします
list_warehouses	アカウントに設定されているすべての倉庫を一覧表示します
create_warehouse	新しい倉庫（フルフィルメントセンター）を登録します
create_promotion	VTEX でプロモーション／割引を作成します
list_coupons	すべてのプロモーション用クーポンを一覧表示します
create_coupon	プロモーション用クーポンコードを作成します
list_subscriptions	顧客のサブスクリプションを一覧表示します
create_subscription	顧客の定期購入を作成します（VTEX Subscriptions）
get_masterdata_document	VTEX Master Data v2 からドキュメント（顧客プロフィール、カスタムエンティティ）を取得します
search_masterdata	Master Data エンティティ内のドキュメントを検索します
create_giftcard	顧客向けのギフトカードを作成します（GiftCard Hub）
get_giftcard	ID を指定してギフトカードの詳細を取得します

認証

VTEX では、API 認証にアプリキーとアプリトークンのヘッダーを使用します。

サンドボックス／テスト

VTEX では、パートナーアカウントを通じてサンドボックスにアクセスできます。開発者向けアクセスについては VTEX にお問い合わせください。

認証情報を取得する

1. VTEX Developer Portal にアクセスします
2. VTEX 管理画面にアクセスするか、パートナーアカウントを作成します
3. License Manager からアプリキーとアプリトークンを生成します
4. 環境変数を設定します

環境変数

変数	必須	説明
VTEX_ACCOUNT_NAME	はい	VTEX アカウント名
VTEX_APP_KEY	はい	API アプリキー
VTEX_APP_TOKEN	はい	API アプリトークン
VTEX_ENVIRONMENT	いいえ	環境ホストのスラッグ（デフォルトは vtexcommercestable）

ロードマップ

v0.3（予定）

• チェックアウト／カートセッション管理
• マーケットプレイスの販売者とオファーの管理
• 配送業者（配送ポリシー）の登録

貢献したい場合は、PR を作成するか、ツールをリクエストしてください。

リンク

• VTEX ウェブサイト
• VTEX 開発者向けドキュメント
• MCP Dev LATAM
• ランディングページ

エンタープライズ

エージェントによる支払いのガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT