Installation überspringen. In unter 2 Minuten einsatzbereit.
Starte eine kostenlose Testphase auf cloud.anythingmcp.com, füge Shoptet mit einem Klick hinzu und richte deinen KI-Client (Claude, ChatGPT, Copilot oder Cursor) auf den erzeugten MCP-Endpoint. Kein Docker, kein git clone, keinerlei Entwicklungserfahrung nötig.
Zusammenfassung
Shoptet-E-Shop (Tschechien, Slowakei, Ungarn), nur lesend: Bestellungen mit Verlauf und Notizen, Produkte und Varianten mit Preisen und Bestand, Kategorien, Marken, Lagerbestände und Lagerbewegungen, Kunden, Rechnungen, Proformarechnungen, Gutschriften sowie Zahlungs- und Versandarten.
Frag einfach
Beispiel-Prompts für Shoptet
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. Einloggen, Connectors → Shoptet klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein
git clone, kein lokaler Server.
Shoptet + Gemini
Shoptet-E-Shop (Tschechien, Slowakei, Ungarn), nur lesend: Bestellungen mit Verlauf und Notizen, Produkte und Varianten mit Preisen und Bestand, Kategorien, Marken, Lagerbestände und Lagerbewegungen, Kunden, Rechnungen, Proformarechnungen, Gutschriften sowie Zahlungs- und Versandarten.
Voraussetzungen
Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:
SHOPTET_API_TOKEN
Schritt 1 — Zugangsdaten holen
Die Einrichtung dauert etwa 3 Minuten. Du brauchst einen Shoptet Premium-E-Shop, denn die private API gibt es nur bei Premium, und Zugang zu seiner Administration.
- Öffne in der Shoptet-Administration Connections (Propojení), Private API und erstelle ein Token.
- Gib dem Token Lesezugriff auf die Bereiche, die die KI sehen soll: Bestellungen, Produkte, Lager, Kunden und Dokumente. Ein Bereich, den das Token nicht lesen darf, antwortet mit 403.
- Füge das Token in
SHOPTET_API_TOKENein: nur das Token, ohne Leerzeichen oder Anführungszeichen. - Installiere den Connector und rufe
shoptet_get_eshopauf: Es zeigt Name, URL, Währungen, Sprachen und Zeitzone des Shops und damit, dass das Token funktioniert.
Ein Token, ein E-Shop: Ein Token gehört zu genau einem E-Shop. Betreibst du einen .cz- und einen .sk-Shop, installierst du den Connector ein zweites Mal mit dem Token des anderen Shops.
Was sie liest: die Einstellungen des Shops; Bestellungen mit Rechnungs- und Lieferadresse, Positionen, Preisen mit und ohne MwSt., Status, Bezahlt-Kennzeichen, Zahlungs- und Versandart, Verkaufskanal, Notizen und Sendungsnummer; den kompletten Verlauf einer Bestellung (Statuswechsel, versendete E-Mails, Bemerkungen); Produkte und ihre Varianten mit Code, EAN, Preis, Steuersatz, Verfügbarkeit und Bestand, auf Wunsch pro Lager; Kategorien und Marken; Lagerbestände mit den durch Bestellungen reservierten Mengen sowie Lagerbewegungen; registrierte Kunden mit Adressen, Firmen- und USt-ID und Kundengruppe; Rechnungen mit variablem Symbol, Fälligkeit und MwSt.-Aufschlüsselung; Proformarechnungen; Gutschriften (opravné daňové doklady) mit Grund; sowie Zahlungs- und Versandarten.
Erst die Shop-Einstellungen: Bestellstatus, Bestellquellen, Lager, Kategorien und Marken sind in jedem Shop anders. Die KI liest deshalb zuerst deren IDs aus deinem Shop (zum Beispiel mit shoptet_list_order_statuses oder shoptet_list_stocks) und filtert dann damit. Ein Produkt findet sie über seinen Code, also die SKU aus der Administration und den Bestellungen, mit shoptet_get_product_by_code.
Seiten, Zeiten und Preise: Bestellungen kommen neueste zuerst, höchstens 50 pro Seite; Produkte 1 bis 100 pro Seite; Gutschriften höchstens 20 pro Seite. Jede Liste sagt, wie viele Seiten es gibt, und die KI holt die nächste nur, wenn sie sie braucht. Zeiten tragen einen Offset wie 2026-10-20T00:00:00+0200: Tschechische und slowakische Shops laufen auf Europe/Prague-Zeit. Preise kommen mit der Shop-Währung, etwa CZK oder EUR.
Nur lesend: Der Connector hat kein Tool, das etwas ändert. Er kann weder eine Bestellung oder ihren Status noch ein Produkt, einen Preis, den Bestand oder einen Kunden ändern, also gibt es für die KI nichts mit dir abzustimmen.
Limits: Shoptet erlaubt 3 gleichzeitige Anfragen pro Token und bremst Lastspitzen mit einem 429. Die KI wartet dann ein paar Sekunden, bevor sie es erneut versucht, und fragt gezielt ab, statt den ganzen Shop durchzublättern.
Häufige Fehler: 401 expired-token oder invalid-token bedeutet, dass das Token gelöscht wurde oder abgelaufen ist: Erstelle ein neues. 403 invalid-token-no-rights heißt, dass das Token keinen Zugriff auf diesen Bereich hat: Passe seine Rechte unter Private API an. 404 heißt, dass es keine Bestellung, kein Produkt und kein Dokument mit diesem Code gibt.
Der Connector legt keine Bestellungen, Produkte, Preise, Bestände oder Kunden an und ändert sie nicht, stellt keine Rechnungen oder Gutschriften aus und schickt deinen Kunden keine E-Mails.
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 AnleitungYOUR_SERVER_IDzeigt.
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" }
}
}
}
- Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von
YOUR_MCP_API_KEYein. - Speichere die Datei und starte
geminineu. - Führe in der Gemini CLI
/mcpaus (odergemini mcp listim Terminal):anythingmcpsollte als verbunden erscheinen. - Leg los: Gemini CLI kann jetzt die
Shoptet-Tools aufrufen.
Verfügbare Tools
| Tool | What it does |
|---|---|
shoptet_get_eshop | Get the e-shop's own settings: name, URL, contact and billing details, VAT payer, time zone, default price list, currencies and languages.… |
shoptet_list_orders | List orders, newest first, at most 50 per page: code, creation and change time, customer name, e-mail and phone, status, paid flag, total… |
shoptet_get_order | Get one order by its code (order number): billing and delivery address, items with code, name, amount, unit price and VAT, prices, status… |
shoptet_get_order_history | Get the history of an order: every status change, e-mail sent, remark and system event with time, text and the user who did it |
shoptet_list_order_statuses | List the order statuses of the shop (they differ from shop to shop): id, name, whether it is a system status, whether it marks the order… |
shoptet_list_order_sources | List the order sources of the shop (e-shop, cash desk, marketplaces, imports) with id and name |
shoptet_list_products | List products, 1 to 100 per page: guid, name, type, visibility, default category, brand, supplier, URL and rating |
shoptet_get_product | Get one product by guid with its variants: code, EAN, price, VAT rate, stock amount, availability, weight and parameters per variant… |
shoptet_get_product_by_code | Get a product by the code of the product or of one of its variants (the SKU shown in the admin and on orders), with the same details and… |
shoptet_list_categories | List the product categories: guid, name, parent guid, visibility and URL |
shoptet_list_brands | List the brands (manufacturers) of the shop: guid, code, name, web and whether they show in the brand list |
shoptet_list_stocks | List the stocks (warehouses) of the shop with id, title and whether they are a pickup point, plus the default stock id |
shoptet_list_stock_supplies | List the stock levels in one stock: product guid, code, amount in stock, claimed amount (reserved by orders) and storage location |
shoptet_list_stock_movements | List stock movements in one stock, oldest first: product code, amount after the change, the change, time and who or what changed it (an… |
shoptet_list_customers | List registered customers: guid, billing name and company, creation and change time and admin link |
shoptet_get_customer | Get one registered customer: billing and delivery addresses, company id and VAT id, customer group, price ratio, remark and account e-mails |
shoptet_list_customer_groups | List the customer groups (e.g. retail, wholesale, VIP) with id, name, default price list and maximum discount |
shoptet_list_invoices | List invoices: code, order code, issue, due and tax dates, billing name and company, variable symbol, paid flag and price |
shoptet_get_invoice | Get one invoice by its code: items, prices and VAT breakdown, billing and delivery address, payment method, due date, paid flag and symbols |
shoptet_list_credit_notes | List credit notes (opravné daňové doklady): code, invoice and order code, date, billing name, reason and price |
shoptet_list_proforma_invoices | List proforma invoices (advance invoices): code, order code, date, billing name, paid flag and price |
shoptet_list_payment_methods | List the payment methods of the shop with guid, name, type, visibility and whether they are for wholesale or in-person payment |
shoptet_list_shipping_methods | List the shipping methods of the shop with guid, name, carrier, tracking URL and visibility |
Beispiel-Prompts
- „Welche Bestellungen von gestern sind noch unbezahlt, und wie hoch ist jeweils die Summe in CZK?“
- „Zeig mir den Verlauf der Bestellung 2026000123: Wann hat sich der Status geändert, welche E-Mails gingen an den Kunden, und wie lautet die Sendungsnummer?“
- „Welche Produkte werden in unserem Hauptlager knapp, und wie viel davon ist schon durch Bestellungen reserviert?“
- „Such alle Bestellungen von [email protected] aus diesem Jahr und sag mir, welche ihrer Rechnungen noch offen sind.“
- „Liste die Gutschriften dieses Monats mit Grund, Betrag und der zugehörigen Rechnung auf.“
FAQ
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?
