BEX Express über MCP mit Microsoft Copilot verbinden

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

BEX Express + Microsoft Copilot

Der Kurierdienst BEX Express (Serbien) aus einem KI-Agent: Statusverlauf einer Sendung über die Sendungsnummer, Adresslabels als PDF, das BEX-Adressverzeichnis mit Gemeinden, Orten und Straßen sowie Paketshops und Depots. Sendungen anlegen und stornieren ist enthalten, bei der Installation aber deaktiviert.

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:

BEX_API_TOKEN

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 5 Minuten, sobald BEX dir den Schlüssel geschickt hat. Du brauchst einen Vertrag mit BEX Express, dem serbischen Kurierdienst, und einen API-Schlüssel, den BEX für diesen Vertrag ausstellt.

1. Bist du noch kein BEX-Kunde, frag unter [email protected] ein Angebot an: Die API gibt es nur für Vertragskunden.
2. Schreib an [email protected], bitte um API-Zugang und nenn den Vertrag, für den er gelten soll.
3. BEX antwortet mit einem API-Schlüssel und deiner KlijentId. Füge den Schlüssel in BEX_API_TOKEN ein; er wird im Header X-AUTH-TOKEN gesendet. Heb die KlijentId gut auf: Sie kennzeichnet deine Firma als Absender einer Sendung.
4. Installiere den Connector und rufe bex_express_list_municipalities auf. Kommt die Liste der Gemeinden zurück, funktioniert der Schlüssel.

Was er liest: den Statusverlauf einer Sendung über ihre BEX-Sendungsnummer (die auf dem Label), mit jedem Scan, Status, Datum, Ort und dem nächsten erwarteten Ereignis; die Adresslabels einer Sendung als PDF; das BEX-Adressverzeichnis mit Gemeinden (opštine), Orten (mesta) samt Postleitzahl und Straßen; und rund 120 Paketshops und Depots mit Code, Adresse, Öffnungszeiten und Koordinaten.

Statuscodes: 1 erfasst, 11 beim Absender abgeholt, 21 zugestellt, 25 geht an den Absender zurück, 30 an den Absender zurückgegeben, -21 Adressprüfung durch das Callcenter, -51 beim Zoll. Die KI erklärt dir die Codes in normalen Worten.

Labels: ein A6-Label pro Seite oder vier Labels auf einem A4-Blatt, für alle Pakete einer Sendung oder nur eines. Das PDF ist groß, deshalb holt die KI es nur, wenn du ein Label drucken oder speichern willst.

Adressen laufen über BEX-IDs: BEX beschreibt eine Adresse über Gemeinde, Ort und Straße. Die KI schlägt sie Schritt für Schritt nach, immer eine Gemeinde oder einen Ort auf einmal. Der Connector fragt BEX nie nach allen Straßen Serbiens auf einmal (fast 100.000).

Zwei Hosts und Port 62503: Sendungsverfolgung, Labels und Adressverzeichnis laufen über den normalen HTTPS-Port, die Paketshop-Liste sowie das Anlegen und Stornieren von Sendungen über https://api.bex.rs:62503. Dieser Port ist von AnythingMCP Cloud aus erreichbar; auf einem selbst gehosteten Server hinter einer Firewall, die nur Port 443 durchlässt, schlagen diese drei Tools fehl.

Bei der Installation deaktiviert: bex_express_create_shipments und bex_express_cancel_shipment. Sie melden echte Sendungen zur Abholung durch einen Kurier an oder stornieren sie, deshalb schaltet ein Administrator sie bewusst ein. Auch dann zeigt dir die KI zuerst die vollständige Sendung (Absender, Empfänger, Pakete, Nachnahme, Versicherung, wer zahlt) oder die Sendungsnummer, die storniert werden soll, und wartet auf dein Ja. Eine Sendung, die der Kurier schon abgeholt hat, lässt sich nicht mehr stornieren.

Häufige Fehler: 401 bedeutet, dass der Schlüssel falsch ist oder fehlt. 403 heißt, dass der Schlüssel funktioniert, die Methode für deinen Vertrag aber nicht freigeschaltet ist: Frag bei [email protected] nach. Viele BEX-Methoden antworten mit HTTP 200, aber mit state false und einem Grund in err, deshalb prüft die KI diese Felder, bevor sie ein Ergebnis meldet. Die Ausnahme ist die Paketshop-Liste: Dort schickt BEX state false mit dem Text ok, auch wenn die Liste vollständig ist.

Der Connector deckt keine Rechnungen und keine Auszahlungen der Nachnahme ab, und er legt keine Sendungen an und storniert keine, solange ein Administrator diese Tools nicht eingeschaltet hat.

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 BEX Express-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

• „Wo ist die Sendung 206897445 gerade, und wann ist der nächste Schritt zu erwarten?“
• „Welche dieser Sendungen sind an den Absender zurückgegangen: 206897445, 206897446 und 206897447?“
• „Welche BEX-Paketshops gibt es in Novi Sad, und haben sie samstags geöffnet?“
• „Hol mir die Labels der Sendung 206897445, vier pro A4-Seite, damit ich sie drucken kann.“
• „Kennt BEX den Bulevar oslobođenja in Novi Sad? Gib mir die Orts- und Straßen-ID für eine Sendungsadresse.“

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