Naver Commerce

@appmonster/mcp-naver-commerce

Naver Commerce API（Smart Store）用のMCPサーバーです。Claude、Cursor、ChatGPT、およびあらゆるMCPクライアントから、商品一覧の取得、注文の確認、「新しい注文はありますか？」への回答、在庫の変更を韓国語または英語で行えます。

네이버 커머스 API(스마트스토어)용 MCP 서버. エージェントが商品・在庫・注文・顧客からの問い合わせを直接扱います。

インストール

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "naver-commerce": {
      "command": "npx",
      "args": ["-y", "@appmonster/mcp-naver-commerce"],
      "env": {
        "NAVER_COMMERCE_CLIENT_ID": "your-client-id",
        "NAVER_COMMERCE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Cursor（.cursor/mcp.json） — "mcpServers" の下に同じブロックを追加します。

Claude Code：

claude mcp add naver-commerce -e NAVER_COMMERCE_CLIENT_ID=... -e NAVER_COMMERCE_CLIENT_SECRET=... -- npx -y @appmonster/mcp-naver-commerce

認証情報は커머스API센터 → 애플리케이션 등록 から取得します。シークレットは bcrypt のソルトとして使用され、お使いのマシンの外部に送信されることはありません。

ツール

ツール	アクセス	機能
naver_list_products	読み取り	ページング／フィルターを指定して商品を一覧表示します（POST /v1/products/search）
naver_get_product	読み取り	オプションと在庫を含むチャンネル商品の詳細を取得します（GET /v2/products/channel-products/{no}）
naver_update_stock	書き込み	在庫を変更します。オプションのない商品：チャンネル商品を GET → stockQuantity を変更 → PUT /v2/products/channel-products/{no} で全体を更新します（Naverには在庫専用APIがありません）。オプション商品：PUT …/option-stock
naver_list_orders	読み取り	指定時刻以降に変更された注文とその詳細を取得します（last-changed-statuses → query）
naver_list_inquiries	読み取り	指定期間内の顧客からの1:1問い合わせを取得します（GET /v1/pay-user/inquiries）
naver_upload_images	書き込み	画像（URL／base64）をNaverにアップロードし、商品作成用のホスト済みURLを取得します（POST /v1/product-images/upload）
naver_create_product	書き込み	商品とSmart Storeのチャンネル商品を作成します（POST /v2/products）。Japan bridgeの jp_listing_draft 形式を受け付けます。販売前の確認には statusType: SUSPENSION（または WAIT）を指定します。Naverは作成時にステータスを無視して販売を開始するため、このツールはチャンネル商品を非表示にし、続けて販売中지に更新したうえで、実際のステータスを返します。

書き込みツールには destructiveHint: true が設定されているため、クライアントは実行前に確認を求めることができます。createServer({ approveWrite }) を使うと、外部の承認手順を組み込めます。

プロンプト例

• 「어제 이후 새로 결제된 주문 보여줘」
• 「'모자' 상품 재고를 0으로 바꿔줘」（書き込み操作のため、事前に確認します）
• 「답변 안 한 고객문의 있어?」

セキュリティ

• 認証情報は環境変数からのみ取得されます。保存されたり、api.commerce.naver.com 以外に送信されたりすることはありません。
• トークンはメモリ内にキャッシュされ、有効期限の60秒前に更新されます。
• エラーではNaverの code／message がそのまま返されるため、エージェントが問題の内容を説明できます。

開発

pnpm install && pnpm -F @appmonster/mcp-naver-commerce build && pnpm -F @appmonster/mcp-naver-commerce test

MIT © Appmonster

ライブ環境での検証（2026-10-21）

実際のSmart Storeで検証しました：naver_upload_images（PNG → shop-phinf URL）、naver_create_product に statusType: SUSPENSION を指定 → status: SUSPENSION, displayStatus: SUSPENSION を読み戻し → 削除。ツールには次の検証結果が反映されています：作成時に WAIT は拒否されるため SUSPENSION に変換されます。deliveryInfo.deliveryCompany（宅配会社コード、既定値は CJGLS）が必須です。作成時に指定したステータスは無視され（商品は SALE として表示されます）、そのため後続の更新が必要です。確認はいつでも node scripts/create-probe.mjs で再実行できます（販売중지の商品を1件作成して削除します）。