VibeCart

AI 기반 앱과 AI 에이전트를 위한 커머스 인프라

VibeCart를 사용하면 판매자가 기존 앱과 Stripe 계정을 유지하면서 AI 에이전트가 발견하고 사용할 수 있는 작고 검사 가능한 커머스 레이어를 추가할 수 있습니다. 결제는 판매자의 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 체크아웃 및 주문

• 신뢰할 수 있는 다중 라인 Stripe Checkout 생성이 지원됩니다.

• 결제 완료 이벤트가 사후 결제 파이프라인에 진입하기 전에 Stripe 웹훅 서명이 확인됩니다.

• 지연된 결제 완료는 별도로 처리되어 주문이 조기에 생성되지 않습니다.

• 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는 VibeCart가 반복적인 배관 작업을 운영하길 원하는 판매자를 위한 선택적 월 $29 관리형 레이어입니다.

현재 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 소스를 고정하고 공식 ucp-schema 검증기를 통해 VibeCart의 실제 매퍼를 실행합니다. 장바구니 성공/오류 페이로드, 카탈로그 응답, 디스커버리 및 비공개 주문 매퍼는 릴리스 고정 적합성 게이트를 가지고 있습니다.

현재 참조 제한 사항

• 판매자 카탈로그는 여전히 완전한 다중 판매자 카탈로그 서비스가 아닌 소규모 참조 카탈로그입니다.

• 재고, 자동 세금 계산, 배송료 계산, 반품/환불 및 완전한 이행 수명 주기는 완성된 플랫폼 서비스가 아닙니다.

• 공개 UCP 주문 조회는 Cloud/영구 링크 런타임 종속성이 구성될 때까지 활성화 게이트가 유지됩니다.

• Next.js App Router가 참조 구현입니다. 다른 프레임워크는 커머스 로직을 포크하는 대신 동일한 Core 프로토콜 표면 주변의 어댑터를 사용해야 합니다.

북극성

VibeCart: 모든 AI 에이전트를 위한 커머스 인프라. 한 번 구축하세요. AI가 행동할 수 있는 모든 곳에서 판매하세요.

라이선스

MIT — 라이선스 조건에 따라 자유롭게 사용, 수정, 배포, 서브라이선스 및 판매할 수 있습니다.