Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi BEX Express con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
In breve
Il corriere BEX Express (Serbia) da un agente AI: storico degli stati di una spedizione dal numero di spedizione, etichette indirizzo in PDF, la rubrica indirizzi BEX con comuni, località e vie, e i parcel shop e depositi. Creare e annullare spedizioni è incluso, disattivato all'installazione.
Prova a chiedere
Prompt di esempio per BEX Express
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → BEX Express, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
BEX Express
Il corriere BEX Express (Serbia) da un agente AI: storico degli stati di una spedizione dal numero di spedizione, etichette indirizzo in PDF, la rubrica indirizzi BEX con comuni, località e vie, e i parcel shop e depositi. Creare e annullare spedizioni è incluso, disattivato all'installazione.
Setup
La configurazione richiede circa 5 minuti, una volta che BEX ti ha inviato la chiave. Ti servono un contratto con BEX Express, il corriere serbo, e una API key che BEX rilascia per quel contratto.
- Se non sei ancora cliente BEX, chiedi un'offerta a [email protected]: l'API è riservata ai clienti con contratto.
- Scrivi a [email protected], chiedi l'accesso all'API e indica il contratto a cui si riferisce.
- BEX risponde con una API key e il tuo KlijentId. Incolla la chiave in
BEX_API_TOKEN; viene inviata nell'headerX-AUTH-TOKEN. Tieni a portata di mano il KlijentId: identifica la tua azienda come mittente di una spedizione. - Installa il connettore ed esegui
bex_express_list_municipalities. Se restituisce l'elenco dei comuni, la chiave funziona.
Cosa legge: lo storico degli stati di una spedizione dal suo numero BEX (quello stampato sull'etichetta), con ogni scansione, stato, data, luogo e il prossimo evento previsto; le etichette indirizzo di una spedizione in PDF; la rubrica indirizzi BEX con comuni (opštine), località (mesta) con CAP e vie; e circa 120 parcel shop e depositi con codice, indirizzo, orari di apertura e coordinate.
Codici di stato: 1 registrata, 11 ritirata dal mittente, 21 consegnata, 25 da restituire al mittente, 30 restituita al mittente, -21 verifica dell'indirizzo da parte del call center, -51 in dogana. L'AI ti spiega cosa significano con parole semplici.
Etichette: un'etichetta A6 per pagina oppure quattro etichette su un foglio A4, per tutti i colli di una spedizione o solo per uno. Il PDF è pesante, quindi l'AI lo scarica solo quando vuoi stampare o salvare un'etichetta.
Gli indirizzi usano gli id BEX: BEX descrive un indirizzo con comune, località e via. L'AI li cerca passo per passo, un comune o una località alla volta. Il connettore non chiede mai a BEX tutte le vie della Serbia in un colpo solo (quasi 100.000).
Due host e la porta 62503: tracking, etichette e rubrica indirizzi passano dalla normale porta HTTPS, mentre l'elenco dei parcel shop e la creazione e l'annullamento delle spedizioni passano da https://api.bex.rs:62503. Quella porta è raggiungibile da AnythingMCP Cloud; su un server self-hosted dietro un firewall che lascia passare solo la porta 443, questi tre tool non funzionano.
Disattivati all'installazione: bex_express_create_shipments e bex_express_cancel_shipment. Annunciano spedizioni reali per il ritiro da parte di un corriere o le annullano, quindi un amministratore li attiva consapevolmente. Anche allora l'AI ti mostra prima la spedizione completa (mittente, destinatario, colli, contrassegno, assicurazione, chi paga) o il numero di spedizione da annullare, e aspetta il tuo sì. Una spedizione già ritirata dal corriere non si può più annullare.
Errori comuni: 401 significa che la chiave è sbagliata o manca. 403 significa che la chiave funziona ma quel metodo non è abilitato per il tuo contratto: chiedi a [email protected]. Molti metodi BEX rispondono HTTP 200 ma con state false e un motivo in err, perciò l'AI controlla questi campi prima di riportarti un risultato. Fa eccezione l'elenco dei parcel shop: lì BEX invia state false con il testo ok anche quando l'elenco è completo.
Il connettore non gestisce fatture né il versamento dei contrassegni, e non crea né annulla spedizioni finché un amministratore non attiva quei tool.
Prerequisiti: BEX_API_TOKEN
Installazione locale del connettore
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
Apri http://localhost:3000/connectors/store, scegli BEX Express e inserisci le variabili elencate nei Prerequisiti.
Tool disponibili
| Tool | What it does |
|---|---|
bex_express_get_shipment_history | Get the status history of a BEX shipment by its shipment number: every scan with status name, scan and reason code, date, place, timestamp… |
bex_express_get_label | Get the address labels of a shipment as a Base64-encoded PDF (parcelLabel), with state true on success or false and an err text. page_size… |
bex_express_list_municipalities | List the municipalities (opštine) in the BEX address directory with id and name |
bex_express_list_settlements | List the places (mesta) of one municipality in the BEX address directory with id, name, postcode and municipality id |
bex_express_list_streets | List the streets of one place in the BEX address directory with id, name, old name and place id |
bex_express_list_parcel_shops | List BEX parcel shops and depots with code, region, name, city, street and house number, opening hours on weekdays and Saturday, and… |
bex_express_create_shipments | Create shipments and announce them to BEX for pickup by a courier (postShipments) |
bex_express_cancel_shipment | Cancel (delete) an announced BEX shipment by its shipment number |
Esempi di prompt
- "Dove si trova adesso la spedizione 206897445 e quando è previsto il prossimo passaggio?"
- "Quali di queste spedizioni sono tornate al mittente: 206897445, 206897446 e 206897447?"
- "Quali parcel shop BEX ci sono a Novi Sad e sono aperti il sabato?"
- "Scaricami le etichette della spedizione 206897445, quattro per pagina A4, così le stampo."
- "BEX conosce Bulevar oslobođenja a Novi Sad? Dammi l'id della località e della via per un indirizzo di spedizione."
Prossimi passi
Questa guida ti è stata utile?
