Shoper über MCP mit Cursor verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Shoper klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Shoper + Cursor

Shoper-Onlineshops (Polen): Bestellungen mit Positionen und Paketen, Produkte und Bestand pro Variante, Kategorien, registrierte Kunden, Bestellstatus, Versand- und Zahlungsarten. Setzt Lagerbestände; Statusänderungen, die den Kunden per E-Mail benachrichtigen können, sind bei der Installation aus.

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:

SHOPER_SHOP_HOST, SHOPER_API_LOGIN, SHOPER_API_PASSWORD

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 5 Minuten. Du brauchst Administratorzugang zum Shoper-Adminpanel des Shops.

1. Öffne im Shoper-Adminpanel Ustawienia, Ogólne, Administratorzy sklepu (Einstellungen, Allgemein, Shop-Administratoren). Klicke auf WIĘCEJ, Dodaj grupę administratorów, gib ihr einen Namen (z. B. AI) und wähle den Zugriffstyp dostęp do webapi. Speichern.
2. Öffne die Gruppe, Reiter Uprawnienia (Berechtigungen): Erlaube das Lesen von Bestellungen, Produkten, Kunden und den Einstellungen, die die KI sehen soll. Erlaube das Bearbeiten von Produkten nur, wenn die KI Bestände setzen soll, und von Bestellungen nur, wenn du die Statusänderung einschaltest. Speichern.
3. Reiter Administratorzy, DODAJ ADMINISTRATORA: Leg Login und Passwort an und trag sie in SHOPER_API_LOGIN und SHOPER_API_PASSWORD ein. Eine registrierte Shoper-App kann hier stattdessen ihre client_id und ihr client_secret verwenden.
4. Setz SHOPER_SHOP_HOST auf die Shop-Adresse ohne https:// und ohne Pfad, z. B. myshop.shoparena.pl oder deine eigene Domain sklep.example.pl.
5. Installiere den Connector und rufe shoper_list_orders auf: Es listet deine Bestellungen und bestätigt den Login.

Der Connector meldet sich an /webapi/rest/auth mit HTTP Basic an und erhält ein Token, das 30 Tage gilt und das er selbst erneuert.

Was er liest: Bestellungen mit Datum, Status, Kunde, Rechnungs- und Lieferadresse, Summe, bezahltem Betrag und Bezahlt-Flag, Versand- und Zahlungsart, Versandkosten, Notizen, Herkunft, Tags und Anzahl der Pakete; eine Bestellung vollständig, mit Abholpunkt und Zusatzfeldern; Bestellpositionen mit Produkt, Variante (Stock-ID), Name, Code, Option, Menge, Einheit, Preis, Rabatt, Steuer und Gewicht; Pakete mit Sendungsnummer, Versendet-Flag und Versanddatum, Nachnahme und Versicherung; Produkte mit Übersetzungen, Kategorien, Hersteller, Bestand, Optionen, Attributen, verwandten Produkten, Maßen und Steuer; Produktbestände, also die verkaufbaren Varianten, mit Menge, Mengen pro Lager, Preis, Sonder-, Großhandels- und Einkaufspreis und Verfügbarkeit; Kategorien und den ganzen Kategoriebaum; registrierte Kunden mit Login, E-Mail, Name, Kundengruppe, Rabatt, Newsletter-Einwilligung, Registrierungsdatum, letztem Besuch und Treuepunkten; Bestellstatus (mit email_change), Versandarten und Zahlungsarten.

Eine Bestellung finden: Die KI listet Bestellungen mit filters und order (z. B. ein Datumsfilter und -date für die neuesten zuerst), liest eine mit shoper_get_order, dann die Positionen mit shoper_list_order_products und die Sendungsnummern mit shoper_list_parcels, beide mit dem Filter order_id. Die Namen von Status, Zahlungs- und Versandarten liefern shoper_list_statuses, shoper_list_payments und shoper_list_shippings. Gastbestellungen haben keine user_id; die KI nimmt dann die E-Mail der Bestellung.

Filter: filters ist ein Objekt aus Feldbedingungen, die mit UND verknüpft werden. Ein einfacher Wert bedeutet gleich; die Operatoren sind =, !=, >, >=, <, <=, LIKE (mit %), NOT LIKE, IN und NOT IN (mit einer Liste). Verschachtelte Felder werden mit Punkten angegeben, z. B. translations.pl_PL.name.

Was er schreibt: shoper_update_product_stock ist bei der Installation aktiv. Es überschreibt die Menge einer Variante (oder die Menge pro Lager, wenn der Shop Lager nutzt) und ändert sofort, was Kunden bestellen können; deshalb bestätigt die KI Stock-ID, aktuelle und neue Menge vorher mit dir.

Bei der Installation deaktiviert: shoper_update_order_status. Status mit email_change 1 schicken dem Kunden sofort eine E-Mail, wenn eine Bestellung in sie wechselt; deshalb schaltet ein Administrator dieses Tool bewusst ein. Auch dann zeigt dir die KI die Bestellung, den aktuellen und den neuen Status und wartet auf dein Ja.

Formate: Listen antworten mit count, pages, page und list. Datumsangaben sind YYYY-MM-DD HH:MM:SS in der Zeitzone des Shops; Beträge sind Strings in der Shopwährung. Texte stehen pro Sprache unter translations (z. B. pl_PL, en_GB).

Limits: höchstens 50 Einträge pro Seite; die KI ruft mit der nächsten page erneut ab, bis page gleich pages ist. Shopers Leaky Bucket erlaubt einen Burst von etwa 10 Aufrufen und danach 2 pro Sekunde.

Häufige Fehler: 401 bedeutet einen falschen Login oder ein falsches Passwort oder eine Gruppe ohne webapi-Zugriff. 403 (insufficient_scope oder access_denied) heißt, der Administratorgruppe fehlt die Berechtigung für diesen Bereich: Erweitere sie unter Uprawnienia. 404 bei jedem Aufruf heißt meist, dass SHOPER_SHOP_HOST falsch ist. 429 heißt, das Rate-Limit ist erreicht: Warte auf Retry-After.

Der Connector legt keine Bestellungen, Produkte, Preise oder Kunden an und ändert sie nicht, erstellt keine Pakete oder Versandetiketten und löscht nichts.

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 Cursor 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.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die Shoper-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche Bestellungen sind seit Montag eingegangen, und welche davon sind noch nicht bezahlt?“
• „Zeig die Positionen und die Sendungsnummer von Bestellung 1234.“
• „Welche Produktvarianten haben 5 oder weniger Stück auf Lager?“
• „Finde die Bestellungen von [email protected] in diesem Jahr und sag mir, was sie gekauft hat.“
• „Setz den Bestand der Variante SKU-1-RED auf 20. Zeig mir vorher die aktuelle Menge.“

FAQ

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja, MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden