Fruugo über MCP mit Microsoft Copilot 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 + Microsoft Copilot

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 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 Fruugo-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 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

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-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden