VibeCart

AI構築アプリとAIエージェントのためのコマース基盤。

VibeCartは、マーチャントが既存のアプリとStripeアカウントを維持しながら、AIエージェントが発見・使用できる、小さく検査可能なコマースレイヤーを追加することを可能にします。決済はマーチャントのStripeアカウントに直接入金されます。VibeCartがマーチャントオブレコードになる必要はありません。

アーキテクチャはプロトコルファーストです。1つの信頼されたコマースバックエンドと、その周りに薄いMCP/UCP/クライアントアダプターを配置します。

実稼働中の公開サーフェス

汎用MCP

エンドポイント: https://vibecart.vercel.app/mcp

ツール:

• vibecart.list_products

• vibecart.get_product

• vibecart.get_integration_instructions

• vibecart.create_checkout

vibecart.create_checkoutは、従来の単一商品入力と、信頼された複数アイテムのitems[]入力の両方をサポートします。商品価格はサーバー側で解決されます。呼び出し元は実際の取引価格を提供しません。

汎用MCPクライアントは/mcpを使用する必要があります。

永続的なカート

VibeCartのNeonバックアップカートは、本番環境で稼働中です。

• POST /api/cart

• GET /api/cart/:id

• PATCH /api/cart/:id

• DELETE /api/cart/:id

• POST /api/cart/:id/checkout

カートは、信頼されたサーバー側の価格再設定、冪等な作成、楽観的バージョンチェック、有効期限、複数アイテム状態、カートからStripe Checkoutへのハンドオフを使用します。

UCP

• ディスカバリ: https://vibecart.vercel.app/.well-known/ucp

• UCP対応MCPトランスポート: https://vibecart.vercel.app/ucp/mcp

• リリース済みプロトコルターゲット: UCP 2026-04-08

本番環境では、リリース済みのカタログとカートのケイパビリティを広告表示します。現在のカートツールは次のとおりです。

• create_cart

• get_cart

• update_cart

• cancel_cart

UCP呼び出しにはmeta.ucp-agent.profileとケイパビリティネゴシエーションが必要です。通常のMCPクライアントを/ucp/mcpに向けないでください。

注文パイプラインとリリース済みスキーマのget_orderアダプターも存在しますが、get_orderは、そのVibeCart Cloudルックアップと実際のマーチャントパーマリンクの依存関係が構成されるまで非表示のままです。VibeCartは、実行時の依存関係が準備できる前にオプションのケイパビリティを広告表示しません。

Stripe Checkoutと注文

• 信頼された複数ラインのStripe Checkout作成がサポートされています。

• 支払い完了イベントが支払い後パイプラインに入力される前に、Stripe Webhookシグネチャが検証されます。

• 延期された支払い完了は個別に処理されるため、注文が時期尚早に作成されることはありません。

• VibeCart Cloud転送が構成されている場合、支払い済みCheckoutのラインアイテムは永続的な注文レコードに正規化されます。

• 信頼されたマーチャント商品IDは、Stripe Productメタデータを通じてCheckoutを生き残ります。

Related MCP server: ACP Commerce MCP Server

エージェントクライアント配布

VibeCartは、モデルごとに異なるコマースエンジンを構築しません。OpenAI/Codex/ChatGPT、Claude、Gemini、VS Code、Cursor、その他のMCPクライアントは、同じバックエンドに接続します。

参照:

• docs/integrations/agent-clients.md

• integrations/mcp-clients.json

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

プロバイダーアダプターはCIでチェックされ、Stripe/データベースシークレットや重複したコマースロジックがクライアント設定に含まれないようにします。

VibeCart Cloud

VibeCart Coreはセルフホスト無料です。VibeCart Cloudは、月額29ドルのオプションのマネージドレイヤーであり、定期的な配管作業をVibeCartに運用させたいマーチャント向けです。

現在のCloudケイパビリティは次のとおりです。

• 永続的な検証済みコマースイベント

• 永続的な正規化済み支払い注文レコードと注文履歴

• サーバー間の注文ルックアップ

• 署名済みマーチャントフルフィルメントWebhook

• 配信履歴と制限付き再試行

• 監視/アラートとサポートワークフロー

Cloudワークスペース: https://vibecart-cloud-uupzkh.v2.appdeploy.ai/

マーチャントのCheckout収益は、引き続きマーチャントのStripeアカウントに直接入金されます。VibeCartはマーチャントの売上からパーセンテージを受け取りません。

クイックスタート

npm install
npm run dev

Stripeシークレットがない場合、Checkoutは明確にラベル付けされたデモモードで実行されます。ライブ決済の場合は、ホスティングプロバイダーのシークレット/環境設定でSTRIPE_SECRET_KEYを構成してください。シークレット値をコミットしないでください。

便利な公開エンドポイント:

• /mcp — 汎用MCPトランスポート/ディスカバリ

• /api/cart — 永続的なカート作成

• /.well-known/ucp — UCPビジネスディスカバリ

• /ucp/mcp — UCP対応MCPトランスポート

• /mcp-clients.json — 機械可読なクライアント互換性マニフェスト

• /llms.txt — 簡潔な機械可読統合ノート

• /agents.md — エージェント向けガイド

• /api/health — シークレット値なしのブール型準備状態

• /cloud — マネージドCloudオファー

セキュリティモデル

• マーチャントはStripeアカウントを所有し、マーチャント資金を直接受け取ります。

• 信頼された価格は、サーバー側のマーチャントカタログ状態から提供されます。

• クライアントが提供する価格設定はデフォルトで無効であり、サーバー側で明示的に有効にされた場合にのみプロトタイプ限定で使用できます。

• Stripe Webhookシグネチャは、支払い後処理の前に検証されます。

• カートの状態は永続的でバージョン管理されており、ブラウザ/エージェントから信頼されることはありません。

• Cloud統合の認証情報はサーバー側に残ります。

• 公開ヘルス/ディスカバリエンドポイントは、準備状態のブール値/ケイパビリティを公開し、認証情報の値は公開しません。

• オプションのUCPケイパビリティは、その実行時の依存関係が有効な場合にのみ広告表示されます。

プロトコル準拠

CIは、リリースされたUCP v2026-04-08ソースを固定し、公式のucp-schemaバリデーターを通じてVibeCartの実際のマッパーを実行します。カートの成功/エラーペイロード、カタログ応答、ディスカバリ、およびプライベート注文マッパーには、リリース固定の準拠ゲートがあります。

現在の参照制限

• マーチャントカタログは、依然として完全なマルチマーチャントカタログサービスではなく、小さな参照カタログです。

• 在庫、自動税計算、配送料計算、返品/返金、および完全なフルフィルメントライフサイクルは、まだ完成したプラットフォームサービスではありません。

• 公開UCP注文ルックアップは、そのCloud/パーマリンクの実行時依存関係が構成されるまで、アクティベーションゲートのままです。

• Next.js App Routerが参照実装です。他のフレームワークは、コマースロジックをフォークするのではなく、同じCoreプロトコルサーフェスの周りのアダプターを使用する必要があります。

北極星

VibeCart: あらゆるAIエージェントのためのコマース基盤。一度構築すれば、AIが行動できるあらゆる場所で販売可能。

ライセンス

MIT — ライセンス条項に基づき、自由に使用、修正、配布、サブライセンス、販売が可能です。