Für KI-Assistenten

Zigarren über einen KI-Assistenten bestellen

Wer mit Claude, ChatGPT oder einem anderen KI-Assistenten arbeitet, kann Primos del Patrón direkt aus dem Chat heraus nutzen. Der Assistent durchsucht den Katalog, rechnet den Warenkorb inklusive Versand und bereitet die Bestellung vor. Bezahlt wird nie im Chat: Am Schluss steht immer die Stripe-Zahlseite, die Sie selbst öffnen und bestätigen.

Lesen darf jeder, kaufen nur Mitglieder

Der Katalog ist offen — Ihr Assistent kann ohne Weiteres nach einer Vitola suchen und einen Preis rechnen. Bestellen kann er nur mit einem Patron-Agentenschlüssel: einem Zugangsschlüssel, den Sie als Mitglied unter «Mein Konto» erstellen und dort jederzeit wieder widerrufen. Er wird genau einmal angezeigt, gehört Ihnen allein und gehört in keine fremde Hand.

Schlüssel unter «Mein Konto» erstellen

So funktioniert es mit Claude

Claude verbindet sich über einen Custom Connector mit dem Shop. Wer ein bezahltes Claude-Abo hat, kann ihn selbst hinzufügen.

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

Öffnen Sie in Claude die Einstellungen und wechseln Sie zu «Connectors».
Wählen Sie «Add custom connector» (benutzerdefinierten Connector hinzufügen) und fügen Sie die Server-URL ein.
Tragen Sie Ihren Patron-Agentenschlüssel als Bearer-Token ein. Ohne ihn bleibt der Katalog lesbar, bestellen geht nicht.
Aktivieren Sie den Connector im Chat und fragen Sie nach einer Zigarre.

Beispiele, die Sie schreiben können

Welche Robustos habt ihr unter 20 Franken?
Was kostet eine Kiste Churchills inklusive Versand?
Bestelle zwei Toros an meine gespeicherte Adresse.
Wie weit ist meine letzte Bestellung?

Und mit ChatGPT

ChatGPT spricht dasselbe Protokoll: Der Shop wird dort als Connector hinterlegt, mit derselben Server-URL und demselben Schlüssel. Der Kauf direkt im Chat («Instant Checkout») ist heute auf die USA und ausgewählte Partner beschränkt und wird hier nicht genutzt — bezahlt wird immer auf der Stripe-Seite.

Was der Assistent kann – und was nicht

Das kann er

Den Katalog durchsuchen — nach Stichwort, Stärke, Format und Preis, mit Blend, Massen und Verfügbarkeit.
Eine einzelne Zigarre nachschlagen, anhand ihrer Produktseite oder ihrer Kennung.
Einen Warenkorb rechnen: Einzel- und Kistenpreise plus Versand, genau so, wie der Shop rechnet.
Eine Bestellung eröffnen und die Stripe-Zahlseite dazu zurückgeben — mit Ihrem Schlüssel.
Ihre eigenen Bestellungen auflisten und deren Stand nennen — mit Ihrem Schlüssel.

Das kann er nicht

Ohne Ihren Schlüssel bestellen. Kein Name und keine Adresse im Chat ersetzen ihn.
Fremde Bestellungen einsehen. Ein Schlüssel gehört zu genau einem Konto und sieht nur dessen Bestellungen.
Für Sie bezahlen. Die Zahlung bestätigen ausschliesslich Sie selbst auf der Stripe-Seite.
Ihr Konto ändern, ein Konto eröffnen oder eine Bestellung stornieren.

Datenschutz

Aus dem Chat gehen nur die Angaben an den Shop, die für die Bestellung nötig sind: Ihre Suchbegriffe, der Warenkorb und die Adresse, die Sie diktieren oder die auf Ihrem Konto liegt. Eine Suche oder eine Preisberechnung speichern wir nicht. Erst wenn eine Zahlseite eröffnet wird, entsteht eine Bestellung — mit denselben Daten wie eine Bestellung im Browser. Ihr Schlüssel wird nur als Prüfsumme gespeichert; wir können ihn nicht auslesen.

Datenschutzerklärung lesen

Für Entwickler und Prüfer

Der Shop stellt einen Model-Context-Protocol-Server bereit. Der Katalog und die Preisberechnung sind ohne Anmeldung erreichbar; alles, was eine Bestellung berührt, verlangt einen Patron-Agentenschlüssel. Eine Bestellung aus dem Chat läuft durch denselben serverseitigen Checkout wie eine Bestellung im Browser: Preise werden neu aus Firestore gelesen, Lagerbestand wird transaktional reserviert, der Kunde bezahlt auf Stripe.

Endpunkt: https://www.primos-del-patron.ch/mcp
Transport: Streamable HTTP mit JSON-Antworten, zustandslos — ein Server pro Anfrage.
Authentifizierung: «Authorization: Bearer pdp_…» mit einem Patron-Agentenschlüssel. Ohne Header antworten Katalog und Preisberechnung trotzdem; die übrigen Tools weisen den Aufruf mit einer Erklärung ab, statt den Handshake scheitern zu lassen.

Die sechs Tools

search_cigars: Durchsucht den Katalog nach Freitext, Stärke, Format und Preis und liefert Blend, Masse, Einzel- und Kistenpreis, Verfügbarkeit und die Produkt-URL.
get_cigar: Liest eine einzelne Zigarre anhand ihrer Dokument-ID oder des Slugs ihrer Seite — auch eine ausverkaufte.
quote_cart: Berechnet einen Warenkorb aus den Zigarrendokumenten, inklusive Versand. Speichert nichts, reserviert nichts.
create_checkout: Eröffnet eine Bestellung und gibt die Stripe-Zahlseite dazu zurück. Verlangt einen Patron-Agentenschlüssel.
list_orders: Listet die Bestellungen des Mitglieds, dem der Schlüssel gehört — und nur diese.
get_order_status: Gibt den Stand einer einzelnen eigenen Bestellung zurück. Adresse, Grussbotschaft und Zahlungsdetails bleiben privat.

Ablauf einer Bestellung

search_cigars oder get_cigar für die Kennungen, quote_cart für den Preis, danach create_checkout. Die Lieferadresse wird aus dem Konto des Mitglieds ergänzt, wenn keine mitgegeben wird.

create_checkout belastet nichts: Es legt eine unbezahlte Bestellung an, reserviert die Zigarren und gibt eine Stripe-Zahlseite zurück. Wird sie nicht bezahlt, verfällt die Bestellung und die Reservation wird wieder freigegeben.