Connector-Anleitung9 Minuten Lesezeit34 MCP-Tools7 Sprachen

VTEX MCP mit Gemini CLI verbinden

VTEX-Commerce-Plattform: Bestellungen (OMS) mit Bearbeitung und Verfolgung, Katalogprodukte und SKUs, Suchfunktion im Shop, Preise, Lagerbestand pro Lager, Docks und Versandrichtlinien sowie Kundenprofile in Master Data. App-Schlüssel und App-Token.

HCVom HelpCode-TeamAktualisiert 9 Min. Lesezeit Open Source auf GitHub

Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar

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.

Tools

34

Region

INTL

Kategorie

E-Commerce

Authentifizierung

API Key

Benötigte Env-Vars

VTEX_ACCOUNT_NAMEVTEX_ENVIRONMENTVTEX_APP_KEYVTEX_APP_TOKEN
Mit einem Klick in der Cloud installieren

7 Tage kostenlos testen · Keine Kreditkarte

  • 7 Tage kostenlos
    Keine Kreditkarte nötig
  • DSGVO & SOC 2 ready
    EU-Datenhaltung, Audit-Logs
  • Open Source auf GitHub
    Open-Source · AGPL-3.0
  • Funktioniert mit ChatGPT, Claude, Gemini
    Jeder MCP-kompatible Client

Zusammenfassung

VTEX-Commerce-Plattform: Bestellungen (OMS) mit Bearbeitung und Verfolgung, Katalogprodukte und SKUs, Suchfunktion im Shop, Preise, Lagerbestand pro Lager, Docks und Versandrichtlinien sowie Kundenprofile in Master Data. App-Schlüssel und App-Token.

Geführte Einrichtung

VTEX in 2 Minuten mit Gemini verbinden

Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde VTEX in der geführten Einrichtung und trag deine MCP-URL in Gemini ein. Ohne Code, ohne eigenen Server.

Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar

Frag einfach

Beispiel-Prompts für VTEX

Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.

VTEX · live via MCP
Teilen
Opus 4.7

Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → VTEX, füge deine Zugangsdaten ein, erstelle einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein git clone, kein lokaler Server.

VTEX + Gemini

VTEX-Commerce-Plattform: Bestellungen (OMS) mit Bearbeitung und Verfolgung, Katalogprodukte und SKUs, Suchfunktion im Shop, Preise, Lagerbestand pro Lager, Docks und Versandrichtlinien sowie Kundenprofile in Master Data. App-Schlüssel und App-Token.

Voraussetzungen

