English Français العربية

io.github.ByteBunny-io/nanocart-mcp

السجل الرسمي التجارة الإلكترونية

Manage your NanoCart store from any AI agent: products, orders, coupons, subscribers, reports.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http nanocart-mcp 'https://mcp.nanocart.io/mcp' --header 'Authorization: <Bearer <your sc_live_ API key>>' --header 'X-Store-Id: <Your store ID (or append ?store=your-store-id to the URL)>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "nanocart-mcp": {
            "type": "http",
            "url": "https://mcp.nanocart.io/mcp",
            "headers": {
                "Authorization": "<Bearer <your sc_live_ API key>>",
                "X-Store-Id": "<Your store ID (or append ?store=your-store-id to the URL)>"
            }
        }
    }
}
NPM package nanocart-mcp
Claude Code 
claude mcp add nanocart-mcp -e 'NANOCART_API_KEY=<your nanocart_api_key>' -e 'NANOCART_STORE_ID=<NANOCART_STORE_ID>' -- npx -y nanocart-mcp@1.2.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "nanocart-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "nanocart-mcp@1.2.0"
            ],
            "env": {
                "NANOCART_API_KEY": "<your nanocart_api_key>",
                "NANOCART_STORE_ID": "<NANOCART_STORE_ID>"
            }
        }
    }
}

متغيرات البيئة

  • NANOCART_API_KEY إلزامي سري Your NanoCart Admin API key (portal.nanocart.io -> Settings -> API Keys)
  • NANOCART_STORE_ID إلزامي Your store ID / slug (portal.nanocart.io -> Settings -> Store Information)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. nanocart-mcp
  2. Credentials
  3. Option A — Local (recommended)
  4. Option B — Hosted (no install)
  5. Example prompts
  6. Safety

nanocart-mcp

Official NanoCart MCP server — run your store from any MCP-capable AI agent (Claude Code, Claude Desktop, Cursor, Codex, and friends). List and update products (with variants and images), manage orders, coupons, categories, subscribers and settings, and pull sales reports — by asking.

39 tools. Reads are marked read-only; destructive tools (archive product, delete coupon) are annotated so your agent asks before acting. Refunds, billing changes, and API-key management are deliberately NOT exposed — do those in your dashboard.

Credentials

From your dashboard: Settings → API Keys (sc_live_..., keep secret) and Settings → Store Information (your store ID). The key grants full admin access to your store — treat it like a password.

Claude Code:

claude mcp add nanocart --env NANOCART_API_KEY=sc_live_... --env NANOCART_STORE_ID=your-store-id -- npx -y nanocart-mcp

Any client that speaks stdio MCP (JSON config style):

{
  "mcpServers": {
    "nanocart": {
      "command": "npx",
      "args": ["-y", "nanocart-mcp"],
      "env": {
        "NANOCART_API_KEY": "sc_live_...",
        "NANOCART_STORE_ID": "your-store-id"
      }
    }
  }
}

Option B — Hosted (no install)

Endpoint: https://mcp.nanocart.io/mcp?store=your-store-id with header Authorization: Bearer sc_live_... (Streamable HTTP).

Claude Code:

claude mcp add nanocart --transport http "https://mcp.nanocart.io/mcp?store=your-store-id" --header "Authorization: Bearer sc_live_..."

Note: web clients that only support OAuth-based custom connectors (e.g. claude.ai's connector UI) can't send API-key headers yet — use Option A there.

Example prompts

  • "List my draft products and publish the ones with images"
  • "Create a SUMMER20 coupon — 20% off, min order $50, expires end of August"
  • "What did I sell last week? Any orders I still need to ship?"
  • "Mark order NCT-1042 shipped with tracking 9400 1000 0000 0000 0000 00"
  • "Upload the photos in ./shots and create products from them at $24 each"

Safety

  • Secrets are redacted from every response; your key is never echoed or logged.
  • Destructive tools carry MCP destructiveHint annotations — well-behaved clients prompt before running them.
  • Prices are explicit price_cents integers (no dollars/cents ambiguity).

Pairs with the NanoCart skill (integration knowledge for building the cart into websites). Docs: https://docs.nanocart.io/#ai-build · AI-readable: https://docs.nanocart.io/llms-full.txt

MIT · © 2026 NanoCart · a ByteBunny, LLC company

الأسئلة الشائعة

ما هو io.github.ByteBunny-io/nanocart-mcp؟

Manage your NanoCart store from any AI agent: products, orders, coupons, subscribers, reports.

كيف أثبّت io.github.ByteBunny-io/nanocart-mcp؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http nanocart-mcp 'https://mcp.nanocart.io/mcp' --header 'Authorization: <Bearer <your sc_live_ API key>>' --header 'X-Store-Id: <Your store ID (or append ?store=your-store-id to the URL)>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.ByteBunny-io/nanocart-mcp إلى مفتاح API؟

نعم. يتطلب NANOCART_API_KEY, NANOCART_STORE_ID, Authorization, X-Store-Id، وتضبطها في إعداداته.

هل io.github.ByteBunny-io/nanocart-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.ByteBunny-io/nanocart-mcp؟

ينشره ByteBunny-io. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.