QLS über MCP mit Microsoft Copilot verbinden

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

QLS + Microsoft Copilot

Pakketdienst QLS (Niederlande): Paketsendungen mit Labels und Tracking, Versandprodukte und Paketshops, Fulfilment-Aufträge aus dem QLS-Lager, Fulfilment-Artikel und Bestand, Rückstände, Retouren und angekündigte Wareneingänge. Artikel löschen und Aufträge stornieren sind bei der Installation aus.

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:

QLS_USERNAME, QLS_PASSWORD

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 5 Minuten. Du brauchst ein Konto auf mijn.pakketdienstqls.nl.

1. QLS authentifiziert die API mit HTTP Basic und den Zugangsdaten des Portals mijn.pakketdienstqls.nl. Wenn dein Konto es zulässt, nimm für die API einen eigenen Benutzer (frag den IT-Support von QLS unter [email protected]), damit eine Passwortänderung einer Person den Connector nicht lahmlegt.
2. Trag den Benutzernamen (meist eine E-Mail-Adresse) in QLS_USERNAME und das Passwort in QLS_PASSWORD ein.
3. Installiere den Connector und rufe qls_list_companies auf. Es liefert die Firmen-ID (eine UUID), die jedes andere Tool als company_id braucht; qls_get_company zeigt eine Firma.

Welche API: die QLS Fulfilment and Parcel Service API auf https://api.pakketdienstqls.nl (OpenAPI unter https://api.pakketdienstqls.nl/swagger/). QLS veröffentlicht eine v1 und eine v2; der Connector nutzt v2, wo QLS sie anbietet (Sendungen anlegen, Retouren, Wareneingänge), und v1 für den Rest.

IDs, die du zuerst brauchst: die Firmen-ID aus qls_list_companies; die Marken-ID aus qls_list_brands (eine Marke trägt Absender-, Retouren- und Zolladresse und wird für Sendungen und Aufträge gebraucht); die Versandprodukte aus qls_list_shipping_products, mit combinations[].id als product_combination_id, options[].tag als Zustelloptionen, Preisen pro Land und Gewichtsstufe und Maximalmaßen. Paketshops liefert qls_list_service_points oder, für ein einzelnes Versandprodukt, qls_list_product_service_points; ihr servicepoint_code kommt auf Sendung oder Auftrag.

Was er liest: Paketsendungen mit Status (created, printed, pre_transit, in_transit, delivered, returned_to_sender), Barcode, Tracking-ID und Tracking-URL, gefiltert nach Referenz, Barcode, Status, Marke, Empfängerfeldern, Datum oder freier Suche; eine Sendung mit Gewicht und, mit with_label, den Label-URLs als PDF und ZPL; die Retourensendung eines Pakets; Fulfilment-Aufträge mit Status, bestellten, reservierten und gelieferten Mengen, Empfänger, Lieferungen und den Sendungen, die das Lager verlassen haben; Fulfilment-Artikel mit EAN, SKU, Artikelnummer, Preisen, Bestandssummen und Lagerplätzen (Zone, Regal, Fach, Mindesthaltbarkeit); Bestand pro Artikel (gesamt, reserviert, verfügbar, verkaufbar, verkauft, Rückstand, im Zulauf, Prognose) und pro Lagerplatz mit Charge; Rückstände; Retouren mit Status, Verbraucher, ursprünglicher Sendung und Auftrag und den zurückgeschickten Artikeln mit Grund; Wareneingänge (Purchase Orders) mit Status, Artikeln, Lieferanten und Anlieferungen, auch die unterwegs; Lieferanten.

Was er schreibt: qls_create_shipment bucht ein Paket beim Carrier und liefert Barcode, Tracking-URL und label_pdf_url; Absender- und Retourenadresse kommen standardmäßig von der Marke. qls_create_fulfillment_order lässt QLS Artikel aus deinem Bestand kommissionieren, verpacken und versenden. qls_update_fulfillment_order setzt einen Auftrag auf Halt, gibt ihn frei oder ändert Bearbeitungsdatum, Referenz, Bemerkungen oder Paketshop. qls_create_fulfillment_product und qls_update_fulfillment_product pflegen Artikel; qls_create_return_from_order meldet eine Retoure an; qls_create_purchase_order kündigt Ware für das Lager an. Eine Sendung kostet Geld und ein Fulfilment-Auftrag verschickt echten Bestand, deshalb zeigt die KI vor jedem Schreibzugriff Empfänger, Artikel und Mengen sowie das Versandprodukt und wartet auf dein Ja.

Bei der Installation deaktiviert: qls_delete_fulfillment_product und qls_cancel_fulfillment_order, die sich nicht rückgängig machen lassen. Ein Administrator schaltet sie ein, wenn das Team sie braucht.

Datenformate: Jede Antwort ist verpackt als {"meta": {"code": 200}, "errors": [], "data": ..., "pagination": ...}; die Daten stehen unter data. Gewichte sind in Gramm, Preise und Nachnahme in Euro, Maße in Millimetern. IDs von Firmen, Marken, Aufträgen, Artikeln und Sendungen sind UUID-Strings; IDs von Versandprodukten und Kombinationen sind Ganzzahlen. Status von Fulfilment-Aufträgen: error_validation, concept, received, pending, partically_sent (Schreibweise von QLS) und sent. Datumsfilter für Bestand und Wareneingänge nehmen d-m-Y H:i (z. B. 1-10-2026 00:00), die übrigen ein Datum oder Datum mit Uhrzeit wie 2026-10-01 00:00:00.

Paging: Listen liefern bis zu 100 Einträge pro Seite. pagination enthält page, pageCount, count und nextPage; die KI ruft die nächste page ab, solange nextPage true ist.

Häufige Fehler: 401 heißt, Benutzername oder Passwort sind falsch: Es sind die Zugangsdaten von mijn.pakketdienstqls.nl. 404 (Niet Gevonden) heißt, die ID ist unbekannt oder die Firmen-ID gehört nicht dir: Nimm IDs aus den Listen-Tools. 422 oder eine gefüllte errors-Liste ist ein Validierungsproblem; QLS antwortet auf Niederländisch.

Der Connector storniert keine Paketsendungen, liest keine QLS-Rechnungen und ändert weder Marken noch Firmeneinstellungen: Dafür gibt es keine Tools.

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 QLS-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 QLS-Versandprodukte können wir für die Niederlande und Belgien nutzen, mit Preis pro Gewichtsstufe?“
• „Such die DHL-Paketshops in der Nähe der Postleitzahl 3011 AB.“
• „Leg ein PostNL-Paket für Bestellung 1042 an Jan de Vries in Rotterdam mit 1.200 Gramm an. Zeig mir vorher Empfänger, Produkt und Gewicht.“
• „Welche Fulfilment-Artikel haben weniger als 20 Stück verfügbar, und was ist im Zulauf?“
• „Liste die Fulfilment-Aufträge dieser Woche, die noch pending oder partically_sent sind.“

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