English Français العربية

io.github.ByteBunny-io/nanocart-mcp

Registre officiel E-commerce

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « 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)>'
Configuration 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
Configuration 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>"
            }
        }
    }
}

Variables d'environnement

  • NANOCART_API_KEY obligatoire secret Your NanoCart Admin API key (portal.nanocart.io -> Settings -> API Keys)
  • NANOCART_STORE_ID obligatoire Your store ID / slug (portal.nanocart.io -> Settings -> Store Information)

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que io.github.ByteBunny-io/nanocart-mcp ?

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

Comment installer io.github.ByteBunny-io/nanocart-mcp ?

Il fonctionne comme serveur distant. Dans 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)>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.ByteBunny-io/nanocart-mcp ?

Oui. Il attend NANOCART_API_KEY, NANOCART_STORE_ID, Authorization, X-Store-Id, à renseigner dans sa configuration.

io.github.ByteBunny-io/nanocart-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.ByteBunny-io/nanocart-mcp ?

Il est publié par ByteBunny-io. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.