bol.com MCP mit Microsoft Copilot verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → bol.com, füge deine Zugangsdaten ein, mint einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein git clone, kein lokaler Server.

bol.com + Microsoft Copilot

bol.com Retailer API für Verkäufer auf dem niederländischen und belgischen Marktplatz: Bestellungen, Sendungen mit Sendungsverfolgung, Rücksendungen, FBB-Inventar, Angebote mit Preis und Lagerbestand, Provision, Kataloginhalt, konkurrierende Angebote, Bewertungen, Rechnungen und Leistungsindikatoren. Client-ID und Geheimnis.

Voraussetzungen

Siehe die vollständigen Einrichtungsanweisungen, die im Connector eingebaut sind (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:

BOL_CLIENT_ID, BOL_CLIENT_SECRET

Schritt 1 — Zugangsdaten erhalten

Die Einrichtung dauert etwa 3 Minuten. Du benötigst ein bol.com Verkäuferkonto (Verkaufen über bol) und Zugriff auf die API-Einstellungen im bol Seller Dashboard. Der Connector benötigt eine Client-ID und ein Client-Geheimnis für die Retailer API.

1. Öffne im bol Seller Dashboard dein Konto, dann Instellingen → Diensten → API Instellingen (Einstellungen, Dienste, API-Einstellungen). Speichere einen technischen Kontakt, falls bol danach fragt.
2. Klicke unter Client credentials voor de Retailer API auf Aanmaken (Erstellen), gib dem Schlüssel einen Namen und klicke auf Toon secret (Geheimnis anzeigen).
3. Kopiere die Client-ID in BOL_CLIENT_ID und das Geheimnis in BOL_CLIENT_SECRET. Wenn das Geheimnis verloren geht, erstelle neue Zugangsdaten.
4. Installiere den Connector. Führe bol_com_list_orders aus, um die Verbindung zu überprüfen: es gibt deine offenen Bestellungen zurück, die du selbst versendest (FBR).

Cloud und self-hosted funktionieren gleich: die Zugangsdaten sind dieselben, und es gibt keine Umleitungs-URL oder IP-Adresse, die registriert werden muss.

Authentifizierung: der Connector tauscht die Client-ID und das Geheimnis bei https://login.bol.com/token (Client-Zugangsdaten) gegen ein Bearer-Token aus, das etwa 5 Minuten hält, und verwendet es, bis es abläuft. Es fragt nie bei jedem Aufruf nach einem neuen Token, da bol Adressen blockiert, die seinen Anmeldedienst überlasten.

Wo anfangen: bol_com_list_orders listet offene FBR-Bestellungen, die neuesten zuerst; bol_com_get_order fügt die Versand- und Rechnungsdetails des Kunden sowie die Artikel hinzu. bol_com_list_offers listet deine Angebote und bol_com_list_inventory zeigt den Lagerbestand, den bol für dich in seinen Lagern hält (FBB).

Was es liest: Bestellungen, Sendungen mit Transport und Sendungsverfolgung, Rücksendungen mit Gründen und Kundenkommentaren, FBB-Lagerbestand, Angebote mit Preis, Lagerbestand und Verfügbarkeit im Land, warum ein Angebot nicht zum Verkauf steht, Provision für ein Produkt zu einem Preis, bol Kataloginhalt nach EAN, konkurrierende Angebote und wer die Kaufbox hat, Sternebewertungen, Besuche und Kaufbox-Prozentsatz pro Angebot, Verkäuferleistungsindikatoren pro Woche und Rechnungen (nur lesbar).

Versand: bol_com_create_shipment bestätigt den Versand von Artikeln, die du selbst versendest, mit deinem Versanddienstleister und Sendungsverfolgungscode. bol_com_add_track_and_trace fügt einen fehlenden Code zu einer Sendung hinzu; er kann einen bestehenden nicht ändern.

Angebote: bol_com_create_offer und bol_com_update_offer erstellen Angebote und ändern Preis, Lagerbestand, Erfüllung, Länder oder das On-Hold-Flag. Ein Update ändert nur die angegebenen Felder, aber ein Array (Bundle-Preise, Länder) ersetzt das alte vollständig. Ein 409 bedeutet, dass jemand das Angebot zur gleichen Zeit geändert hat. Preise sind in EUR inklusive MwSt., und der Lagerbestand liegt zwischen 0 und 999.

Bei der Installation deaktiviert: bol_com_cancel_order_item (storniere einen Bestellartikel, den du nicht liefern kannst) und bol_com_delete_offer (lösche ein Angebot). Eine Stornierung kann nicht rückgängig gemacht werden und zählt gegen deinen Verkäufer-Score, und ein gelöschtes Angebot verschwindet sofort von bol und kann nicht wiederhergestellt werden. Um ein Angebot zu pausieren, setze es stattdessen mit bol_com_update_offer auf Hold. Schalte sie auf der Connector-Seite nur ein, wenn die KI sie verwenden soll; die KI fragt dich, jede Änderung zu bestätigen. Sendungen, Sendungsverfolgung und das Erstellen und Aktualisieren von Angeboten sind aktiviert.

Asynchrone Schreibvorgänge: Sendungen, Transporte und Stornierungen antworten mit einem Prozessstatus anstelle eines Ergebnisses. bol_com_get_process_status (oder bol_com_find_process_statuses nach Entität und Ereignistyp) zeigt, wann es SUCCESS oder FAILURE ist. bol speichert Prozessstatus für einen Tag. Angebote sind synchron.

Paging: Bestell-, Versand-, Rückgabe- und Inventarlisten nehmen page von 1 mit 50 Zeilen pro Seite; eine leere Antwort bedeutet, dass es keine weiteren Seiten gibt. Angebote verwenden einen Cursor: übergebe page.nextCursor zurück, bis er fehlt.

Rate Limits: bol legt sie pro Endpunkt fest. Die Bestellliste und die Versandliste erlauben 25 Aufrufe pro Minute, Rücksendungen und Inventar 20 pro Minute, Rechnungen 24 pro Minute; Bestelldetails 25 pro Sekunde und Angebote 25 bis 50 pro Sekunde. Ein 429 enthält einen Retry-After in Sekunden; die aktuellen Werte findest du unter api.bol.com/retailer/public/ratelimits.

IDs und Formate: Bestell-IDs können Buchstaben enthalten (A4K8290LP0), EANs sind Strings, Daten sind YYYY-MM-DD und Zeiten ISO 8601 mit einem Offset. Unbenutzte Felder werden weggelassen, da bol auf leere Strings mit 400 antwortet.

Häufige Fehler: Fehler kommen als application/problem+json mit title, detail und violations, die das Feld benennen. 400 bedeutet normalerweise, dass ein Feld fehlt oder leer ist. 429 ist das Rate Limit: warte auf die Retry-After-Zeit.

Nicht abgedeckt: Bearbeitung oder Registrierung von Rücksendungen (die Annahme einer Rücksendung führt dazu, dass bol dem Kunden das Geld zurückerstattet), Kauf von Versandetiketten und alles, was Geld bewegt.

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 bol.com-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

Beispielaufforderungen

• "Welche offenen Bestellungen müssen heute noch versendet werden, und gibt es Stornierungsanfragen?"
• "Zeige die Bestellung A4K8290LP0 mit der Adresse des Kunden und den Artikeln."
• "Welche meiner Angebote sind nicht zum Verkauf, und warum?"
• "Wer hat die Kaufbox für EAN 8712345678901, und zu welchem Preis?"
• "Setze den Preis meines Angebots für EAN 8712345678901 auf 24,95 und den Lagerbestand auf 40."

FAQ

Kann es Rücksendungen bearbeiten oder Bestellungen stornieren? Es liest Rücksendungen, bearbeitet oder registriert sie jedoch nicht, da die Annahme einer Rücksendung dazu führt, dass bol dem Kunden das Geld zurückerstattet. Das Stornieren eines Bestellartikels ist mit bol_com_cancel_order_item möglich, das bei der Installation deaktiviert ist.

Funktioniert es für belgische und niederländische Verkäufe? Ja. Ein Verkäuferkonto deckt beide Länder ab; Angebote tragen ihre Verfügbarkeiten im Land, und bol_com_get_offer_not_for_sale_reasons erklärt pro Land, warum ein Angebot nicht zum Verkauf steht.

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