DHL Paket MCP mit Microsoft Copilot 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 + Microsoft Copilot

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

• „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

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