Nanocart Mcp

io.github.ByteBunny-io由 GitHub 帳號 ByteBunny-io 發布v1.2.0更新於 Oct 24, 2026

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

已驗證Streamable HTTP可網頁執行效率與工作流商業與電商

概覽

AI 產生的概覽

NanoCart 官方 MCP 伺服器，讓 AI 助理管理 NanoCart 商店：商品、訂單、優惠券、訂閱者與銷售報表。

可以做什麼
  • 列出、建立與更新商品，包含款式與圖片
  • 管理訂單，包含填寫物流單號並標記為已出貨
  • 建立與管理優惠券、分類、訂閱者及商店設定
  • 取得銷售報表並檢視近期訂單
適用情境
適合經營 NanoCart 商店、希望在支援 MCP 的 AI 助理中以對話方式處理商品上架、訂單狀態、優惠券與銷售資料，而不必登入後台的使用者。
執行需求
需要一個 NanoCart 商店，以及管理員 API 金鑰（NANOCART_API_KEY，sc_live_ 前綴）和商店 ID（NANOCART_STORE_ID）。可透過 npx nanocart-mcp 在本機執行（需 Node.js），也可使用託管的 Streamable HTTP 端點，以 Authorization bearer 標頭及 URL 或 X-Store-Id 標頭提供商店 ID。
安裝前請注意
此 API 金鑰擁有商店的完整管理員權限，應像密碼一樣保管。工具會變更商店資料：商品、訂單、優惠券與設定可被建立、更新或封存，破壞性工具僅以標註提示，用戶端可能忽略。退款、帳務與 API 金鑰管理並未開放。僅支援 OAuth 連接器的網頁用戶端無法送出 API 金鑰標頭。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Nanocart Mcp，將其新增到工作區。
  2. 連接 Authorization token 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.ByteBunny-io%2Fnanocart-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "nanocart": {
      "type": "http",
      "url": "https://mcp.nanocart.io/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

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.

Option A — Local (recommended)

Claude Code:

bash
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):

json
{  "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:

bash
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

來源：README.md，提交 c967982

工具

0
該伺服器需要 API 金鑰等憑證，因此 SourceWeft 無法在沒有憑證的情況下讀取其工具，也未收錄。

版本歷史

1
  1. v1.2.0最新Sep 16, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分