Zusammenfassung
Spartoo-Marktplatz-Webdienste für Verkäufer: Bestellungen mit Kunden- und Lieferdetails, Annahme und Versand von Bestellungen mit einer Sendungsverfolgungsnummer, Rücksendungen, der Status eines Produkts auf der Seite und Bestandsaktualisierungen pro Größe. Partnercode als Formularfeld, XML-Antworten werden als JSON gelesen.
Geführte Einrichtung
Spartoo Marketplace in 2 Minuten mit Microsoft Copilot verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Spartoo Marketplace in der geführten Einrichtung und trag deine MCP-URL in Microsoft Copilot ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
Frag einfach
Beispiel-Prompts für Spartoo Marketplace
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 → Spartoo Marketplace, füge deine Zugangsdaten ein, erstelle einen MCP-API-Schlüssel und du bist fertig. Kein Docker, kein
git clone, kein lokaler Server.
Spartoo Marketplace + Microsoft Copilot
Spartoo-Marktplatz-Webdienste für Verkäufer: Bestellungen mit Kunden- und Lieferdetails, Annahme und Versand von Bestellungen mit einer Sendungsverfolgungsnummer, Rücksendungen, der Status eines Produkts auf der Seite und Bestandsaktualisierungen pro Größe. Partnercode als Formularfeld, XML-Antworten werden als JSON gelesen.
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:
SPARTOO_HOST, SPARTOO_PARTNER_KEY
Schritt 1 — Zugangsdaten erhalten
Die Einrichtung dauert etwa 3 Minuten.
- Melde dich im Spartoo-Marktplatz-Backoffice an und öffne Dokumentation, dann Webservices und eine beliebige Dienstseite, z.B. Bestellungen exportieren.
- Die Zeile Webservice-URL nennt die Webdienstadresse deiner Spartoo-Seite, z.B.
https://sws.spartoo.euoderhttps://sws.spartoo.it. Setze den Teil vor/mp/inSPARTOO_HOST. - Auf derselben Seite zeigt die Zeile
partnerdeinen einzigartigen Code, wenn du angemeldet bist. Setze ihn inSPARTOO_PARTNER_KEY. Wenn die Seite keinen Code anzeigt, frage deinen Spartoo-Marktplatzkontakt nach dem Webservice-Code deines Kontos.
Wo anfangen: spartoo_list_orders mit einem Startdatum. spartoo_get_order liest eine Bestellung anhand ihrer ID.
Bestellungen: Eine Bestellung kommt im Status 11 (verifiziert) an. spartoo_accept_order verschiebt sie auf 2 (in Vorbereitung): danach können Name, Adresse und Versanddienstleister nicht mehr geändert werden. spartoo_ship_order verschiebt sie von 2 auf 3 (versendet) mit der Sendungsverfolgungsnummer des Versanddienstleisters, und Spartoo sendet den Tracking-Link an den Kunden. spartoo_cancel_order (Status 41) ist standardmäßig deaktiviert: der Kunde erhält eine Rückerstattung und es kann nicht rückgängig gemacht werden. Die Status 45 (Paket verloren) und 47 (Paket nicht zugestellt) werden von Spartoo gesetzt.
Rücksendungen: spartoo_list_returns und spartoo_get_return. Eine Rücksendung enthält ein Produkt. Rücksendestatus: 2 wartet auf Empfang, 3 abgelehnt, 4 Paket empfangen und Rücksendung akzeptiert, 5 bezahlt, 7 Rückerstattung, 14 wartet auf das vorausbezahlte Rücksendeetikett des Händlers. Dieser Connector akzeptiert oder lehnt Rücksendungen nicht ab.
Produkte und Bestand: spartoo_check_product_status sagt, ob ein Produkt auf der Seite ist (OK), nicht auf Lager (OS), erstellt, aber noch nicht online (EC) oder unbekannt (KO), mit dem Grund. spartoo_update_stock setzt den Bestand einer Größe. Beide verwenden deine eigenen Referenzen: reference_partenaire ist das Produkt in einer Farbe, size_reference eine Größe davon. Bestand 0 entfernt die Größe von der Seite.
Hinweise
- Bestell-IDs und Rücksende-IDs sind kurze Codes wie
90D813EA1A2365A8. - Der Bestelldatumsfilter wird als
YYYY-MM-DD:hh:mm:ssmit einem Doppelpunkt zwischen Tag und Stunde geschrieben. Der Rücksendungsdatumsfilter ist ein Unix-Zeitstempel in Sekunden. Spartoo dokumentiert die Zeitzone nicht. - Preise sind Dezimalzahlen in der Währung der Bestellseite;
products_final_priceist der rabattierte Stückpreis multipliziert mit der Menge. - Eine Bestellung für einen Abholpunkt hat
relay_infoanstelle der Lieferadresse. - Textwerte kommen als Strings, Zahlen eingeschlossen. Eine Bestellung oder ein Produkt in einer Liste kommt als Objekt, mehrere als Array.
Fehler: Jede Antwort trägt einen Code. 1 bedeutet keinen Fehler. -1 und -2: der Partnercode fehlt oder ist unbekannt. -3: Datum oder ID fehlt. -4: falsches Datumsformat. -6 und -28: Bestellung oder Rücksendung nicht gefunden. -8: Sendungsverfolgungsnummer abgelehnt. -9: die Bestellung hat bereits diesen Status. -19: falsche Reihenfolge der Status (2 nur von 11, 3 nur von 2). -14: Produkt nicht gefunden. -16, -18 und -20: Bestand nicht geändert (nicht möglich, bereits dieser Wert oder die Größe ist nicht mehr gültig). -30: Bestellung zu alt zum Versenden, kontaktiere Spartoo. -428: Konto deaktiviert. -429: zu viele Anfragen in einer Stunde. Der Connector meldet einen negativen Code als fehlgeschlagenen Aufruf.
Nicht abgedeckt: Erstellen und Bearbeiten von Produkten, Preisen und Rabatten (diese erfolgen über eine XML-Katalogdatei), Packzettel und Rücksendungsentscheidungen.
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 Microsoft Copilot 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.
Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.
- Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
- Trag einen Server name ein (zum Beispiel
AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft. - Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf
X-API-Keyund klicke auf Create. - Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
- Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die
Spartoo Marketplace-Tools braucht. - Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.
Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.
Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.
Verfügbare Tools
| Tool | Was es tut |
|---|---|
spartoo_list_orders | Listet die seit einem Datum aufgegebenen Bestellungen auf, optional nur die in einem Status. Pro Bestellung unter root.orders.order: orders_id, customers… |
spartoo_get_order | Liest eine Bestellung anhand ihrer ID: Kunden- und Lieferdetails (oder den Abholpunkt in relay_info), Zahlungsmethode, Versandname und Preis, Bestellung… |
spartoo_accept_order | Akzeptiert eine neue Bestellung: verschiebt sie von Status 11 (verifiziert) auf 2 (in Vorbereitung). Danach können Name, Lieferadresse und Versanddienstleister der Bestellung… |
spartoo_ship_order | Markiert eine akzeptierte Bestellung als versendet mit der Sendungsverfolgungsnummer des Versanddienstleisters: verschiebt sie von Status 2 auf 3, und Spartoo sendet den Tracking-Link an… |
spartoo_cancel_order | Storniert eine Bestellung, die nicht versendet wurde (Status 41). Der Kunde erhält die Bestellung nicht und wird von Spartoo erstattet; es kann nicht rückgängig gemacht werden… |
spartoo_list_returns | Listet die seit einem Zeitpunkt registrierten Rücksendungen auf, optional nur die in einem Status. Pro Rücksendung unter root.returns.return: return_id… |
spartoo_get_return | Liest die Rücksendungen einer Bestellung oder eine Rücksendung anhand ihrer ID: Rücksendungs-ID und -datum, Status-ID und -name, Grund, Bestell-ID und das zurückgegebene Produkt… |
spartoo_check_product_status | Überprüft, ob eines deiner Produkte auf der Spartoo-Seite ist. Gibt unter root.products.product deine Referenz, einen Status (OK auf der Seite… |
spartoo_update_stock | Setzt den Bestand einer Größe eines Produkts in Echtzeit. Bestand 0 entfernt diese Größe von der Seite; ein Produkt, dessen Größen alle 0 sind, geht offline.… |
Beispielaufforderungen
- "Welche Spartoo-Bestellungen sind seit Montag eingegangen und müssen noch akzeptiert werden?"
- "Akzeptiere die Bestellung 90D813EA1A2365A8 und versende sie mit Royal Mail Tracking AB123456789GB."
- "Welche Rücksendungen warten auf Empfang?"
- "Ist mein Produkt REF-BOOT-221 online, und wenn nicht, warum?"
- "Setze den Bestand der Größe 38 von REF-BOOT-221 auf 6."
FAQ
Woher kommt der Partnercode? Im Spartoo-Marktplatz-Backoffice, Dokumentation, Webservices, eine beliebige Dienstseite: die Zeile Partner zeigt deinen Code und die Zeile Webservice-URL nennt die Adresse deiner Seite. Wenn kein Code angezeigt wird, frage deinen Spartoo-Marktplatzkontakt.
Was deckt es ab und was nicht? Bestellungen mit Kunden- und Lieferdetails, Annahme und Versand mit einer Sendungsverfolgungsnummer, Rücksendungen, Produktstatus und Bestand pro Größe. Es akzeptiert oder lehnt Rücksendungen nicht ab. Um den Spartoo-Katalog als Käufer zu durchsuchen, verwende den Spartoo Shop-Connector.
Welche Tools sind standardmäßig deaktiviert? spartoo_cancel_order, da eine Stornierung den Kunden erstattet und nicht rückgängig gemacht werden kann. Schalte es nur auf der Connector-Seite ein, wenn die KI es verwenden soll.
Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.
Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.
Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.
Nächste Schritte
War dieser Guide hilfreich?