Falabella MCP mit Microsoft Copilot verbinden

💡 Keine Installation? Nutze direkt cloud.anythingmcp.com. Melde dich an, klicke auf Connectors → Falabella Seller Center, füge deine Zugangsdaten ein, erzeuge einen MCP-API-Key und fertig. Kein Docker, kein git clone, kein lokaler Server.

Falabella Seller Center + Microsoft Copilot

Lass deine KI deinen falabella.com-Shop in Chile, Kolumbien oder Peru über Falabella Seller Center betreiben: Produkte, Bestand pro Lager, Marken, Kategorien und ihre Attribute, Bestellungen und ihre Positionen, Versandetiketten und Feed-Ergebnisse sowie das Anlegen von Produkten und das Ändern von Preisen, Bestand und Bildern.

Voraussetzungen

Die vollständige Einrichtungsanleitung ist im Connector enthalten (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:

FALABELLA_USER_ID, FALABELLA_API_KEY, FALABELLA_SELLER_ID, FALABELLA_BUSINESS_UNIT

Schritt 1 — Zugangsdaten besorgen

Die Einrichtung dauert etwa 5 Minuten. Du brauchst ein Verkäuferkonto im Falabella Seller Center, einen Seller-Center-Benutzer mit API-Rolle, den API-Key dieses Benutzers und deine Seller ID.

Es gibt keine Sandbox: Jeder Aufruf, auch schreibende, wirkt auf deinen Live-Shop.

1. Melde dich unter sellercenter.falabella.com mit dem Benutzer an, als der der Connector handeln soll. Ein Administrator kann unter Mi cuenta → Usuarios → Agregar Usuario einen eigenen Benutzer anlegen.
2. Öffne Mi cuenta → Usuarios. Trage die E-Mail-Adresse des Benutzers in FALABELLA_USER_ID ein und den Wert aus der Spalte API Key dieser Zeile in FALABELLA_API_KEY.
3. Weise dem Benutzer eine API-Rolle zu: Seller API Access (alle Methoden), Seller API Product Access (Produkte, Marken, Kategorien, Bilder und Feeds) oder Seller API Order Access (Bestellungen). Eine Methode außerhalb der Rolle antwortet mit E009: Access Denied.
4. Kopiere deine Seller ID, die unter Mi cuenta angezeigt wird, in FALABELLA_SELLER_ID.
5. Setze FALABELLA_BUSINESS_UNIT auf dein Land: FACL Chile, FACO Kolumbien, FAPE Peru. Ein Connector bedient ein Land; für ein weiteres Land fügst du einen zweiten Connector hinzu.
6. Installiere den Connector. Führe falabella_seller_center_feed_count aus, um die Verbindung zu prüfen: Es ist ein leichter Aufruf.

So wird signiert: Jede Anfrage wird mit HMAC-SHA256 signiert, mit deinem API-Key als Schlüssel. Der Key selbst wird nie gesendet. Eine Anfrage, deren Zeitstempel zu stark abweicht, wird abgelehnt (E003).

Cloud und self-hosted funktionieren gleich: Die Zugangsdaten sind dieselben, und es muss keine Redirect-URL gesetzt werden.

Wo du anfängst: falabella_seller_center_get_products listet Produkte mit Filtern für Status, Suche, SKUs und Datum. falabella_seller_center_get_stock zeigt den Bestand pro Lager, einschließlich Fulfillment by Falabella. Für Bestellungen gibt es falabella_seller_center_get_orders und falabella_seller_center_get_order_items, die die OrderItemId und PackageId liefern, die Etiketten und Statusänderungen benötigen. falabella_seller_center_get_document liefert das Versandetikett.

Neue Produkte: Finde die Kategorie mit falabella_seller_center_get_category_suggestion anhand eines Titels oder in falabella_seller_center_get_category_tree (Produkte kommen nur in Blattkategorien). Lies ihre Attribute mit falabella_seller_center_get_category_attributes und den exakten Markennamen mit falabella_seller_center_get_brands. Lege dann die Produkte mit falabella_seller_center_create_products an und füge Bilder mit falabella_seller_center_set_images hinzu.

Schreibvorgänge sind Feeds: Das Anlegen, Aktualisieren, Bepreisen, Bestandsführen, Bebildern und Entfernen von Produkten läuft asynchron. Eine erfolgreiche Antwort bedeutet nur, dass die Anfrage akzeptiert wurde. falabella_seller_center_feed_status zeigt das Ergebnis: Warte, bis Status Finished, Error oder Canceled ist, und lies dann FailedRecords und FeedErrors, denn ein Feed kann abgeschlossen werden, obwohl einige Datensätze abgelehnt wurden. Falabella erlaubt 50 Feed-Aufrufe frei, danach einen alle 2 Minuten pro Verkäufer, daher packt die KI mehrere Produkte in eine Anfrage statt einen Aufruf pro SKU.

Ländercodes: Die Business Unit steht in Großbuchstaben (FACL). Im Produkt-XML ist dasselbe Land der OperatorCode in Kleinbuchstaben: facl, faco, fape.

Bei der Installation ausgeschaltet: falabella_seller_center_remove_products (Produkte entfernen), falabella_seller_center_set_status_ready_to_ship (Bestellpositionen als versandbereit markieren) und falabella_seller_center_set_status_canceled (eine Bestellposition stornieren). Schalte sie auf der Connector-Seite ein, wenn die KI sie verwenden soll; die KI bittet dich, jeden Aufruf zu bestätigen. Das Anlegen und Aktualisieren von Produkten sowie das Ändern von Preisen, Bestand und Bildern ist eingeschaltet (falabella_seller_center_create_products, falabella_seller_center_update_products, falabella_seller_center_update_price, falabella_seller_center_update_stock, falabella_seller_center_update_stock_xml, falabella_seller_center_set_images).

Formate: Datumsfilter sind ISO 8601 (2026-11-01T00:00:00+00:00). Preise verwenden einen Punkt als Dezimaltrennzeichen. ID-Listen stehen in eckigen Klammern: [123456,123457]. Ein Update ändert nur die Elemente, die es enthält.

Häufige Fehler: E007 bedeutet, dass die Signatur nicht übereinstimmte: Der API-Key muss zum Benutzer in FALABELLA_USER_ID gehören (gleiche Zeile unter Mi cuenta → Usuarios) und vollständig kopiert sein. E009 bedeutet, dass die Rolle des Benutzers diese Methode nicht abdeckt. E429 bedeutet, dass das Feed-Limit erreicht wurde: Warte und versuche es erneut. Falabella meldet Ablehnungen mit HTTP 200; der Connector meldet sie als fehlgeschlagene Aufrufe.

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 Anleitung YOUR_SERVER_ID zeigt.

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.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. 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.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Falabella Seller Center-Tools braucht.
6. 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

Beispiel-Prompts

• „Welche Bestellungen sind heute eingegangen, und welche Positionen müssen noch versendet werden?"
• „Zeige den Bestand von SKU ZAP-RUN-42 in jedem Lager."
• „Wurde mein letzter Feed abgeschlossen? Liste alle abgelehnten Datensätze und die Gründe auf."
• „Ändere den Preis von SKU ZAP-RUN-42 auf 49990 mit einem Angebotspreis von 39990 bis Monatsende."
• „Schlage eine Kategorie für ‚Zapatillas running hombre' vor und liste ihre Pflichtattribute auf."

FAQ

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

• Connector-Landingpage
• Mit Claude verbinden