Coupang Wing

@appmonster/mcp-coupang

Coupang Wing Open API（쿠팡 판매자）用のMCPサーバーです。AI エージェントが商品や注文を参照したり、商品の在庫・価格を変更したり、決済済みの注文を承認したりできます。書き込み操作はすべて、人間の承認を必須にすることもできます（OK Agent）。

쿠팡 윙 오픈API용 MCP 서버입니다. 상품·발주서를 조회하고, 옵션 재고·가격을 변경하며, 상품준비중 처리를 합니다.

ツール

ツール	アクセス	内容
coupang_list_products	読み取り	登録商品の一覧（名前／状態によるフィルター、nextToken によるページネーション）
coupang_get_product	読み取り	商品の詳細とオプション（vendorItemId、価格、出荷日）
coupang_update_item_quantity	書き込み	オプションの在庫数を変更（0 = 品切れ）
coupang_update_item_price	書き込み	オプションの販売価格を変更
coupang_list_orders	読み取り	期間・状態別の発注書（ACCEPT/INSTRUCT/DEPARTURE/…）、最大31日間
coupang_get_order	読み取り	発注書1件 — 配送直前の住所再確認用
coupang_confirm_orders	書き込み	決済完了 → 商品準備中（最大50件、注文ごとの結果）

セットアップ

1. Wing → 販売者情報 → 追加販売情報 → OPEN APIキーを発行します。Access key、Secret key、事業者コード（A00012345の形式）を取得します。
2. MCP クライアントの設定：

{
  "mcpServers": {
    "coupang": {
      "command": "npx",
      "args": ["-y", "@appmonster/mcp-coupang"],
      "env": {
        "COUPANG_ACCESS_KEY": "…",
        "COUPANG_SECRET_KEY": "…",
        "COUPANG_VENDOR_ID": "A00012345"
      }
    }
  }
}

書き込み操作の人間による承認（任意、推奨）

書き込みツールを実行する前に、毎回確認を求めます。デフォルトでは、エージェントがチャットにプレビューを表示し、あなたが同意すると confirm_token を指定して再度呼び出します。代わりに KakaoTalk で承認するには、OK Agent のキー（無料、月200回）を追加します。

"OKAGENT_API_KEY": "ok_…",
"APPROVAL_TIMEOUT_SEC": "300"

KMCP_WRITE_MODE=direct を設定すると、完全に信頼できるスクリプトに対して確認を無効にできます。

注意事項

• 認証には Coupang の CEA HMAC-SHA256 ヘッダーを使用します。サーバーは送信する正確なバイト列（クエリー文字列を含む）に署名するため、正しいシステム時刻（UTC）以外にクロックスキュー対策は必要ありません。
• Coupang は多くの業務上の失敗に対して、code: "ERROR" を含む HTTP 200 を返します。これらは Coupang のメッセージとともにツールエラーとして表示されます。
• 注文の期間指定は1回の呼び出しにつき最大31日間です。coupang_list_orders は、デフォルトで直近7日間（KST）を対象とします。
• 顧客は支払い後に配送先住所を変更できます。送り状を印刷する直前に coupang_get_order を呼び出してください。

開発

pnpm --filter @appmonster/mcp-coupang test

テストでは注入された fetch を使用し、実際のネットワークには接続しません。