Fruugo über MCP mit Meta Muse verbinden

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

Fruugo + Meta Muse

Verkaufe auf dem Marktplatz Fruugo aus einem KI-Agent: Bestellungen mit Positionen, Kundenpreisen, Lieferadresse und Sendungen abrufen und Verfügbarkeit und Bestand deiner SKUs lesen. Bestellungen bestätigen und als versendet melden ist enthalten, bei der Installation aber deaktiviert.

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:

FRUUGO_USERNAME, FRUUGO_PASSWORD

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten. Du brauchst ein Händlerkonto bei Fruugo und einen Benutzer im Fruugo Retailer Portal.

1. Melde dich im Fruugo Retailer Portal unter retailer.fruugo.com an. Fruugo empfiehlt einen eigenen Portal-Benutzer für die Integration, leg also wenn möglich einen für AnythingMCP an.
2. Trag den Benutzernamen dieses Portal-Benutzers in FRUUGO_USERNAME und sein Passwort in FRUUGO_PASSWORD ein. Fruugo prüft beides bei jedem Aufruf per HTTP Basic.
3. Installiere den Connector und rufe fruugo_download_orders mit einem from-Datum von vor ein paar Tagen auf.

Was er liest: die Bestellungen, die Fruugo nach seiner Betrugsprüfung für dich freigegeben hat, mit Bestell- und Kundenbestellnummer, Daten, Status, Sprache des Kunden, Lieferadresse und Versandart, Versandkosten, Positionen mit den Produkt- und SKU-IDs von Fruugo und deinen eigenen, deinen Preisen und den Preisen, die der Kunde in seiner Währung gesehen hat, Mehrwertsteuer, Stückzählern (offen, bestätigt, versendet, storniert, Retoure angekündigt, retourniert) und Sendungen; dazu deine aktiven SKUs mit Titel, Verfügbarkeit (INSTOCK, OUTOFSTOCK, NOTAVAILABLE) und Lagerbestand, wenn dein Feed ihn liefert. Hat Fruugo die Steuer erhoben, enthält eine Bestellung auch die Steuer-ID und EORI von Fruugo für die Zollanmeldung.

Höchstens 60 Tage pro Abfrage: Fruugo listet Bestellungen nur für ein Zeitfenster von höchstens 60 Tagen; ein längeres antwortet mit 400 Time range specified is too long. Für ein ganzes Quartal fragt die KI in zwei Teilen ab und zählt zusammen.

Bestellstatus: PENDING heißt neu und wartet auf dich, PROCESSED heißt zumindest teilweise bearbeitet, EXCEPTION heißt, dass Fruugo die Bestellung manuell bearbeitet, außerhalb der API.

Der Bestand kommt aus deinem Feed: Die Bestandsliste kommt in Seiten zu 1.000 SKUs, und die KI liest weitere Seiten nur, wenn du sie brauchst. Der Connector ändert weder Bestand noch Preise: Die kommen aus deinem Produktfeed.

Bei der Installation deaktiviert: fruugo_confirm_order und fruugo_ship_order. Sie wirken auf echte Kundenbestellungen: Das erste bestätigt eine offene Bestellung, auf Wunsch mit voraussichtlichem Versanddatum; das zweite meldet sie als versendet, mit Trackingcode und Tracking-URL oder zumindest dem Namen des Versanddienstleisters, die Fruugo an den Kunden weitergibt. Beide gehen für eine ganze Bestellung oder eine einzelne Position. Ein Administrator schaltet sie bewusst ein, und auch dann zeigt dir die KI die Bestellung und genau das, was sich ändert, und wartet auf dein Ja.

Häufige Fehler: 401 bedeutet einen falschen Benutzernamen oder ein falsches Passwort des Portals; prüf sie mit einer Anmeldung auf retailer.fruugo.com. 400 erklärt das Problem im Klartext, zum Beispiel ein Zeitfenster über 60 Tage oder eine Bestellung im falschen Zustand.

Der Connector storniert keine Bestellungen und erfasst keine Retouren, weil beides dem Kunden Geld erstattet: Das erledigst du im Retailer Portal. Angebote, Preise und Bestand ändert er ebenfalls nicht.

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

Muse bindet Remote-MCP-Server als Custom Connectors ein und meldet sich per OAuth bei ihnen an.

1. Öffne in Muse Settings → Connectors und wähle Add custom connector.
2. Füge die MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein.
3. Muse öffnet die Anmeldeseite von AnythingMCP: Melde dich an und bestätige den Zugriff.
4. Bitte Muse im Chat um etwas, wofür es die Fruugo-Tools braucht.

Du kannst den Connector auch per Chat einrichten, im Web, in den Apps für iOS und Android oder in WhatsApp. Schick Muse diese Nachricht:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Muse verbindet sich aus der Cloud von Meta, localhost funktioniert deshalb nicht.

Verfügbare Tools

Beispiel-Prompts

• „Welche Fruugo-Bestellungen der letzten zwei Wochen sind noch offen und müssen raus?“
• „Wie viele Fruugo-Bestellungen hatten wir in den letzten 30 Tagen, und in welche Länder gingen sie?“
• „Welche meiner SKUs stehen auf Fruugo gerade auf nicht vorrätig?“
• „Zeig mir die Bestellungen der letzten Woche mit dem Betrag, den der Kunde in seiner Währung gezahlt hat, und der Mehrwertsteuer pro Position.“
• „Bei welchen Bestellungen seit dem 1. September wurden Artikel storniert oder retourniert?“

FAQ

Wo ist Muse verfügbar? Meta bietet Muse derzeit in den USA und in Kanada an, im Web, in den Apps für iOS und Android und in WhatsApp.

Prüft Meta diesen Connector? Nein. Meta prüft Custom Connectors nicht. Muse sieht nur die Tools, die du in AnythingMCP für diesen MCP-Server eingeschaltet hast, und du kannst den Connector jederzeit unter Settings → Connectors trennen.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden