コネクタガイド約3分で読めますMCP ツール 34 個7 言語

VTEX MCPサーバー:注文・商品・在庫

VTEXコマースプラットフォーム:処理と追跡を伴う注文(OMS)、カタログ製品とSKU、ストアフロント検索、価格、倉庫ごとの在庫、ドックと配送ポリシー、マスターデータにおける顧客プロファイル。アプリキーとアプリトークン。

HC執筆: HelpCode チーム更新日 3分で読了 GitHub でオープンソース

クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり

VTEX

VTEX

VTEX commerce platform: orders (OMS) with handling and tracking, catalog products and SKUs, storefront search, prices, inventory per warehouse, docks and shipping policies, and customer profiles in Master Data. App key and app token.

ツール

34

地域

INTL

カテゴリー

EC

認証

API Key

必要な環境変数

VTEX_ACCOUNT_NAMEVTEX_ENVIRONMENTVTEX_APP_KEYVTEX_APP_TOKEN
Cloud にワンクリックでインストール

7日間無料トライアル · クレジットカード不要

  • 7日間の無料トライアル
    クレジットカード不要
  • GDPR・SOC 2 レディ
    EU データ保管、監査ログ
  • GitHub でオープンソース
    オープンソース · AGPL-3.0
  • ChatGPT、Claude、Gemini に対応
    MCP 対応クライアントすべて

概要

VTEXコマースプラットフォーム:処理と追跡を伴う注文(OMS)、カタログ製品とSKU、ストアフロント検索、価格、倉庫ごとの在庫、ドックと配送ポリシー、マスターデータにおける顧客プロファイル。アプリキーとアプリトークン。

ガイド付きセットアップ

VTEX を Claude、ChatGPT、Copilot に 2 分で接続

AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで VTEX を接続して、MCP URL を AI アシスタントに追加します。コードもサーバーの運用も不要です。

クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり

こう聞いてみよう

VTEX のサンプルプロンプト

プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。

VTEX · MCP 経由でライブ
共有
Opus 4.7

Claude は AI のため誤ることがあります。回答をご確認ください。

💡 インストール不要?cloud.anythingmcp.comに直接アクセス。 サインインして、Connectors → VTEXをクリックし、資格情報を貼り付けて、MCP APIキーを作成すれば完了です。Dockerもgit cloneもローカルサーバーも不要です。

VTEX

VTEXコマースプラットフォーム:処理と追跡を伴う注文(OMS)、カタログ製品とSKU、ストアフロント検索、価格、倉庫ごとの在庫、ドックと配送ポリシー、マスターデータにおける顧客プロファイル。アプリキーとアプリトークン。

セットアップ

セットアップには約5分かかります。

  1. VTEX Adminでアカウント設定、アカウント、セキュリティ、APIキー(古い管理者の場合はアカウント設定、アカウント管理、アプリケーションキー)を開き、キーを生成をクリックします。名前を付けます。
  2. ロール(ライセンスマネージャー)でキーにロールを割り当てます。読み取りと書き込みには、事前定義されたロールOMS - フルアクセス、ロジスティクスフルアクセス、カタログ、価格設定、およびマスターデータロール、または必要なリソースを持つカスタムロールを使用します。読み取り専用キーは読み取りツールに適しています。
  3. アプリキーをVTEX_APP_KEYに、アプリトークンをVTEX_APP_TOKENにコピーします(トークンは一度だけ表示されます)。
  4. アカウント名(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件、過去2年分のみ)、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で配送イベントを送信します。3つのツールがオフの状態でインストールされています: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のIDは数字で、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(1つの倉庫の合計を設定)、vtex_list_warehouses、vtex_list_docks、vtex_list_shipping_policies。

顧客(マスターデータv1):vtex_search_customers、vtex_get_customer、vtex_update_customer、および任意のエンティティのためのvtex_search_documents(ADは住所を保持し、userIdでCL IDにリンクされています)。検索は、呼び出しごとに最大100行を返し、range_startとrange_endで選択します。必要なフィールドのみを要求してください。フィールドに対する権限がないキーは、_allを使用すると403エラーになります。

