VibeCart

Коммерческая инфраструктура для приложений, созданных с помощью ИИ, и ИИ-агентов.

VibeCart позволяет продавцу сохранить существующее приложение и аккаунт Stripe, добавляя небольшой, проверяемый коммерческий слой, который могут обнаруживать и использовать ИИ-агенты. Платежи поступают напрямую на аккаунт продавца в Stripe; VibeCart не нужно становиться зарегистрированным продавцом.

Архитектура основана на протоколах: один доверенный коммерческий бэкенд, а вокруг него — тонкие адаптеры 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 проверяются до того, как оплаченные события попадут в конвейер пост-оплаты.

• Завершение отложенных платежей обрабатывается отдельно, чтобы заказы не создавались преждевременно.

• Позиции оплаченного Checkout нормализуются в постоянные записи заказов, когда настроена пересылка VibeCart Cloud.

• Идентификаторы доверенных товаров продавца сохраняются в Checkout через метаданные Stripe Product.

Related MCP server: Shopify Agentic MCP Gateway

Распространение среди агентов-клиентов

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 включают:

• постоянные проверенные коммерческие события

• постоянные нормализованные записи оплаченных заказов и история заказов

• поиск заказов между серверами

• подписанные вебхуки выполнения для продавца

• история доставки и ограниченные повторные попытки

• мониторинг/оповещения и рабочие процессы поддержки

Рабочее пространство Cloud: https://vibecart-cloud-uupzkh.v2.appdeploy.ai/

Выручка от покупок продавца по-прежнему поступает напрямую на его аккаунт 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 проверяются перед обработкой пост-оплаты.

• Состояние корзины является постоянным и версионированным, а не доверенным от браузера/агента.

• Учетные данные для интеграции Cloud остаются на стороне сервера.

• Публичные конечные точки здоровья/обнаружения раскрывают булевы значения готовности/возможности, а не значения учетных данных.

• Опциональные возможности UCP рекламируются только тогда, когда их зависимости времени выполнения действительны.

Соответствие протоколу

CI фиксирует выпущенный исходный код UCP v2026-04-08 и выполняет реальные мапперы VibeCart через официальный валидатор ucp-schema. Полезные нагрузки успеха/ошибки корзины, ответы каталога, обнаружение и частный маппер заказов имеют шлюзы соответствия, привязанные к выпуску.

Текущие справочные ограничения

• Каталог продавца по-прежнему является небольшим справочным каталогом, а не полноценным сервисом каталога для нескольких продавцов.

• Запасы, автоматический расчет налогов, расчет стоимости доставки, возвраты/обмены и полный жизненный цикл выполнения заказов не являются готовыми платформенными сервисами.

• Публичный поиск заказов UCP остается активационно-ограниченным до тех пор, пока не будут настроены его зависимости от Cloud/постоянных ссылок времени выполнения.

• Next.js App Router является эталонной реализацией; другие фреймворки должны использовать адаптеры вокруг той же основной протокольной поверхности, а не форкать коммерческую логику.

Северная звезда

VibeCart: коммерческая инфраструктура для каждого ИИ-агента. Создайте один раз. Продавайте везде, где может действовать ИИ.

Лицензия

MIT — бесплатно для использования, модификации, распространения, сублицензирования и продажи на условиях лицензии.