Siehe die vollständigen Einrichtungsanweisungen, die im Connector integriert sind (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:

VTEX_ACCOUNT_NAME, VTEX_ENVIRONMENT, VTEX_APP_KEY, VTEX_APP_TOKEN

Schritt 1 — Zugangsdaten erhalten

Die Einrichtung dauert etwa 5 Minuten.

  1. Öffne im VTEX Admin Kontoeinstellungen, Konto, Sicherheit, API-Schlüssel (ältere Admins: Kontoeinstellungen, Kontoverwaltung, Anwendungs-Schlüssel) und klicke auf Schlüssel generieren. Gib ihm einen Namen.
  2. Weisen Sie dem Schlüssel in Rollen (Lizenzmanager) Rollen zu: Für Lese- und Schreibzugriff verwende die vordefinierten Rollen OMS - Vollzugriff, Logistik Vollzugriff, Katalog, Preise und eine Master Data-Rolle oder eine benutzerdefinierte Rolle mit den benötigten Ressourcen. Ein schreibgeschützter Schlüssel funktioniert für die Lesetools.
  3. Kopiere den App-Schlüssel in VTEX_APP_KEY und den App-Token in VTEX_APP_TOKEN (der Token wird nur einmal angezeigt).
  4. Gib den Kontonamen (den ersten Teil von https://<account>.myvtex.com) in VTEX_ACCOUNT_NAME ein und lasse die Umgebung vtexcommercestable.

Der Connector sendet den Schlüssel und den Token in den Headern X-VTEX-API-AppKey und X-VTEX-API-AppToken bei jedem Aufruf.

Wo du anfangen kannst: vtex_list_orders (filtere mit f_status, zum Beispiel ready-for-handling), dann vtex_get_order für Artikel, Adresse und Zahlung. Für ein Produkt beginne bei vtex_search_products oder vtex_get_sku_by_ref_id, dann vtex_get_sku, vtex_get_price und vtex_get_sku_inventory.

Bestellungen: vtex_list_orders (keine Artikel in der Liste; maximal 30 Seiten mit bis zu 100, nur die letzten zwei Jahre), vtex_get_order, vtex_get_order_group, vtex_get_order_conversation, vtex_get_payment_transaction. Bewege eine bezahlte Bestellung mit vtex_start_handling_order, logge eine Notiz mit vtex_add_order_interaction und sende Lieferereignisse mit vtex_update_tracking_status. Drei Tools sind installiert, aber deaktiviert: vtex_cancel_order (kann nicht rückgängig gemacht werden, erstattet eine bezahlte Bestellung), vtex_invoice_order (Rechnungsstellung lässt VTEX die Zahlung erfassen und friert die Bestellung ein) und vtex_update_invoice_tracking (ändert eine Rechnung). Geldwerte in Bestellungen sind Ganzzahlen in Cent (totalValue 12990 ist 129,90).

Katalog: 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 (Suchfunktion im Shop mit Live-Preis und verfügbarer Menge), vtex_get_category_tree, vtex_list_brands. Produkt- und SKU-IDs sind Zahlen; RefId ist der eigene Code des Händlers.

Preise: vtex_get_price, vtex_get_computed_price, vtex_list_price_tables, vtex_update_price. Preiswerte sind Dezimalzahlen (49,9), im Gegensatz zu Bestellwerten.

Lagerbestand und Logistik: vtex_get_sku_inventory, vtex_update_sku_inventory (setzt den Gesamtbestand in einem Lager), vtex_list_warehouses, vtex_list_docks, vtex_list_shipping_policies.

Kunden (Master Data v1): vtex_search_customers, vtex_get_customer, vtex_update_customer und vtex_search_documents für jede Entität (AD hält Adressen, verknüpft über userId mit der CL-ID). Suchen geben maximal 100 Zeilen pro Aufruf zurück, ausgewählt mit range_start und range_end; frage nur nach den Feldern, die du benötigst, denn ein Schlüssel ohne Rechte auf ein Feld erhält 403, wenn _all verwendet wird.

Grenzen und Fallstricke: VTEX erlaubt etwa 6.000 Bestelllesungen pro Minute pro Konto und antwortet mit 429, wenn eine API überlastet ist. Daten in Filtern sind UTC. Ein 403 bedeutet, dass die Rolle des Schlüssels die benötigte Ressource für den Aufruf nicht hat; ein 404 bei einer Bestellung, die älter als zwei Jahre ist, ist zu erwarten.

Schritt 2 — Adapter installieren

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

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
  2. Speichere die Datei und starte gemini neu.
  3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal) — anythingmcp sollte als verbunden erscheinen.
  4. Leg los: Gemini CLI kann jetzt die VTEX-Tools aufrufen.

Verfügbare Tools

ToolWas es tut
vtex_list_ordersListet Bestellungen der letzten zwei Jahre, neueste zuerst standardmäßig: orderId, creationDate, clientName, totalValue in Cent, status und…
vtex_get_orderLiest eine Bestellung: status, wert und totals in Cent, artikel (SKU id, refId, name, quantity, price, sellingPrice), clientProfileData…
vtex_get_order_groupLiest alle Bestellungen eines Checkouts (eine Bestellgruppe wird in eine Bestellung pro Verkäufer aufgeteilt): die gleichen Felder wie vtex_get_order für jede Bestellung
vtex_start_handling_orderBewege eine Bestellung von bereit zur Bearbeitung, was VTEX mitteilt, dass der Verkäufer mit der Vorbereitung begonnen hat. VTEX antwortet mit 204 ohne Body…
vtex_add_order_interactionSchreibe eine Zeile in das Interaktionsprotokoll der Bestellung (im Bestellverlauf im Admin angezeigt), z. B. eine Notiz vom Lager. Ändert nicht…
vtex_get_order_conversationLiest die E-Mail-Konversation einer Bestellung: Nachrichten, die VTEX und der Shop an den Kunden gesendet haben (Betreff, von, an, Datum, Body)
vtex_get_payment_transactionLiest die Zahlungstransaktion einer Bestellung: Transaktions-ID, Status, Zahlungen mit Methode, Wert in Cent, Raten und die Ereignisgeschichte.…
vtex_update_tracking_statusSendet Verfolgungsereignisse an eine Rechnung, die bereits eine Tracking-Nummer hat (isDelivered, deliveredDate und die Liste der Ereignisse mit Stadt, Bundesland…
vtex_cancel_orderStorniert eine Bestellung, die noch nicht fakturiert ist, mit einem Grund. Kann nicht rückgängig gemacht werden; bezahlte Bestellungen werden von VTEX erstattet. Installiert, aber deaktiviert
vtex_invoice_orderSendet die Rechnung einer Bestellung (Typ Ausgabe für einen Verkauf), was sie fakturiert und VTEX die Zahlung erfassen lässt. invoiceValue…
vtex_update_invoice_trackingFügt einer bestehenden Rechnung einer Bestellung eine Tracking-Nummer, einen Tracking-Link, einen Anbieter und ein Versanddatum hinzu. Ändert die Rechnung; installiert, aber deaktiviert…
vtex_list_product_and_sku_idsListet Produkt-IDs mit ihren SKU-IDs, optional in einer Kategorie: Daten verknüpfen jede productId mit ihren SKU-IDs, range.total gibt die Gesamtzahl an. Seite…
vtex_get_productLiest ein Produkt: Id, Name, DepartmentId, CategoryId, BrandId, LinkId (URL-Slug), RefId, IsVisible, IsActive, Beschreibung, Titel…
vtex_get_product_by_ref_idFindet ein Produkt anhand seines Referenzcodes (RefId) und liest die gleichen Felder wie vtex_get_product
vtex_list_product_skusListet die SKUs eines Produkts: Id, ProductId, IsActive, Name, RefId, EAN-bezogene Felder, Abmessungen, Gewicht und Maßeinheit
vtex_get_skuLiest eine SKU mit ihrem Kontext: Id, ProductId, NameComplete, ProductName, SkuName, AlternateIds (EAN, RefId), Bilder, Abmessungen, Verkäufer…
vtex_get_sku_by_ref_idFindet eine SKU anhand ihres Referenzcodes (RefId): Id, ProductId, IsActive, Name, RefId, Abmessungen und Gewicht
vtex_get_sku_by_eanFindet eine SKU anhand ihres EAN-Barcodes und liest die gleichen Felder wie vtex_get_sku
vtex_search_productsDurchsuche den veröffentlichten Katalog wie der Shop: productId, productName, Marke, Link, Kategorien und Artikel (SKUs) mit Verkäufern und…
vtex_get_category_treeLiest den Kategorienbaum bis zur angegebenen Tiefe: id, name, hasChildren, url und Kinder für jede Kategorie
vtex_list_brandsListet alle Marken: id, name, isActive, title, metaTagDescription und imageUrl
vtex_get_priceLiest die Preise einer SKU aus der Preis-API: itemId, listPrice, costPrice, markup, basePrice und fixedPrices pro Handelsrichtlinie…
vtex_get_computed_priceLiest den Preis, den eine Preistabelle (Handelsrichtlinie) tatsächlich für eine SKU nach den Preisregeln berechnet: tradePolicyId, listPrice, costPrice…
vtex_list_price_tablesListet die Preis-Tabellen-IDs des Kontos (zum Beispiel 1 für die Haupt-Handelsrichtlinie oder Namen wie gold)
vtex_update_priceErstellt oder aktualisiert den Basispreis einer SKU: gib base_price allein an (Markup und Kosten werden dann abgeleitet), oder cost_price mit Markup in Prozent…
vtex_get_sku_inventoryLiest den Bestand einer SKU in jedem Lager: warehouseId, warehouseName, totalQuantity, reservedQuantity, hasUnlimitedQuantity, timeToRefill…
vtex_update_sku_inventorySetzt den Bestand einer SKU in einem Lager: Menge ersetzt die Gesamtmenge (Reservierungen werden separat gehalten); unlimited_quantity true hält…
vtex_list_warehousesListet Lager: id, name, warehouseDocks (Dock-IDs mit Zeit und Kosten) und isActive
vtex_list_docksListet Ladebuchten: id, name, priorität, dockTimeFake, salesChannels, freightTableIds und die Pickup-Store-Info
vtex_list_shipping_policiesListet Versandrichtlinien (Transportunternehmen und Frachttabellen): id, name, shippingMethod, isActive, deliveryOnWeekends, maxDimension und business…
vtex_search_customersDurchsuche Kundenprofile (Master Data-Entität CL): E-Mail, Vorname, Nachname, Dokument, Telefon, isCorporate, corporateName, createdIn und…
vtex_get_customerLiest ein Kundenprofil (Entität CL) nach Dokument-ID: die in Feldern genannten Felder
vtex_update_customerÄndert Felder eines Kundenprofils (Entität CL); nur die angegebenen Felder werden geändert, z. B. Telefon oder isNewsletterOptIn
vtex_search_documentsDurchsuche jede Master Data v1-Entität nach ihrem zweibuchstabigen Akronym, z. B. AD für Kundenadressen (filter auf userId), oder eine benutzerdefinierte Entität: die…

Beispielaufforderungen

  • "Welche VTEX-Bestellungen sind gerade zur Bearbeitung bereit?"
  • "Zeige Bestellung 1478920512345-01 mit ihren Artikeln, Adresse und Zahlung."
  • "Was ist der Preis und der Bestand pro Lager der SKU-Referenz TSHIRT-BLK-M?"
  • "Setze den Bestand der SKU 2001 im Lager 1_1 auf 80."
  • "Welche Versandrichtlinien und Docks sind aktiv?"

FAQ

Woher kommen der App-Schlüssel und der Token? Im VTEX Admin unter Kontoeinstellungen, Konto, Sicherheit, API-Schlüssel: generiere einen Schlüssel, weise Rollen wie OMS, Logistik, Katalog und Preise zu und kopiere den App-Schlüssel und den App-Token (einmal angezeigt).

Was deckt es ab? Bestellungen (OMS) mit Bearbeitung, Interaktionen und Verfolgung, Katalogprodukte und SKUs, Suchfunktion im Shop, Preise und Preistabellen, Lagerbestand pro Lager, Docks und Versandrichtlinien sowie Kundenprofile in Master Data.

Welche Tools sind installiert, aber deaktiviert? vtex_cancel_order, vtex_invoice_order und vtex_update_invoice_tracking, da sie Bestellungen für den Kunden stornieren oder fakturieren. Schalte sie auf der Connector-Seite nur ein, wenn die KI sie verwenden soll.

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

War dieser Guide hilfreich?

VTEX in 2 Minuten mit Gemini verbinden

Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde VTEX in der geführten Einrichtung und trag deine MCP-URL in Gemini ein. Ohne Code, ohne eigenen Server.

Verwandte Anleitungen

Connectors

VTEX MCP mit ChatGPT verbinden

VTEX-Commerce-Plattform: Bestellungen (OMS) mit Bearbeitung und Verfolgung, Katalogprodukte und SKUs, Suchfunktion im Shop, Preise, Lagerbestand pro Lager, Docks und Versandrichtlinien sowie Kundenprofile in Master Data. App-Schlüssel und App-Token.

Connectors

VTEX MCP mit Claude verbinden

VTEX-Commerce-Plattform: Bestellungen (OMS) mit Bearbeitung und Verfolgung, Katalogprodukte und SKUs, Suchfunktion im Shop, Preise, Lagerbestand pro Lager, Docks und Versandrichtlinien sowie Kundenprofile in Master Data. App-Schlüssel und App-Token.

Connectors

VTEX MCP mit Microsoft Copilot verbinden

VTEX-Commerce-Plattform: Bestellungen (OMS) mit Bearbeitung und Verfolgung, Katalogprodukte und SKUs, Suchfunktion im Shop, Preise, Lagerbestand pro Lager, Docks und Versandrichtlinien sowie Kundenprofile in Master Data. App-Schlüssel und App-Token.

Connectors

VTEX MCP mit Cursor verbinden

VTEX-Commerce-Plattform: Bestellungen (OMS) mit Bearbeitung und Verfolgung, Katalogprodukte und SKUs, Suchfunktion im Shop, Preise, Lagerbestand pro Lager, Docks und Versandrichtlinien sowie Kundenprofile in Master Data. App-Schlüssel und App-Token.

Connectors

VTEX MCP mit Meta Muse verbinden

VTEX-Commerce-Plattform: Bestellungen (OMS) mit Bearbeitung und Verfolgung, Katalogprodukte und SKUs, Suchfunktion im Shop, Preise, Lagerbestand pro Lager, Docks und Versandrichtlinien sowie Kundenprofile in Master Data. App-Schlüssel und App-Token.

Connectors

VTEX MCP-Server: Bestellungen, Produkte und Lager

VTEX-Commerce-Plattform: Bestellungen (OMS) mit Abwicklung und Verfolgung, Katalogprodukte und SKUs, Suchfunktion im Shop, Preise, Inventar pro Lager, Dock- und Versandrichtlinien sowie Kundenprofile in Master Data. App-Schlüssel und App-Token.