BEX Express über MCP mit Claude 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 + Claude

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

Empfohlener Weg: funktioniert auf claude.ai web ohne Anfassen einer Konfigurationsdatei.

1. Öffne in Claude Customize → Connectors.
2. Klicke auf + und dann auf Add custom connector.
3. Gib einen Namen ein, z. B. BEX Express, und die Remote-MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, dann klicke auf Add.
4. Klicke auf Connect und melde dich bei AnythingMCP an (OAuth), um den Zugriff zu erlauben.

Alle unten gelisteten Tools erscheinen in deinem Chat: Leg los mit Prompts.

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

Funktioniert es mit Claude Code genauso wie mit Claude Desktop? Ja, beide auf https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID zeigen lassen.

Nächste Schritte

• Connector-Startseite
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden