VibeCart

Commerce-Infrastruktur für KI-erstellte Apps und KI-Agenten.

VibeCart ermöglicht es einem Händler, seine bestehende App und sein Stripe-Konto zu behalten und gleichzeitig eine kleine, überprüfbare Commerce-Schicht hinzuzufügen, die KI-Agenten entdecken und nutzen können. Zahlungen werden direkt auf das Stripe-Konto des Händlers abgewickelt; VibeCart muss nicht zum Händler der Aufzeichnung werden.

Die Architektur ist protokollorientiert: ein vertrauenswürdiges Commerce-Backend, dann dünne MCP/UCP/Client-Adapter darum herum.

Live-Produktionsoberfläche

Generisches MCP

Endpunkt: https://vibecart.vercel.app/mcp

Werkzeuge:

• vibecart.list_products

• vibecart.get_product

• vibecart.get_integration_instructions

• vibecart.create_checkout

vibecart.create_checkout unterstützt sowohl die alte Einzelprodukteingabe als auch eine vertrauenswürdige items[]-Eingabe mit mehreren Artikeln. Produktpreise werden auf dem Server aufgelöst; Aufrufer geben keine echten Transaktionspreise an.

Generische MCP-Clients sollten /mcp verwenden.

Dauerhafter Warenkorb

VibeCarts Neon-gestützter Warenkorb ist in der Produktion live:

• POST /api/cart

• GET /api/cart/:id

• PATCH /api/cart/:id

• DELETE /api/cart/:id

• POST /api/cart/:id/checkout

Der Warenkorb verwendet vertrauenswürdige serverseitige Neupreisberechnung, idempotente Erstellung, optimistische Versionsprüfungen, Ablauf, Mehrartikelzustand und die Übergabe vom Warenkorb an Stripe Checkout.

UCP

• Discovery: https://vibecart.vercel.app/.well-known/ucp

• UCP-bewusster MCP-Transport: https://vibecart.vercel.app/ucp/mcp

• Freigegebenes Protokollziel: UCP 2026-04-08

Die Produktion bewirbt freigegebene Katalog- und Warenkorbfähigkeiten. Aktuelle Warenkorbwerkzeuge sind:

• create_cart

• get_cart

• update_cart

• cancel_cart

UCP-Aufrufe erfordern meta.ucp-agent.profile und Fähigkeitsverhandlung. Richten Sie keinen gewöhnlichen MCP-Client auf /ucp/mcp.

Die Bestellpipeline und der get_order-Adapter mit freigegebenem Schema existieren ebenfalls, aber get_order bleibt verborgen, bis seine VibeCart Cloud-Suche und echte Händler-Permalink-Abhängigkeiten konfiguriert sind. VibeCart bewirbt optionale Fähigkeiten nicht, bevor deren Laufzeitabhängigkeiten bereit sind.

Stripe Checkout und Bestellungen

• Die vertrauenswürdige Erstellung von Stripe Checkout mit mehreren Zeilen wird unterstützt.

• Stripe-Webhook-Signaturen werden überprüft, bevor bezahlte Ereignisse in die Post-Payment-Pipeline gelangen.

• Der Abschluss verzögerter Zahlungen wird separat behandelt, sodass Bestellungen nicht vorzeitig erstellt werden.

• Bezahlte Checkout-Posten werden in dauerhafte Bestellaufzeichnungen normalisiert, wenn die VibeCart Cloud-Weiterleitung konfiguriert ist.

• Vertrauenswürdige Händlerprodukt-IDs überleben Checkout durch Stripe-Produktmetadaten.

Related MCP server: ACP Commerce MCP Server

Agent-Client-Verteilung

VibeCart baut nicht für jedes Modell eine andere Commerce-Engine. OpenAI/Codex/ChatGPT, Claude, Gemini, VS Code, Cursor und andere MCP-Clients verbinden sich mit demselben Backend.

Siehe:

• docs/integrations/agent-clients.md

• integrations/mcp-clients.json

• https://vibecart.vercel.app/mcp-clients.json

Provider-Adapter werden CI-geprüft, um Stripe-/Datenbank-Geheimnisse und duplizierte Commerce-Logik aus der Client-Konfiguration herauszuhalten.

VibeCart Cloud

