概要
VTEXコマースプラットフォーム:処理と追跡を伴う注文(OMS)、カタログ製品とSKU、ストアフロント検索、価格、倉庫ごとの在庫、ドックと配送ポリシー、マスターデータ内の顧客プロファイル。アプリキーとアプリトークン。
ガイド付きセットアップ
VTEX を Gemini に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで VTEX を接続して、MCP URL を Gemini に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
VTEX のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスしてください。 サインインし、Connectors → VTEXをクリックし、認証情報を貼り付け、MCP APIキーを生成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
VTEX + Gemini
VTEXコマースプラットフォーム:処理と追跡を伴う注文(OMS)、カタログ製品とSKU、ストアフロント検索、価格、倉庫ごとの在庫、ドックと配送ポリシー、マスターデータ内の顧客プロファイル。アプリキーとアプリトークン。
前提条件
コネクタに組み込まれた完全なセットアップ手順を参照してください(コネクタを選択したときにアプリ内ストアで表示されます)。このコネクタに必要な環境変数は以下の通りです:
VTEX_ACCOUNT_NAME, VTEX_ENVIRONMENT, VTEX_APP_KEY, VTEX_APP_TOKEN
ステップ1 — 認証情報を取得する
設定には約5分かかります。
- VTEX管理画面でアカウント設定、アカウント、セキュリティ、APIキー(古い管理者の場合:アカウント設定、アカウント管理、アプリケーションキー)を開き、キーを生成をクリックします。名前を付けます。
- 役割(ライセンス管理者)でキーに役割を割り当てます:読み取りと書き込みには、事前定義された役割OMS - フルアクセス、ロジスティクスフルアクセス、カタログ、価格設定、およびマスターデータの役割、または必要なリソースを持つカスタム役割を使用します。読み取り専用キーは読み取りツールに適しています。
- アプリキーを
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件、過去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エラーは予想されます。
ステップ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 — Geminiにコネクタを追加する
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL(
https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Gemini CLI は ~/.gemini/settings.json(Windows では %USERPROFILE%\.gemini\settings.json)から MCP サーバーを読み込みます。次を追加してください:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、
YOUR_MCP_API_KEYと置き換えます。 - ファイルを保存し、
geminiを再起動します。 - Gemini CLI で
/mcpを実行します(またはシェルでgemini mcp list)。anythingmcpが接続済みとして表示されるはずです。 - プロンプトを入力しましょう — Gemini CLI が
VTEXのツールを呼び出せるようになりました。
利用可能なツール
| ツール | 何をするか |
|---|---|
vtex_list_orders | 過去2年の注文をリスト表示し、デフォルトでは最新のものから表示します:orderId、creationDate、clientName、totalValue(セント単位)、statusなど… |
vtex_get_order | 1つの注文を読み取ります:status、value、total(セント単位)、アイテム(SKU id、refId、name、quantity、price、sellingPrice)、clientProfileDataなど… |
vtex_get_order_group | 1つのチェックアウトのすべての注文を読み取ります(注文グループは売り手ごとに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 | 注文の請求書を送信します(販売用の出力タイプ)、これにより請求書が発行され、VTEXが支払いを確保します。invoiceValue… |
vtex_update_invoice_tracking | 既存の注文の請求書に追跡番号、追跡リンク、運送業者、発送日を追加します。請求書を変更します;オフにしてインストールされています… |
vtex_list_product_and_sku_ids | SKU IDを持つ製品IDをリスト表示します。オプションで1つのカテゴリ内で:データは各productIdをそのSKU IDにマッピングし、range.totalが合計を提供します。ページ… |
vtex_get_product | 1つの製品を読み取ります: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_ean | EANバーコードで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_price | SKUの基本価格を作成または更新します:base_priceのみを指定するか(その場合、markupとcostは派生します)、またはmarkupをパーセントで指定してcost_priceを指定します… |
vtex_get_sku_inventory | 各倉庫のSKUの在庫を読み取ります:warehouseId、warehouseName、totalQuantity、reservedQuantity、hasUnlimitedQuantity、timeToRefill… |
vtex_update_sku_inventory | 1つの倉庫の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)を読み取ります:fieldsで指定されたフィールド |
vtex_update_customer | 顧客プロファイル(エンティティCL)のフィールドを変更します;指定されたフィールドのみが変更されます、例:phoneまたはisNewsletterOptIn |
vtex_search_documents | 2文字の略語で任意のマスターデータv1エンティティを検索します、例:ADは顧客住所(userIdでフィルタリング)またはカスタムエンティティ:the… |
例のプロンプト
- "現在処理待ちのVTEX注文はどれですか?"
- "注文1478920512345-01のアイテム、住所、支払いを表示してください。"
- "SKU ref TSHIRT-BLK-Mの倉庫ごとの価格と在庫は何ですか?"
- "SKU 2001の倉庫1_1の在庫を80に設定してください。"
- "アクティブな配送ポリシーとドックはどれですか?"
FAQ
アプリキーとトークンはどこから来ますか? VTEX管理画面のアカウント設定、アカウント、セキュリティ、APIキーで:キーを生成し、OMS、ロジスティクス、カタログ、価格設定などの役割を割り当て、アプリキーとアプリトークンをコピーします(1回表示されます)。
何をカバーしていますか? 処理、インタラクション、追跡を伴う注文(OMS)、カタログ製品とSKU、ストアフロント検索、価格と価格テーブル、倉庫ごとの在庫、ドックと配送ポリシー、マスターデータ内の顧客プロファイル。
どのツールがオフにしてインストールされていますか? vtex_cancel_order、vtex_invoice_order、vtex_update_invoice_trackingは、顧客のために注文をキャンセルまたは請求書を発行するため、オフにしてインストールされています。AIが使用する必要がある場合のみ、コネクタページでオンにしてください。
Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。
次のステップ
このガイドは役に立ちましたか?