ManoMano MCP mit Microsoft Copilot verbinden

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

ManoMano + Microsoft Copilot

Verkaufe auf ManoMano, dem europäischen Marktplatz für Heimwerken und Garten, direkt aus einem KI-Agenten: Bestellungen mit Annahme, Versand und Erstattungen, Preise und Bestände deiner Angebote, Wettbewerbsfähigkeit gegenüber anderen Händlern, Katalogsuche per EAN, ManoFulfillment-Bestand und Kundenrechnungen. Eine Installation pro Verkäufervertrag.

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:

MANOMANO_API_KEY, MANOMANO_SELLER_CONTRACT_ID

Schritt 1 — Zugangsdaten holen

1. Melde dich in der ManoMano Toolbox unter https://toolbox.manomano.com mit einem Benutzer an, der die Rolle Admin hat.
2. Öffne Settings > API keys, klicke auf Create API key, gib dem Key einen Namen wie AnythingMCP und klicke auf Generate API key. Kopiere den Key sofort: ManoMano zeigt ihn nur einmal an. Füge ihn in MANOMANO_API_KEY ein.
3. Trage die ID deines Verkäufervertrags in MANOMANO_SELLER_CONTRACT_ID ein. Sie ist eine Zahl, die die Toolbox anzeigt, zum Beispiel 110841.
4. Installiere den Connector und starte mit manomano_list_orders.

Eine Installation pro Vertrag: ManoMano legt pro Plattform (manomano.fr, .es, .it, .de und .co.uk) und Versandart einen eigenen Verkäufervertrag an. Wer auf mehreren Plattformen verkauft, hat also mehrere Verträge. Installiere den Connector einmal pro Vertrag und benenne jede Installation danach, zum Beispiel ManoMano FR. Die Vertrags-ID wird jedem Aufruf mitgegeben, und der Key geht nur an ManoMano.

Ablauf einer Bestellung: Eine neue Bestellung steht auf PENDING. Nimmst du sie an, wechselt sie auf PREPARATION; lehnst du sie ab, bekommt der Kunde sein Geld zurück (REFUNDING, dann REFUSED). Beim Versand werden Versanddienstleister, Sendungsnummer und Tracking-URL sowie die Produkte im Paket gemeldet, einmal pro Paket, und die Bestellung steht danach auf SHIPPED. Eine Erstattung umfasst einzelne oder alle Produkte (REFUNDING, dann REFUNDED). Für die tägliche Aufgabenliste listet die KI die Bestellungen in PENDING und PREPARATION auf. Vor Versand oder Erstattung liest sie die Bestellung, denn beides braucht die seller_sku und die Menge jedes Produkts.

Erst bestätigen: Bestellungen annehmen, ablehnen, versenden und erstatten, Angebote ändern, freigeben und ersetzen sowie Rechnungen hochladen wirkt direkt auf dem Marktplatz. Vor jedem dieser Schritte zeigt dir die KI, was sich ändert (Bestellung, Produkte und Mengen, Sendungsnummer, SKUs mit altem und neuem Preis oder Bestand, das Dokument), und wartet auf dein Ja. Ablehnungen und Erstattungen lassen sich nicht rückgängig machen.

Preise und Bestände: manomano_update_offers ändert Preis, Bestand oder beides bei bestehenden SKUs. Standardmäßig werden die neuen Werte eingefroren, damit spätere Importe deines Produkt-Feeds sie nicht mehr überschreiben, bis manomano_unfreeze_offers sie wieder an den Feed übergibt. ManoMano verarbeitet die Änderung im Hintergrund: Die KI prüft sie mit manomano_list_offers und der zurückgegebenen request_id (IN PROGRESS, ERROR mit den Fehlern oder COMPLETED). manomano_upsert_offers, das Angebote anlegt oder komplett ersetzt, ist bei der Installation ausgeschaltet.

Wettbewerb, Katalog und Fulfillment: Vergleiche ausgewählte SKUs mit dem besten Angebot zum Produkt oder liste alle Angebote auf, deren Wettbewerbslage sich in einem Zeitraum geändert hat. Prüfe bis zu 200 EANs auf einmal, ob ein Produkt schon im ManoMano-Katalog steht und ob du ein Angebot darauf veröffentlichen kannst. Den Lagerbestand bei ManoFulfillment gibt es nur bei einem ManoFulfillment-Vertrag.

Kundenrechnungen: Die KI listet die Rechnungen auf, auf die Kunden warten, die älteste Anfrage zuerst. Du hast nach dem Versand 3 Werktage Zeit, eine Rechnung bereitzustellen. Die KI lädt das PDF von einer URL hoch; jedes Dokument kommt zu den bisherigen hinzu, und der Kunde wird benachrichtigt.

Limits: etwa 250 Anfragen pro Stunde an die Bestell-API und 200 an die Angebots-API, je API-Key; darüber antwortet ManoMano mit 429. Bestellungen kommen in Seiten zu höchstens 50. Der Connector arbeitet mit der Live-API, nicht mit der Sandbox von ManoMano.

Häufige Fehler: 401 heißt, ManoMano hat den Key abgelehnt: Prüfe ihn oder erstelle in der Toolbox einen neuen (ein gelöschter Key funktioniert sofort nicht mehr). 403: Der Key funktioniert, darf aber nicht auf diesen Vertrag zugreifen; prüfe, ob die Vertrags-ID zu dem Verkäuferkonto gehört, das den Key erstellt hat. 400: Prüfe, ob die Vertrags-ID deine numerische Verkäufervertrags-ID ist. 429: zu viele Anfragen; warte, bevor du es erneut versuchst.

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 ManoMano-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 ManoMano-Bestellungen sind noch offen, und welche Bestellungen in Vorbereitung sind älter als zwei Tage?“
• „Versende die Bestellung M240915123 mit DHL, Sendungsnummer 00340434161234567890, alle Produkte in einem Paket.“
• „Setz den Preis der SKU DRILL-18V auf 89,90 Euro und den Bestand auf 25, und prüf danach, ob die Änderung durchgegangen ist.“
• „Bin ich bei diesen fünf SKUs das beste Angebot auf ManoMano? Zeig mir, wer mich unterbietet und zu welchem Preis.“

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