VibeCart Core kann kostenlos selbst gehostet werden. VibeCart Cloud ist die optionale verwaltete Schicht für 29 $/Monat für Händler, die möchten, dass VibeCart die wiederkehrende Infrastruktur betreibt.

Aktuelle Cloud-Fähigkeiten umfassen:

• dauerhafte verifizierte Commerce-Ereignisse

• dauerhafte normalisierte Aufzeichnungen bezahlter Bestellungen und Bestellverlauf

• Server-zu-Server-Bestellsuche

• signierte Händler-Fulfillment-Webhooks

• Zustellungsverlauf und begrenzte Wiederholungsversuche

• Überwachung/Benachrichtigungen und Support-Workflows

Cloud-Arbeitsbereich: https://vibecart-cloud-uupzkh.v2.appdeploy.ai/

Die Checkout-Einnahmen des Händlers werden weiterhin direkt auf das Stripe-Konto des Händlers abgewickelt. VibeCart behält keinen Prozentsatz des Händlerumsatzes.

Schnellstart

npm install
npm run dev

Ohne ein Stripe-Geheimnis läuft Checkout im deutlich gekennzeichneten Demomodus. Für Live-Zahlungen konfigurieren Sie STRIPE_SECRET_KEY in den Geheimnis-/Umgebungseinstellungen des Hosting-Anbieters. Übergeben Sie niemals geheime Werte.

Nützliche öffentliche Endpunkte:

• /mcp — generischer MCP-Transport/Entdeckung

• /api/cart — dauerhafte Warenkorberstellung

• /.well-known/ucp — UCP-Geschäftsentdeckung

• /ucp/mcp — UCP-bewusster MCP-Transport

• /mcp-clients.json — maschinenlesbares Client-Kompatibilitätsmanifest

• /llms.txt — präzise maschinenlesbare Integrationsnotizen

• /agents.md — an Agenten gerichteter Leitfaden

• /api/health — boolescher Bereitschaftszustand ohne geheime Werte

• /cloud — verwaltetes Cloud-Angebot

Sicherheitsmodell

• Der Händler besitzt das Stripe-Konto und erhält Händlergelder direkt.

• Vertrauenswürdige Preise stammen vom serverseitigen Händlerkatalogzustand.

• Vom Client bereitgestellte Preisgestaltung ist standardmäßig deaktiviert und nur Prototyp, wenn sie serverseitig explizit aktiviert wird.

• Stripe-Webhook-Signaturen werden vor der Post-Payment-Verarbeitung überprüft.

• Der Warenkorbzustand ist dauerhaft und versioniert, anstatt vom Browser/Agenten vertraut zu werden.

• Cloud-Integrationsanmeldeinformationen bleiben serverseitig.

• Öffentliche Health-/Discovery-Endpunkte geben Bereitschafts-Booleans/Fähigkeiten preis, keine Anmeldeinformationen.

• Optionale UCP-Fähigkeiten werden nur beworben, wenn ihre Laufzeitabhängigkeiten gültig sind.

Protokollkonformität

CI pinnt die veröffentlichte UCP v2026-04-08-Quelle und führt VibeCarts echte Mapper durch den offiziellen ucp-schema-Validator aus. Warenkorb-Erfolgs-/Fehler-Payloads, Katalogantworten, Discovery und der private Bestell-Mapper haben release-pinned Conformance Gates.

Aktuelle Referenzgrenzen

• Der Händlerkatalog ist noch ein kleiner Referenzkatalog und kein vollständiger Multi-Händler-Katalogdienst.

• Bestandsverwaltung, automatische Steuerberechnung, Versandkostenberechnung, Retouren/Rückerstattungen und ein vollständiger Fulfillment-Lebenszyklus sind keine fertigen Plattformdienste.

• Die öffentliche UCP-Bestellsuche bleibt aktivierungsgeschützt, bis ihre Cloud-/Permalink-Laufzeitabhängigkeiten konfiguriert sind.

• Next.js App Router ist die Referenzimplementierung; andere Frameworks sollten Adapter um dieselbe Core-Protokolloberfläche verwenden, anstatt Commerce-Logik zu forken.

Leitstern

VibeCart: Commerce-Infrastruktur für jeden KI-Agenten. Einmal bauen. Überall verkaufen, wo KI handeln kann.

Lizenz

MIT — kostenlos nutzbar, modifizierbar, verteilbar, unterlizenzierbar und verkaufbar unter den Lizenzbedingungen.