VibeCart

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 を使用してください。

永続カート

Neon を利用する VibeCart のカートは、本番環境で稼働しています。

• 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 アダプターもあります。ただし、VibeCart Cloud の検索機能と実際のマーチャント用パーマリンクが設定されるまでは、get_order は非公開のままです。VibeCart は、実行時に必要な依存関係が整う前にオプション機能を公開することはありません。

Stripe Checkout と注文

• Stripe Checkout で、信頼された複数明細の作成をサポートしています。
• 支払い完了イベントが後払いパイプラインに入る前に、Stripe ウェブフックの署名を検証します。
• 注文が早まって作成されないよう、後払いの完了は別途処理します。
• VibeCart Cloud への転送が設定されている場合、支払い済みの Checkout 明細を永続的な注文レコードに正規化します。
• 信頼されたマーチャント商品 ID は、Stripe Product メタデータを通じて Checkout 後も保持されます。

He Said Nothing 実店舗パイロット

/he-said-nothing は、39 ドル、59 ドル、89 ドルのミステリーギフトボックスを対象とした、管理下の物理商品のパイロットです。注文が失敗時に安全側に倒れるようにしながら、ストアフロントを公開したままにできます。完全なローンチ条件が整うと、次の機能を利用できます。

• 関係性クイズ、サイズの手がかり、包装の選択、ギフトメッセージ、フルフィルメントのメモを永続カートに保存します。
• カートに紐づいた冪等な Stripe Checkout Session を開きます。
• メールアドレス、電話番号、配送先住所、個別に明示された配送料、および任意の Stripe 自動税計算を収集します。
• 検証済みの支払い済み注文、明細、配送詳細、ギフトの手がかり、イベント履歴を Neon に保存します。
• HMAC 署名付きのマーチャントセッションを使用して、支払い済み注文を /he-said-nothing/admin からのみ公開します。
• New、Packing、Shipped、Cancelled、Refunded-in-Stripe のフルフィルメント状態をサポートします。

Checkout の有効化には、.env.example に記載されたすべての依存関係が必要です。HSN_CHECKOUT_ENABLED=true だけでは不十分です。テスト用とライブ用の Stripe キーは HSN_CHECKOUT_MODE と一致している必要があります。また、ライブモードでは、カスタマーサポート、返品ポリシー、処理時間に関するテキストも必要です。

マーチャントカタログのソース

組み込みの lib/products.ts カタログは、デモ／リファレンスデータ専用です。実際のマーチャントは SKU と価格を VibeCart の外部で管理し、マーチャントが管理する HTTPS JSON フィードを Core に指定できます。

VIBECART_CATALOG_URL=https://merchant.example/vibecart/catalog.json
VIBECART_MERCHANT_NAME="Example Merchant"
# Optional when the feed is private:
VIBECART_CATALOG_BEARER_TOKEN=server-side-secret

受け付けるレスポンス形式：

{
  "products": [
    {
      "id": "sku-123",
      "name": "Example product",
      "description": "Merchant-controlled product data",
      "priceCents": 4900,
      "image": "https://merchant.example/products/sku-123.jpg",
      "variant": "Optional variant"
    }
  ]
}

ドキュメントのルートに商品配列を置く形式も受け付けます。id、name、および 0 以上の整数の priceCents が必須です。画像 URL が指定されている場合は、HTTPS を使用する必要があります。

設定されたソースは、汎用 MCP カタログ／チェックアウト、UCP カタログ、および永続カートの価格再計算で共有されます。VibeCart はドキュメントを検証し、ID の重複を拒否し、レスポンス数と商品数に上限を設け、リダイレクトとプライベートネットワーク宛てのアクセスをブロックし、短いタイムアウトを適用し、正常なカタログデータを 30 秒間キャッシュします。VIBECART_CATALOG_URL が設定されていて、ソースが正常でないか無効な場合、コマース操作はフェイルクローズします。VibeCart がデモ商品に暗黙的にフォールバックすることはありません。

そのため、通常の SKU や価格の変更に、VibeCart の TypeScript の編集や Core の再デプロイは必要ありません。

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

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 は、定期的な運用処理を VibeCart に任せたいマーチャント向けの、オプションの月額 29 ドルのマネージドレイヤーです。

現在の Cloud 機能には以下が含まれます。

• 検証済みコマースイベントの永続化
• 正規化された支払い済み注文レコードと注文履歴の永続化
• サーバー間の注文照会
• 署名付きマーチャント向けフルフィルメント Webhook
• 配信履歴と上限付き再試行
• モニタリング／アラートとサポートワークフロー

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

マーチャントのチェックアウトによる売上は、引き続きマーチャントの Stripe アカウントに直接入金されます。VibeCart はマーチャントの売上に対する手数料を受け取りません。

クイックスタート

npm install
npm run dev

VIBECART_CATALOG_URL を設定していない場合、Core は開発用に架空のリファレンスカタログを使用します。商品や価格を実店舗のカタログとして扱う前に、マーチャントカタログの URL を設定してください。

Stripe シークレットがない場合、チェックアウトはデモモードであることを明示して実行されます。実際の決済には、ホスティングプロバイダーのシークレット／環境設定で STRIPE_SECRET_KEY を設定してください。シークレット値をコミットしないでください。

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

• /start — マーチャント／クライアント向けクイックスタート
• /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 の署名を検証します。
• カートの状態は永続化およびバージョン管理され、ブラウザーやエージェントからの情報を無条件に信頼することはありません。
• カタログ、Stripe、データベース、および Cloud 連携の認証情報はサーバー側に保持されます。
• 公開ヘルス／検出エンドポイントが公開するのは準備状態の真偽値と機能であり、認証情報の値ではありません。
• オプションの UCP 機能は、実行時の依存関係が有効な場合に限って公開されます。

プロトコルへの準拠

CI ではリリース済みの UCP v2026-04-08 のソースを固定し、公式の ucp-schema バリデーターを通じて、VibeCart の実際のマッパーを実行します。カートの成功／エラーペイロード、カタログのレスポンス、ディスカバリー、非公開の注文マッパーには、リリースに固定された準拠チェックがあります。

現在のリファレンス実装の制限事項

• リモートカタログコネクターは、意図的にシンプルな信頼済み JSON プロバイダーの契約です。まだ、加盟店 UI、在庫同期、VibeCart Cloud が保存する加盟店ごとの認証情報を備えた、複数の加盟店に対応するカタログ管理基盤ではありません。
• 在庫管理、自動税額計算、配送料計算、返品／返金、完全なフルフィルメントのライフサイクルは、プラットフォームサービスとしてまだ完成していません。
• Cloud／パーマリンクの実行時依存関係が設定されるまで、公開 UCP 注文照会は有効化がゲートされています。
• Next.js App Router はリファレンス実装です。他のフレームワークでは、コマースロジックをフォークするのではなく、同じ Core プロトコルサーフェスを利用するアダプターを使用してください。

北極星

VibeCart：あらゆる AI エージェントのためのコマースインフラストラクチャ。一度構築すれば、AI が活動できるあらゆる場所で販売できます。

ライセンス

MIT — ライセンス条項に従い、自由に使用、変更、配布、サブライセンス、販売できます。