DHL Paket MCP mit Gemini CLI verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → DHL Paket Versand (Geschäftskunden) klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

DHL Parcel DE Shipping + Gemini

Buch DHL-Paket-Sendungen aus deiner KI auf deinem eigenen DHL-Geschäftskundenvertrag über die offizielle Parcel DE Shipping API v2: Sendungen vor dem Buchen prüfen, buchen und Sendungsnummern und Labels erhalten, Labels erneut herunterladen, Sendungen stornieren, den Tagesabschluss ausführen und die Einlieferungsliste abrufen.

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:

DHL_API_KEY, DHL_API_SECRET, DHL_GKP_USERNAME, DHL_GKP_PASSWORD

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 15 Minuten, dazu kommt die Zeit, bis DHL deine App freigibt. Du brauchst einen DHL-Geschäftskundenvertrag mit Zugang zum DHL Geschäftskundenportal (GKP) und ein Konto auf developer.dhl.com.

1. Öffne auf developer.dhl.com My Apps → Create App und füge die API Parcel DE Shipping (Post & Parcel Germany) hinzu. Sobald DHL die App freigegeben hat, kopierst du ihren API Key in DHL_API_KEY und ihr API Secret in DHL_API_SECRET.
2. Wähl im Geschäftskundenportal einen Benutzer, der Sendungen anlegen darf, und trag seinen Benutzernamen in DHL_GKP_USERNAME und sein Passwort in DHL_GKP_PASSWORD ein. Am besten nimmst du einen eigenen Systembenutzer: Benutzerverwaltung → Systembenutzer anlegen. Ein persönlicher GKP-Benutzer geht auch, aber sein Passwort läuft regelmäßig ab.
3. Installiere den Connector. Einen Schritt Authorize with Provider gibt es nicht: AnythingMCP tauscht die vier Werte gegen ein Access Token (OAuth2 Password Grant) und erneuert es selbst.
4. Schau im GKP unter Vertragsdaten nach deinen Abrechnungsnummern und probier dann dhl_parcel_de_validate_shipments mit einer Testsendung aus: DHL prüft sie wie eine echte Buchung, aber es wird nichts angelegt oder berechnet.

Abrechnungsnummer: Jede Sendung braucht eine 14-stellige billingNumber: deine 10-stellige Kundennummer (EKP), das 2-stellige Verfahren des Produkts und die 2-stellige Teilnahme (meist 01). Für DHL Paket (Verfahren 01) mit Teilnahme 01 ist das deine EKP gefolgt von 0101. Nenn der KI einmal deine EKP, dann baut sie die Nummer selbst.

Produkte: V01PAK DHL Paket (Verfahren 01), V62KP DHL Kleinpaket (62, ersetzt die Warenpost), V53WPAK DHL Paket International (53), V54EPAK DHL Europaket für Geschäftskunden in Europa (54) und V66WPI Warenpost International (66). Welche Services du dazubuchen kannst (Wunschnachbar, Wunschort oder Wunschtag, nur an namentlich genannte Person, keine Nachbarschaftszustellung, Alterssichtprüfung, Unterschrift des Empfängers, Zusatzversicherung, Nachnahme, Sperrgut, Premium, GoGreen Plus, DHL Retoure, Filialrouting), hängt vom Produkt und deinem Vertrag ab.

Was er macht:

• dhl_parcel_de_validate_shipments prüft Adressen, Produkt, Services und Abrechnungsnummer und liefert dieselben Meldungen wie eine Buchung. Es wird nichts angelegt oder berechnet.
• dhl_parcel_de_create_shipments bucht bis zu 30 Sendungen pro Aufruf und liefert zu jeder die Sendungsnummer (die Trackingnummer) mit Label, als Link oder mit includeDocs: include als Base64. DHL berechnet jede gebuchte Sendung, wenn sie nicht am selben Tag storniert wird; deshalb fragt die KI dich vor dem Buchen und prüft neue Daten vorher.
• dhl_parcel_de_get_labels lädt Labels und Zolldokumente für bis zu 30 Sendungsnummern erneut herunter.
• dhl_parcel_de_cancel_shipments storniert Sendungen, die noch nicht abgeschlossen sind, meist bis zum Ende des Tages. Eine stornierte Sendung wird nicht berechnet, und ihr Label wird ungültig.
• dhl_parcel_de_close_out führt den Tagesabschluss für einige oder alle Sendungen sofort aus, statt auf den automatischen Abschluss am Abend zu warten. Abgeschlossene Sendungen lassen sich nicht mehr stornieren.
• dhl_parcel_de_get_manifest liefert die Einlieferungsliste eines Tages: das PDF mit den abgeschlossenen Sendungen je Abrechnungsnummer und die Angabe, welche Sendung auf welchem Blatt steht.

Alle 6 Tools sind nach der Installation eingeschaltet, auch die, die Sendungen buchen, stornieren und abschließen. Soll die KI Sendungsdaten nur prüfen, schalte dhl_parcel_de_create_shipments, dhl_parcel_de_cancel_shipments und dhl_parcel_de_close_out auf der Connector-Seite ab.

Die Antwort lesen: Die Antwort enthält einen status und eine Liste items mit einem Eintrag pro Sendung, in der Reihenfolge der Anfrage. HTTP 207 heißt, dass einige Sendungen fehlgeschlagen sind: sstatus und validationMessages jedes Eintrags sagen, warum. Eine schwache Adresswarnung („Die Adresse konnte nicht geprüft werden“) bucht die Sendung trotzdem; mit mustEncode: true lehnt DHL Adressen ab, die es nicht zuordnen kann.

Sendungsverfolgung: Um eine gebuchte Sendung zu verfolgen, nimm den Connector DHL Shipment Tracking mit der Sendungsnummer.

Limits: bis zu 30 Sendungen pro Anfrage. Kommen die Aufrufe zu schnell, antwortet DHL mit 429: Warte kurz und versuche es erneut.

Häufige Fehler: 401 heißt, dass DHL die Anmeldung abgelehnt hat. Prüfe, ob DHL_API_KEY und DHL_API_SECRET zu einer freigegebenen App mit der Parcel DE Shipping API gehören und ob Benutzername und Passwort des GKP-Benutzers stimmen. Ein persönliches GKP-Passwort läuft ab und muss im Portal erneuert werden.

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 DHL Parcel DE Shipping-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Prüf, ohne zu buchen, ein DHL Paket mit 2 kg an Anna Schmidt, Hauptstraße 5, 79098 Freiburg.“
• „Buch die Sendung und gib mir die Sendungsnummer und den Link zum Label.“
• „Storniere die Sendung 00340434161234567890, der Kunde hat die Bestellung zurückgezogen.“
• „Mach den Tagesabschluss für heute und gib mir die Einlieferungsliste.“
• „Lade die Labels für diese drei Sendungsnummern noch einmal herunter.“

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