nanocart-mcp

nanocart-mcp

公式のNanoCart MCP サーバーです。Claude Code、Claude Desktop、Cursor、Codex など、MCP 対応のあらゆる AI エージェントからストアを運営できます。商品の一覧表示や更新（バリエーションと画像を含む）、注文、クーポン、カテゴリー、登録者、設定の管理、売上レポートの取得を、話しかけるだけで行えます。

39 個のツール。 読み取り専用のツールにはその旨が記されています。商品をアーカイブするツールやクーポンを削除するツールなど、破壊的な操作を行うツールには注記が付いているため、エージェントが実行前に確認します。返金、請求情報の変更、API キーの管理は、意図的に公開していません。これらの操作はダッシュボードで行ってください。

認証情報

ダッシュボードから取得します。Settings → API Keys（sc_live_...。秘密にしてください）と、Settings → Store Information（ストア ID）です。キーを使うとストアへの完全な管理者アクセスが可能になるため、パスワードと同様に取り扱ってください。

オプション A — ローカル（推奨）

Claude Code：

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

stdio MCP に対応する任意のクライアント（JSON 設定形式）：

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

オプション B — ホステッド（インストール不要）

エンドポイント：https://mcp.nanocart.io/mcp?store=your-store-id。ヘッダーに 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_..."

注：OAuth ベースのカスタムコネクターのみをサポートする Web クライアント（claude.ai のコネクター UI など）では、まだ API キーヘッダーを送信できません。その場合はオプション A を使用してください。

プロンプトの例

• 「下書きの商品を一覧表示して、画像があるものを公開して」
• 「SUMMER20 クーポンを作成して。20% オフ、最低注文額は $50、有効期限は 8 月末」
• 「先週の売上は？ まだ発送が必要な注文はある？」
• 「注文 NCT-1042 を追跡番号 9400 1000 0000 0000 0000 00 で発送済みにして」
• 「./shots の写真をアップロードして、それぞれ $24 で商品を作成して」

安全性

• すべての応答でシークレットは伏せられます。キーがそのまま表示されたり、ログに記録されたりすることはありません。
• 破壊的な操作を行うツールには MCP の destructiveHint アノテーションが付いているため、適切に動作するクライアントは実行前に確認を求めます。
• 価格は整数の price_cents で明示されるため、ドルとセントの取り違えがありません。

このツールは、ウェブサイトへのカート組み込みに関する連携知識を提供するNanoCart スキルと組み合わせて使用できます。ドキュメント： https://docs.nanocart.io/#ai-build · AI 向け：https://docs.nanocart.io/llms-full.txt

MIT · © 2026 NanoCart · ByteBunny, LLC の企業