Come collegare BEX Express a Cursor via MCP

💡 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 + Cursor

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.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

BEX_API_TOKEN

Step 1 — Ottieni le credenziali

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.

1. Se non sei ancora cliente BEX, chiedi un'offerta a [email protected]: l'API è riservata ai clienti con contratto.
2. Scrivi a [email protected], chiedi l'accesso all'API e indica il contratto a cui si riferisce.
3. BEX risponde con una API key e il tuo KlijentId. Incolla la chiave in BEX_API_TOKEN; viene inviata nell'header X-AUTH-TOKEN. Tieni a portata di mano il KlijentId: identifica la tua azienda come mittente di una spedizione.
4. 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.

Step 2 — Installa l'adapter

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

Step 3 — Aggiungi il connettore in Cursor

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di BEX Express.

Tool disponibili

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

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT