Per assistenti IA

Ordinare sigari tramite un assistente IA

Chi lavora con Claude, ChatGPT o un altro assistente IA può usare Primos del Patrón direttamente dalla chat. L’assistente cerca nel catalogo, calcola il carrello spedizione inclusa e prepara l’ordine. Non si paga mai in chat: alla fine c’è sempre la pagina di pagamento Stripe, che apre e conferma lei stesso.

Leggere è di tutti, comprare è dei membri

Il catalogo è aperto — il suo assistente può cercare una vitola e calcolare un prezzo senz’altro. Per ordinare serve una chiave agente Patron: una chiave d’accesso che lei crea come membro in «Il mio conto» e che può revocare lì in qualsiasi momento. Viene mostrata una sola volta, appartiene a lei soltanto e non va in mani altrui.

Crea una chiave in «Il mio conto»

Come funziona con Claude

Claude si collega al negozio tramite un connettore personalizzato. Chi ha un abbonamento Claude a pagamento può aggiungerlo da sé.

URL del server:https://www.primos-del-patron.ch/mcp

Apra le impostazioni in Claude e vada su «Connectors».
Scelga «Add custom connector» e incolli l’URL del server.
Inserisca la sua chiave agente Patron come bearer token. Senza, il catalogo resta leggibile ma ordinare non è possibile.
Attivi il connettore in una chat e chieda di un sigaro.

Esempi di richieste

Quali robusto avete sotto i 20 franchi?
Quanto costa una scatola di Churchill, spedizione inclusa?
Ordina due toro al mio indirizzo salvato.
A che punto è il mio ultimo ordine?

E con ChatGPT

ChatGPT parla lo stesso protocollo: il negozio vi si registra come connettore, con lo stesso URL e la stessa chiave. L’acquisto direttamente in chat («Instant Checkout») è oggi limitato agli Stati Uniti e ad alcuni partner e qui non viene usato — si paga sempre sulla pagina Stripe.

Cosa può fare l’assistente — e cosa no

Può

Cercare nel catalogo — per parola chiave, forza, formato e prezzo, con blend, misure e disponibilità.
Consultare un singolo sigaro, dalla sua pagina o dal suo identificativo.
Calcolare un carrello: prezzi al pezzo e alla scatola più spedizione, esattamente come fa il negozio.
Aprire un ordine e restituire la relativa pagina di pagamento Stripe — con la sua chiave.
Elencare i suoi ordini e dire a che punto sono — con la sua chiave.

Non può

Ordinare senza la sua chiave. Nessun nome e nessun indirizzo in chat la sostituiscono.
Vedere gli ordini altrui. Una chiave appartiene a un solo conto e vede solo gli ordini di quello.
Pagare al posto suo. Il pagamento lo conferma solo lei, sulla pagina Stripe.
Modificare il suo conto, aprirne uno o annullare un ordine.

Protezione dei dati

Dalla chat al negozio vanno solo i dati necessari all’ordine: i termini di ricerca, il carrello e l’indirizzo che detta o che è salvato sul suo conto. Una ricerca o un calcolo di prezzo non viene memorizzato. Un ordine nasce soltanto quando viene aperta una pagina di pagamento — con gli stessi dati di un ordine fatto nel browser. La sua chiave è conservata solo come impronta; non possiamo rileggerla.

Leggere l’informativa sulla privacy

Per sviluppatori e revisori

Il negozio espone un server Model Context Protocol. Il catalogo e il calcolo dei prezzi sono raggiungibili senza login; tutto ciò che tocca un ordine richiede una chiave agente Patron. Un ordine dalla chat passa per lo stesso checkout lato server di un ordine dal browser: i prezzi vengono riletti da Firestore, la giacenza è riservata in modo transazionale e il cliente paga su Stripe.

Endpoint: https://www.primos-del-patron.ch/mcp
Trasporto: Streamable HTTP con risposte JSON, senza stato — un server per richiesta.
Autenticazione: «Authorization: Bearer pdp_…» con una chiave agente Patron. Senza l’header il catalogo e il calcolo dei prezzi rispondono comunque; gli altri strumenti rifiutano la chiamata con una spiegazione invece di far fallire l’handshake.

I sei strumenti

search_cigars: Cerca nel catalogo per testo libero, forza, formato e prezzo, restituendo il blend, le misure, i prezzi al pezzo e alla scatola, la disponibilità e l’URL del prodotto.
get_cigar: Legge un singolo sigaro tramite l’id del documento o lo slug della sua pagina — anche esaurito.
quote_cart: Calcola un carrello dai documenti dei sigari, spedizione inclusa. Non memorizza nulla e non riserva nulla.
create_checkout: Apre un ordine e restituisce la relativa pagina di pagamento Stripe. Richiede una chiave agente Patron.
list_orders: Elenca gli ordini del membro a cui appartiene la chiave — e nessun altro.
get_order_status: Restituisce lo stato di un ordine del membro. Indirizzo, messaggio regalo e dettagli di pagamento restano privati.

Come si svolge un ordine

search_cigars o get_cigar per gli identificativi, quote_cart per il prezzo, poi create_checkout. L’indirizzo di consegna viene completato dal conto del membro quando non ne viene fornito uno.

create_checkout non addebita nulla: apre un ordine non pagato, riserva i sigari e restituisce una pagina di pagamento Stripe. Se non viene pagata, l’ordine decade e la riserva viene liberata.