MCP Server

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.

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.

3 Cosa puoi chiedere

Esempi di domande in linguaggio naturale:

“Quante spedizioni ho consegnato oggi?”
“Quante consegne negli ultimi 30 giorni, divise per corriere?”
“Quante spedizioni in giacenza al momento?”
“Che stato ha la spedizione con tracking 1Z… ?”
🔒
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