mcpField
C
Coupang Wing

Coupang Wing

本地服务
appmonster.co.kr商业与营销06 天前更新
代码仓库访问官网

关于 Coupang Wing

Coupang Wing 是面向 Coupang 卖家的 Open API MCP 服务，供 AI Agent 查询商品和订单、修改选项库存或价格，并确认已付款订单。写入操作可要求人工审批。

主要功能

  1. 01按条件分页查询商品
  2. 02查看商品详情与选项
  3. 03修改选项库存和售价
  4. 04按日期与状态查询订单
  5. 05确认订单进入商品准备中

适用场景

  1. 01查看商品选项及出库日期
  2. 02调整选项库存或售价
  3. 03筛选并核对订单
  4. 04确认付款订单并准备发货

MCP 相关

该服务将 Coupang Wing Open API 的商品、订单及写入操作暴露为 MCP 工具；写入可经确认令牌或 OK Agent 审批。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "groove79-mcp-coupang": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-coupang"
      ],
      "env": {
        "COUPANG_ACCESS_KEY": "<COUPANG_ACCESS_KEY>",
        "COUPANG_SECRET_KEY": "<COUPANG_SECRET_KEY>",
        "COUPANG_VENDOR_ID": "<COUPANG_VENDOR_ID>",
        "OKAGENT_API_KEY": "<OKAGENT_API_KEY>",
        "KMCP_WRITE_MODE": "<KMCP_WRITE_MODE>"
      }
    }
  }
}
启动命令npx -y @appmonster/mcp-coupang
需要配置的环境变量
COUPANG_ACCESS_KEY密钥Wing Open API access key
COUPANG_SECRET_KEY密钥Wing Open API secret key
COUPANG_VENDOR_IDSeller vendor id, e.g. A00012345
OKAGENT_API_KEY密钥OK Agent key (free at okagent.kr) — writes then wait for your OK on KakaoTalk. Unset: writes ask for confirmation in the chat first.
KMCP_WRITE_MODEapproval | confirm | direct (default: approval if OKAGENT_API_KEY is set, else confirm)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@appmonster/mcp-coupang0.2.0

工具

7

收录的工具列表 · 更新于 1 周前

参数类型必填说明
statusenum否IN_REVIEW | SAVED | APPROVING | APPROVED | PARTIAL_APPROVED | DENIED | DELETED
createdAtstring否注册日期，格式为 yyyy-MM-dd
nextTokenstring否填写上一条响应中的值；第一页时省略
maxPerPageinteger否
sellerProductNamestring否按名称搜索，最多 20 个字符

详细介绍

@appmonster/mcp-coupang

Coupang Wing Open API（쿠팡 판매자）的 MCP 服务。允许 AI Agent 读取商品和订单、修改商品库存／价格，以及确认已付款的订单——每次写入操作都可以选择通过人工审批（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读取查询单张发货单——用于发货前再次确认地址
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"
      }
    }
  }
}
写入操作的人工审批（可选，建议启用）

每个写入工具都会在执行前请求确认。默认情况下，Agent 会在聊天中显示预览；你同意后，Agent 会携带 confirm_token 再次调用。添加 OK Agent 密钥（免费，每月 200 次），即可改用 KakaoTalk 审批：

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

对于完全信任的脚本，设置 KMCP_WRITE_MODE=direct 可关闭检查。

注意事项

  • 身份验证使用 Coupang 的 CEA HMAC-SHA256 标头；服务会对发送的确切字节进行签名（包括查询字符串），因此只要系统时钟正确（UTC），就无需担心时钟偏差问题。
  • 对于许多业务错误，Coupang 会返回 HTTP 200 和 code: "ERROR"——这类错误会作为工具错误返回，并附带 Coupang 的错误消息。
  • 每次调用的订单日期范围最多为 31 天；coupang_list_orders 默认查询最近 7 天（KST）。
  • 客户可以在付款后更改配送地址。打印面单前，请立即调用 coupang_get_order。

开发

pnpm --filter @appmonster/mcp-coupang test

测试使用注入的 fetch；不会访问真实网络。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。