制限と落とし穴:VTEXはアカウントごとに1分あたり約6,000件の注文読み取りを許可し、APIが過負荷の際には429エラーを返します。フィルターの日付はUTCです。403エラーは、キーのロールが呼び出しに必要なリソースを欠いていることを意味します。2年以上前の注文に対する404エラーは予想されます。

前提条件:VTEX_ACCOUNT_NAME、VTEX_ENVIRONMENT、VTEX_APP_KEY、VTEX_APP_TOKEN

コネクタをローカルにインストールする

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

http://localhost:3000/connectors/storeを開き、VTEXを選択し、前提条件に記載されている環境変数を貼り付けます。

利用可能なツール

ツール何をするか
vtex_list_orders過去2年の注文をリスト表示、デフォルトでは最新のものから:orderId、creationDate、clientName、totalValue(セント単位)、statusなど…
vtex_get_order1つの注文を読み取る:status、value、合計(セント単位)、アイテム(SKU ID、refId、name、quantity、price、sellingPrice)、clientProfileData…
vtex_get_order_group1つのチェックアウトのすべての注文を読み取る(注文グループは売り手ごとに1つの注文に分割される):各注文のvtex_get_orderと同じフィールド
vtex_start_handling_order注文をready-for-handlingからhandlingに移動し、VTEXに売り手が準備を開始したことを通知します。VTEXは204を返しますが、ボディはありません…
vtex_add_order_interaction注文のインタラクションログに行を追加します(管理者の注文履歴に表示される)、例:倉庫からのメモ。変更はありません…
vtex_get_order_conversation注文のメールのやり取りを読み取る:VTEXとストアが顧客に送信したメッセージ(件名、送信者、受信者、日付、本文)
vtex_get_payment_transaction注文の支払いトランザクションを読み取る:トランザクションID、ステータス、支払い方法、セント単位の金額、分割払い、イベント履歴…
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_idsSKU IDを持つ製品IDをリスト表示します。オプションで1つのカテゴリ内:データは各productIdをそのSKU IDにマッピングし、range.totalが合計を示します。ページ…
vtex_get_product1つの製品を読み取る:Id、Name、DepartmentId、CategoryId、BrandId、LinkId(URLスラッグ)、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コンテキストを持つ1つのSKUを読み取ります:Id、ProductId、NameComplete、ProductName、SkuName、AlternateIds(EAN、RefId)、画像、寸法、売り手…
vtex_get_sku_by_ref_id参照コード(RefId)でSKUを見つけます:Id、ProductId、IsActive、Name、RefId、寸法、重量
vtex_get_sku_by_eanEANバーコードでSKUを見つけ、vtex_get_skuと同じフィールドを読み取ります
vtex_search_productsストアフロントが行うように公開されたカタログを検索します:productId、productName、brand、link、categories、アイテム(SKU)と売り手…
vtex_get_category_tree指定された深さまでカテゴリツリーを読み取ります:id、name、hasChildren、url、各カテゴリの子供
vtex_list_brandsすべてのブランドをリスト表示します:id、name、isActive、title、metaTagDescription、imageUrl
vtex_get_price価格APIからSKUの価格を読み取ります:itemId、listPrice、costPrice、markup、basePrice、取引ポリシーごとのfixedPrices…
vtex_get_computed_price価格テーブル(取引ポリシー)がSKUに対して実際に請求する価格を読み取ります:tradePolicyId、listPrice、costPrice…
vtex_list_price_tablesアカウントの価格テーブルIDをリスト表示します(例えば、主要な取引ポリシーの1や、goldのような名前)
vtex_update_priceSKUの基本価格を作成または更新します:base_priceのみを指定する(markupとcostはその後導出されます)、またはcost_priceとパーセントのmarkupを指定します…
vtex_get_sku_inventory各倉庫におけるSKUの在庫を読み取ります:warehouseId、warehouseName、totalQuantity、reservedQuantity、hasUnlimitedQuantity、timeToRefill…
vtex_update_sku_inventory1つの倉庫におけるSKUの在庫を設定します:quantityは合計数量を置き換えます(予約は別に保持されます);unlimited_quantityがtrueの場合は…
vtex_list_warehouses倉庫をリスト表示します:id、name、warehouseDocks(時間とコストのドックID)およびisActive
vtex_list_docksローディングドックをリスト表示します:id、name、priority、dockTimeFake、salesChannels、freightTableIds、ピックアップストア情報
vtex_list_shipping_policies配送ポリシー(運送業者と運賃テーブル)をリスト表示します:id、name、shippingMethod、isActive、deliveryOnWeekends、maxDimension、business…
vtex_search_customers顧客プロファイル(マスターデータエンティティCL)を検索します:email、firstName、lastName、document、phone、isCorporate、corporateName、createdIn…
vtex_get_customerドキュメントIDで1つの顧客プロファイル(エンティティCL)を読み取ります:フィールドに名前が付けられています
vtex_update_customer顧客プロファイル(エンティティCL)のフィールドを変更します;指定されたフィールドのみが変更されます。例:phoneまたはisNewsletterOptIn
vtex_search_documents2文字の略語で任意のマスターデータv1エンティティを検索します。例:顧客住所のAD(userIdでフィルタリング)、またはカスタムエンティティ:…

