QLS über MCP mit Gemini 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 + Gemini

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

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die QLS-Tools aufrufen.

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

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden