Sellbase

Name: Sellbase
Author: jlgavel011

作者：jlgavel011バージョン 0.3.3i★ –iパソコンで動く

レジストリ名io.github.jlgavel011/sellbase

インストール

概要

作者による説明（英語の原文）

Open source commerce in your own Supabase: catalog, checkout, orders and bookings, run by your AI.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況iとても新しい↓ 46/週 · ★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: ネットショップ・決済
入力が必要なもの：SELLBASE_URL, SELLBASE_API_TOKEN

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
自分で入力するもの： SELLBASE_URL, SELLBASE_API_TOKEN, SUPABASE_ANON_KEY

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

npmNode.jsのインストール（npxコマンドに必要）

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

{
  "mcpServers": {
    "sellbase": {
      "command": "npx",
      "args": [
        "-y",
        "sellbase",
        "mcp"
      ],
      "env": {
        "SELLBASE_URL": "your-value",
        "SELLBASE_API_TOKEN": "your-value",
        "SUPABASE_ANON_KEY": "your-value"
      }
    }
  }
}

ターミナルでこれを実行します

claude mcp add sellbase --env SELLBASE_URL=your-value --env SELLBASE_API_TOKEN=your-value --env SUPABASE_ANON_KEY=your-value -- npx -y sellbase mcp

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "sellbase": {
      "command": "npx",
      "args": [
        "-y",
        "sellbase",
        "mcp"
      ],
      "env": {
        "SELLBASE_URL": "your-value",
        "SELLBASE_API_TOKEN": "your-value",
        "SUPABASE_ANON_KEY": "your-value"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "sellbase": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "sellbase",
        "mcp"
      ],
      "env": {
        "SELLBASE_URL": "your-value",
        "SELLBASE_API_TOKEN": "your-value",
        "SUPABASE_ANON_KEY": "your-value"
      }
    }
  }
}

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

SELLBASE_URL 必須 env
Your store API: /functions/v1/sellbase-api. `npx sellbase init` writes it to .env.sellbase, which the server also reads.
SELLBASE_API_TOKEN 秘密必須 env
Agent token (sb_live_…) with the scopes the owner granted. Create one with `npx sellbase token create` or in Admin → Settings → AI agents.
SUPABASE_ANON_KEY env
Supabase anon/publishable key (public). Needed for storefront tools on hosted projects.

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月8日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント jlgavel011 で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

ネットショップ・決済のほかのサーバーとの比較i

このカテゴリのほかの2569件のうち0%よりスターが多い
このカテゴリのほかの2569件のうち42%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの2569件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Sellbaseは安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

入力が必要なもの：SELLBASE_URL, SELLBASE_API_TOKEN

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（0.3.3）がレジストリに届いたのは41 日前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは？

同じカテゴリには：Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：↓ 週あたりのダウンロードi★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

Spree Commerce: open-source B2B and marketplace ecommerce

Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.

作者：spree広く使われている★ 1.6万9 日前更新

クラウドで動く

インストール

Stripe MCP

MCP server integrating with Stripe - tools for customers, products, payments, and more.

作者：stripe広く使われている★ 204313 か月前更新

クラウドで動く✓ stripe.com

インストール

MCP Cn Commerce

8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending

作者：TonyWang-hub初期↓ 73/週★ 9629 日前更新

パソコンで動く

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Sellbase

An open source Shopify alternative you drop into your existing project, run by your AI agent.

Add products, a cart, Stripe checkout and an admin to the Next.js, React or plain HTML site you already have, on the Supabase you already use, with one command: npx sellbase init. Also included: orders, inventory, abandoned carts, discounts, appointments, emails, an API and an MCP server.

Quick start · Features · Docs · Deploy · Contributing · Español

Why Sellbase

Yours, end to end. Your data lives in your Postgres, your money goes to your Stripe account and your code stays in your repo. There is no platform fee, no lock-in and no Sellbase servers in between. MIT licensed.
AI-first. sellbase init writes CLAUDE.md/AGENTS.md, skills and an MCP server. Tell your agent "set up my store" and it creates products, connects payments and runs a test purchase. Money and destructive actions always ask the owner first, and everything is logged.
Works on any site.
Next.js and Vite + React: React components.
Plain HTML, WordPress, Webflow, Vue, Svelte, Astro, Angular: web components (13 KB gzipped) and a static admin.
An admin that is a pleasure to use. Products with drag and drop photos and variants, inventory, orders with packing slips and refunds, abandoned cart recovery, customers, discounts and settings for every connection. Also:
a command palette (⌘K) to search and act;
an AI copilot on Home;
built for store owners, not developers.
Safe by default.
Money stored as integers.
RLS on every table, with tests.
Orders only come from verified payment webhooks.
Idempotent writes.
Third-party secrets in Supabase Vault.
Signed outbound webhooks that never reach private networks.

Sellbase or build it yourself?

The usual way to add a store to a Next.js + Supabase app is to write it by hand: a products table, a cart, a Server Action for Stripe Checkout and a webhook route. It works for the first sale. Sellbase is that same stack (your Supabase and your Stripe) with the rest already built and tested.

	By hand (Supabase + Stripe)	Sellbase
Setup	5–6 files to write and keep correct	`npx sellbase init`
Runs in your existing app and Supabase	Yes	Yes: its own `sellbase` schema, no extra server
Admin for the owner	Supabase dashboard, or build one	`/admin`: products, photos, variants, orders, refunds, discounts
Inventory, variants, shipping rates, taxes, discounts	Build each one	Included
Orders created only by the verified webhook, idempotent	Up to you	Built in, with tests
Emails, abandoned cart recovery, refunds	Build each one	Included
Your AI agent can run the store (create products, check orders…)	No	MCP server with 31 tools; money and destructive actions ask the owner

Unlike engines such as Medusa, Vendure or Saleor, Sellbase needs no separate backend server. It runs on Supabase Edge Functions next to your app, and the storefront components are copied into your repo for you to edit.

Quick start

Requirements: Node 20+ and a Supabase project (or the local stack with Docker).

npx supabase start          # local stack (or pass --supabase-url … for a hosted project)

npx sellbase init --yes # schema, Edge Functions, store, owner, admin, components, agent files

Then:

Admin: open /admin and sign in. Locally, the owner's email and password are in .env.sellbase.
Setup: follow the setup guide on Home.
Or let your agent do it: open it in the project and say "Configura mi tienda con Sellbase" / "Set up my store with Sellbase". It uses the sellbase MCP tools until a test purchase succeeds.

npx sellbase doctor         # checklist with the next step for anything missing

npx sellbase upgrade # new versions: dry run, backup, migrations, functions, components

Start from a template

npx sellbase create my-store --template nextjs   # Next.js store with the admin at /admin

npx sellbase create my-landing --template html # plain HTML landing page, no build step

Both are in examples/ with Vercel and Netlify deploy buttons.

With Claude Code

/plugin marketplace add jlgavel011/sellbase

/plugin install sellbase@sellbase /sellbase:setup I sell handmade candles, $250 MXN each, shipping $120

The plugin brings the Sellbase skills and MCP server to every project. /sellbase:setup installs Sellbase, creates your products, connects Stripe in test mode and runs a test purchase. Any other MCP client can use npx sellbase mcp (listed in the MCP registry as io.github.jlgavel011/sellbase).

With any agent (Cursor, Codex, Copilot, Gemini CLI, Windsurf…)

npx skills add jlgavel011/sellbase    # the Sellbase skills, including add-ecommerce

Then ask your agent to "add a store to this project". The add-ecommerce skill installs Sellbase and sets it up.

With shadcn

The storefront components are also a shadcn-compatible registry:

npx shadcn add https://jlgavel011.github.io/sellbase/r/store.json          # everything

npx shadcn add https://jlgavel011.github.io/sellbase/r/product-grid.json # or one component

They still need the backend: npx sellbase init --yes. The index is at /r/registry.json.

Going live: deploy guide and live payments with Stripe.

Features

Catalog:

physical products, digital downloads and services with appointments;
up to 3 options per product (size, color…) with a variant matrix, compare-at prices and SEO;
collections, tags and stock per variant;
CSV import (including Shopify exports) and export;
bulk price changes with a preview.

Checkout:

Stripe Checkout (cards, Apple Pay, Google Pay; test and live mode);
shipping rates, free shipping thresholds and local pickup;
inclusive or exclusive taxes;
discount codes and automatic discounts;
deposits for services;
a required consent checkbox (e.g. 18+ for alcohol) enforced by the server and stored with the order.

Orders:

payment and fulfillment statuses;
shipping with carrier and tracking;
full or partial refunds;
cancellations with restock;
a timeline with comments;
printable packing slips;
manual orders (cash, transfer, WhatsApp) and payment links.

Growth:

abandoned checkouts with one-click or automatic recovery emails that restore the cart;
customers with their history;
sales metrics and best sellers.

Services:

resources with weekly hours and exceptions;
availability;
bookings with reminders (24 h and 2 h before) and calendar invites.

Emails (Resend): order confirmation with download links, shipping updates, refunds, cancellations, appointment notices and cart recovery. All of them carry your logo and brand color.

Team and AI:

staff roles and invitations;
API tokens with scopes for agents (money and data export scopes are opt-in);
an activity log;
signed outbound webhooks with retries for your ERP, spreadsheets or Zapier.

Storefront:

React components copied into your repo (edit freely);
headless hooks;
web components for any site;
SEO helpers (JSON-LD, sitemap);
order lookup and download pages;
accessible markup (checked with axe).

How it works

your site ──(@sellbase/react or <sellbase-*> web components)──┐

/admin (@sellbase/admin) ─────────────────────────────────────┤ your AI agent ──(sellbase MCP server)─────────────────────────┤ ▼ Supabase: Edge Functions (sellbase-api, -webhooks, -jobs) Postgres schema sellbase (RLS) · Vault · Storage · pg_cron │ Stripe · Resend · your webhooks

One API contract. Every route is declared once with Zod in @sellbase/core. The Hono server validates with it, the OpenAPI spec and the typed SDK come from it, and the MCP tools reuse it.
Snapshots. Orders keep a copy of prices, titles and addresses, so later catalog changes never alter past orders.
The outbox. Business events are written in the same transaction as the change; jobs deliver emails and webhooks from it.

Package	What it is
`sellbase`	CLI: `init`, `doctor`, `upgrade`, `add`, `seed`, `token`, `mcp`
`@sellbase/admin`	The admin (React), also shipped as a static page
`@sellbase/react`	Provider and hooks for storefronts
`@sellbase/web`	Web components for any site
`@sellbase/sdk`	Typed API client and SEO helpers
`@sellbase/mcp`	MCP server for AI agents
`@sellbase/core`	Schemas, API contracts, pricing, state machines

Documentation

Getting started (español)
Add an ecommerce store to a Next.js app with Supabase (en español)
Deploy to production
Customize the admin
Live payments with Stripe (español)
API reference, plus llms.txt and llms-full.txt for agents
Specification and architecture decisions
Changelog

Development

pnpm i

pnpm exec supabase start && node scripts/seed-demo.mjs pnpm dev # playground on http://localhost:3100 (admin at /ad

冒頭だけを表示しています。続きはリポジトリで読めます

Sellbase

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

自分で入力する値

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

ネットショップ・決済のほかのサーバーとの比較i

よくある質問

代わりの候補

Spree Commerce: open-source B2B and marketplace ecommerce

Stripe MCP

MCP Cn Commerce

作者のREADME

Sellbase

Why Sellbase

Sellbase or build it yourself?

Quick start

Start from a template

With Claude Code

With any agent (Cursor, Codex, Copilot, Gemini CLI, Windsurf…)

With shadcn

Features

How it works

Documentation

Development