例のプロンプト

  • "現在処理待ちのVTEX注文はどれですか?"
  • "注文1478920512345-01のアイテム、住所、支払いを表示してください。"
  • "SKU ref TSHIRT-BLK-Mの価格と倉庫ごとの在庫は?"
  • "SKU 2001の倉庫1_1の在庫を80に設定します。"
  • "アクティブな配送ポリシーとドックはどれですか?"

次のステップ

このガイドは役に立ちましたか?

VTEX を Claude、ChatGPT、Copilot に 2 分で接続

AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで VTEX を接続して、MCP URL を AI アシスタントに追加します。コードもサーバーの運用も不要です。

関連ガイド

コネクタ

VTEX MCPでChatGPTと連携:注文・価格

VTEXコマースプラットフォーム:処理と追跡を伴う注文(OMS)、カタログ製品とSKU、ストアフロント検索、価格、倉庫ごとの在庫、ドックと配送ポリシー、マスターデータ内の顧客プロファイル。アプリキーとアプリトークン。

コネクタ

VTEX MCPでClaudeと連携:注文・在庫

VTEXコマースプラットフォーム:処理と追跡を伴う注文(OMS)、カタログ製品とSKU、ストアフロント検索、価格、倉庫ごとの在庫、ドックと配送ポリシー、マスターデータ内の顧客プロファイル。アプリキーとアプリトークン。

コネクタ

VTEX MCPでMicrosoft Copilotと連携

VTEXコマースプラットフォーム:処理と追跡を伴う注文(OMS)、カタログ製品とSKU、ストアフロント検索、価格、倉庫ごとの在庫、ドックと配送ポリシー、マスターデータ内の顧客プロファイル。アプリキーとアプリトークン。

コネクタ

VTEX MCPでCursorと連携:商品・在庫

VTEXコマースプラットフォーム:処理と追跡を伴う注文(OMS)、カタログ製品とSKU、ストアフロント検索、価格、倉庫ごとの在庫、ドックと配送ポリシー、マスターデータ内の顧客プロファイル。アプリキーとアプリトークン。

コネクタ

VTEX MCPでGemini CLIと連携:注文・在庫

VTEXコマースプラットフォーム:処理と追跡を伴う注文(OMS)、カタログ製品とSKU、ストアフロント検索、価格、倉庫ごとの在庫、ドックと配送ポリシー、マスターデータ内の顧客プロファイル。アプリキーとアプリトークン。

コネクタ

VTEX MCPでMeta Museと連携:注文・在庫

VTEXコマースプラットフォーム:処理と追跡を伴う注文(OMS)、カタログ製品とSKU、ストアフロント検索、価格、倉庫ごとの在庫、ドックと配送ポリシー、マスターデータ内の顧客プロファイル。アプリキーとアプリトークン。