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

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

Muse bindet Remote-MCP-Server als Custom Connectors ein und meldet sich per OAuth bei ihnen an.

1. Öffne in Muse Settings → Connectors und wähle Add custom connector.
2. Füge die MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein.
3. Muse öffnet die Anmeldeseite von AnythingMCP: Melde dich an und bestätige den Zugriff.
4. Bitte Muse im Chat um etwas, wofür es die BEX Express-Tools braucht.

Du kannst den Connector auch per Chat einrichten, im Web, in den Apps für iOS und Android oder in WhatsApp. Schick Muse diese Nachricht:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Muse verbindet sich aus der Cloud von Meta, 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

Wo ist Muse verfügbar? Meta bietet Muse derzeit in den USA und in Kanada an, im Web, in den Apps für iOS und Android und in WhatsApp.

Prüft Meta diesen Connector? Nein. Meta prüft Custom Connectors nicht. Muse sieht nur die Tools, die du in AnythingMCP für diesen MCP-Server eingeschaltet hast, und du kannst den Connector jederzeit unter Settings → Connectors trennen.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden