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 ChatGPT verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde VTEX in der geführten Einrichtung und trag deine MCP-URL in ChatGPT ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
Das AnythingMCP-Plugin im ChatGPT-Verzeichnis beantwortet auf AnythingMCP Cloud Fragen aus deinen Firmendatenbanken (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, nur lesend): Öffne den Eintrag (öffnet in neuem Tab) und klicke auf Install plugin. Alle anderen Connectors fügst du in ChatGPT als eigenen MCP-Server mit deiner AnythingMCP-MCP-URL hinzu.
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.
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 + ChatGPT
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.
- Ö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.
- 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.
- Kopiere den App-Schlüssel in
VTEX_APP_KEYund den App-Token inVTEX_APP_TOKEN(der Token wird nur einmal angezeigt). - Gib den Kontonamen (den ersten Teil von
https://<account>.myvtex.com) inVTEX_ACCOUNT_NAMEein und lasse die Umgebungvtexcommercestable.
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 ChatGPT 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 AnleitungYOUR_SERVER_IDzeigt.
ChatGPT fügt MCP-Server als Plugins auf seiner Seite Plugins hinzu, im Web und in den kostenpflichtigen Tarifen. Den Entwicklermodus brauchst du dafür nicht mehr. In einem Business-Workspace dürfen das nur Admins und Owner; in Enterprise und Edu kann ein Admin die Berechtigung Create plugins with MCPs vergeben.
- Geh zu chatgpt.com/plugins, klicke auf Add und dann auf Add custom MCP server.
- Gib einen Namen ein, z. B. Name:
VTEX. - Trag unter Connection als Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDein und lass Authentication auf OAuth. - Wähle I understand and want to continue und dann Create as a plugin. Wenn ChatGPT danach fragt, meldest du dich bei AnythingMCP an und erlaubst den Zugriff.
- Installiere das neue Plugin unter deinen persönlichen Plugins, tippe dann in einem Chat @ und wähle es aus.
Verfügbare Tools
| Tool | Was es tut |
|---|---|
vtex_list_orders | Listet Bestellungen der letzten zwei Jahre, neueste zuerst standardmäßig: orderId, creationDate, clientName, totalValue in Cent, status und… |
vtex_get_order | Liest eine Bestellung: status, wert und totals in Cent, artikel (SKU id, refId, name, quantity, price, sellingPrice), clientProfileData… |
vtex_get_order_group | Liest 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_order | Bewege 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_interaction | Schreibe eine Zeile in das Interaktionsprotokoll der Bestellung (im Bestellverlauf im Admin angezeigt), z. B. eine Notiz vom Lager. Ändert nicht… |
vtex_get_order_conversation | Liest 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_transaction | Liest die Zahlungstransaktion einer Bestellung: Transaktions-ID, Status, Zahlungen mit Methode, Wert in Cent, Raten und die Ereignisgeschichte.… |
vtex_update_tracking_status | Sendet Verfolgungsereignisse an eine Rechnung, die bereits eine Tracking-Nummer hat (isDelivered, deliveredDate und die Liste der Ereignisse mit Stadt, Bundesland… |
vtex_cancel_order | Storniert 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_order | Sendet die Rechnung einer Bestellung (Typ Ausgabe für einen Verkauf), was sie fakturiert und VTEX die Zahlung erfassen lässt. invoiceValue… |
vtex_update_invoice_tracking | Fü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_ids | Listet 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_product | Liest ein Produkt: Id, Name, DepartmentId, CategoryId, BrandId, LinkId (URL-Slug), RefId, IsVisible, IsActive, Beschreibung, Titel… |
vtex_get_product_by_ref_id | Findet ein Produkt anhand seines Referenzcodes (RefId) und liest die gleichen Felder wie vtex_get_product |
vtex_list_product_skus | Listet die SKUs eines Produkts: Id, ProductId, IsActive, Name, RefId, EAN-bezogene Felder, Abmessungen, Gewicht und Maßeinheit |
vtex_get_sku | Liest eine SKU mit ihrem Kontext: Id, ProductId, NameComplete, ProductName, SkuName, AlternateIds (EAN, RefId), Bilder, Abmessungen, Verkäufer… |
vtex_get_sku_by_ref_id | Findet eine SKU anhand ihres Referenzcodes (RefId): Id, ProductId, IsActive, Name, RefId, Abmessungen und Gewicht |
vtex_get_sku_by_ean | Findet eine SKU anhand ihres EAN-Barcodes und liest die gleichen Felder wie vtex_get_sku |
vtex_search_products | Durchsuche den veröffentlichten Katalog wie der Shop: productId, productName, Marke, Link, Kategorien und Artikel (SKUs) mit Verkäufern und… |
vtex_get_category_tree | Liest den Kategorienbaum bis zur angegebenen Tiefe: id, name, hasChildren, url und Kinder für jede Kategorie |
vtex_list_brands | Listet alle Marken: id, name, isActive, title, metaTagDescription und imageUrl |
vtex_get_price | Liest die Preise einer SKU aus der Preis-API: itemId, listPrice, costPrice, markup, basePrice und fixedPrices pro Handelsrichtlinie… |
vtex_get_computed_price | Liest den Preis, den eine Preistabelle (Handelsrichtlinie) tatsächlich für eine SKU nach den Preisregeln berechnet: tradePolicyId, listPrice, costPrice… |
vtex_list_price_tables | Listet die Preis-Tabellen-IDs des Kontos (zum Beispiel 1 für die Haupt-Handelsrichtlinie oder Namen wie gold) |
vtex_update_price | Erstellt 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_inventory | Liest den Bestand einer SKU in jedem Lager: warehouseId, warehouseName, totalQuantity, reservedQuantity, hasUnlimitedQuantity, timeToRefill… |
vtex_update_sku_inventory | Setzt den Bestand einer SKU in einem Lager: Menge ersetzt die Gesamtmenge (Reservierungen werden separat gehalten); unlimited_quantity true hält… |
vtex_list_warehouses | Listet Lager: id, name, warehouseDocks (Dock-IDs mit Zeit und Kosten) und isActive |
vtex_list_docks | Listet Ladebuchten: id, name, priorität, dockTimeFake, salesChannels, freightTableIds und die Pickup-Store-Info |
vtex_list_shipping_policies | Listet Versandrichtlinien (Transportunternehmen und Frachttabellen): id, name, shippingMethod, isActive, deliveryOnWeekends, maxDimension und business… |
vtex_search_customers | Durchsuche Kundenprofile (Master Data-Entität CL): E-Mail, Vorname, Nachname, Dokument, Telefon, isCorporate, corporateName, createdIn und… |
vtex_get_customer | Liest 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_documents | Durchsuche 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.
Funktioniert der kostenlose ChatGPT-Tarif mit eigenen MCP-Servern? OpenAI dokumentiert eigene MCP-Server nur für kostenpflichtige Tarife; den Free-Tarif führt OpenAI nicht auf.
Nächste Schritte
War dieser Guide hilfreich?