MCP Server v0.37.0

Il tuo assistente AI, collegato alle tue spedizioni

Collega Claude o ChatGPT ai dati delle tue spedizioni Qapla' e fai domande in linguaggio naturale — conteggi, consegne, stato di un tracking — e chiedi anche come integrare le API Qapla'.

✨ Usi Claude? Crea la tua dashboard con i dati reali

Chiedi a Claude di analizzare le tue spedizioni e costruire report su misura — in linguaggio naturale, senza scrivere una riga di codice. Il connettore porta i tuoi numeri direttamente in chat.

Qapla' Logistics Dashboard Aggiornato: 26/06/26 · 27/05/26 – 25/06/26 7gg 30gg 90gg MTD 329 Eccezioni 185 Tentativi falliti 353 Rientri 479 In ritardo TOTALE SPEDIZIONI 55.273 27/05 – 25/06/26 CONSEGNATE 50.949 Tasso: 92,2% IN CORSO 4.324 non ancora consegnate TASSO CONSEGNA 92,2% su 55.273 totali GG MEDI TRANSITO 1,6 giorni lavorativi medi PROBLEMI 521 anomalie/eccezioni aperte VOLUME GIORNALIERO 4500 3000 1500 27/05 01/06 08/06 15/06 22/06 25/06 TOP CANALI Shop Online 9.821 Amazon.it 8.953 eBay Italia 3.481 B2B Direct 2.340 Marketplace EU 1.678 Dati di esempio

1 L'indirizzo del server

Questo è l'unico dato che ti serve. Copialo: lo incollerai nel tuo client AI.

https://mcp.qapla.it/mcp

2 Collega il server al tuo client

Su Claude (claude.ai sul web o l'app desktop) i connettori MCP si aggiungono dalle impostazioni. Serve un piano che supporta i connettori personalizzati (Pro, Max, Team o Enterprise).

  1. Apri Claude e vai su Impostazioni → Connettori (Settings → Connectors).
  2. Scorri in fondo e clicca “Aggiungi connettore personalizzato” (Add custom connector).
  3. Dai un nome (es. Qapla' Spedizioni) e nel campo URL incolla l'indirizzo del passo 1: https://mcp.qapla.it/mcp
  4. Conferma: si aprirà il login Qapla' in una finestra del browser. Accedi con le tue credenziali e autorizza l'accesso nella schermata di consenso.
  5. Il connettore risulta collegato. In una nuova chat, assicurati che Qapla' sia attivo tra gli strumenti e inizia a fare domande.

Il percorso esatto dei menu può variare leggermente per versione/piano, ma i passaggi (Connettori → aggiungi → incolla URL → login Qapla') sono sempre questi.

Su ChatGPT i server MCP custom si aggiungono attivando la Developer mode (richiede un piano a pagamento: Plus, Pro, Business o Enterprise). È una funzione in beta.

Prima: attiva la Developer mode

  1. Apri ChatGPT (web o desktop) → clicca la tua immagine profilo → Impostazioni.
  2. Vai su Connettori, scorri in fondo e clicca Avanzate (Advanced).
  3. Attiva Developer mode e conferma l'avviso.

Poi: aggiungi il connettore Qapla'

  1. Sempre in Impostazioni → Connettori, clicca Crea (Create / New connector).
  2. Nome: es. Qapla' Spedizioni. La descrizione è facoltativa.
  3. Nel campo URL del server MCP incolla l'indirizzo del passo 1: https://mcp.qapla.it/mcp
  4. Imposta l'autenticazione su OAuth e conferma (“I trust this application”): si aprirà il login Qapla' — accedi e autorizza l'accesso.
  5. In una chat, attiva il connettore Qapla' Spedizioni e fai le tue domande.

Usi Gemini? L'app consumer non supporta ancora i connettori MCP personalizzati (le integrazioni sono solo su invito). Il collegamento è possibile solo con Gemini Enterprise, dove un amministratore registra il server dalla Google Cloud Console. Il nostro server è già tecnicamente compatibile (Streamable HTTP + OAuth).

3 Cosa puoi chiedere

Esempi di domande in linguaggio naturale:

“Quante spedizioni ho consegnato oggi?”
“Quante consegne negli ultimi 30 giorni, divise per corriere?”
“Mostrami le ultime 10 spedizioni non ancora consegnate”
“Trova le spedizioni del destinatario mario.rossi@email.com”
“Che stato ha la spedizione con tracking 1Z… ?”
“Qual è il corriere con il tempo di consegna migliore?”
“Qual è il corriere più veloce per spedire al CAP 20100?”
“Il corriere BRT sta peggiorando o migliorando?”
“Quali corrieri uso?”
“Quanto ho speso di spedizioni questo mese?”
“Quali sono i prodotti che spedisco di più?”
“Qual è il tasso di apertura delle email di notifica?”
“Quanti SMS ho inviato questo mese e quanto ho speso?”
“Quante spedizioni in giacenza al momento?”
“Quali spedizioni sono ferme da più di 7 giorni?”
“Qual è il tasso di consegne puntuali per corriere?”
“Quante spedizioni sono passate per la dogana?”
“Quali punti di ritiro (locker, negozi) usano di più i miei clienti?”
“Come autentico le chiamate alle API Qapla'?”
“Come creo un'etichetta con le API Qapla'?”

🚀 Questo servizio è sempre in crescita: aggiungiamo nuovi strumenti di continuo. Se non vedi le ultime novità, apri una nuova chat (oppure disconnetti e riconnetti il connettore).

Novità

🔒
Vedi solo i dati della tua azienda. L'accesso è legato al tuo login Qapla': è il token a determinare quali spedizioni puoi vedere, non l'assistente AI. Non è possibile chiedere i dati di un'altra azienda — l'isolamento è garantito dal server, non dal modello.
Dettagli tecnici (per chi integra)
Endpoint MCPhttps://mcp.qapla.it/mcp
TransportStreamable HTTP (POST)
AutenticazioneOAuth 2.1 + PKCE (S256)
Authorization Serverhttps://sso.qapla.it
Resource metadatahttps://mcp.qapla.it/.well-known/oauth-protected-resource