如何通过 MCP 将 noon Marketplace 连接到 Cursor

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → noon Marketplace、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

noon Marketplace + Cursor

通过 noon Partner API，从 AI 智能体在 noon.com（阿联酋、沙特阿拉伯、埃及）上开展销售：仓库、商品目录内容和商品组、报价、价格、库存、FBPI 订单和发货、采购订单、退货查询以及批量导出。使用服务账号和签名 JWT 登录；价格、库存、商品和订单的写入操作在安装时处于关闭状态。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

NOON_KEY_ID, NOON_PRIVATE_KEY, NOON_PROJECT_CODE

步骤 1 — 获取凭证

设置大约需要 5 分钟。你需要一个能登录 noon Partner 门户的 noon.com 卖家账号（阿联酋、沙特阿拉伯或埃及），以及一个用于 noon Partner API 的服务账号密钥。

1. 登录 noon Partner 门户，打开 Access App（或 User & Access > User access），然后点击左侧边栏中的 API Users。
2. 点击 Add Service Account，输入显示名称和用户名，并选择一个角色。只用读取工具时，Project Viewer 就够了；写入工具需要能修改商品目录、价格、库存或订单的角色（Project Owner 拥有全部权限）。你可以把密钥限制在特定 IP 地址并设置有效期；不设置的话，它可以从任何 IP 使用且永不过期。每个合作伙伴只能创建一个服务账号，最多五个密钥。
3. 点击 Add 后会下载一个 .json 密钥文件。它只显示一次；如果丢失，请创建新密钥。
4. 复制该文件中的三个字段：key_id 填入 NOON_KEY_ID，private_key 填入 NOON_PRIVATE_KEY，project_code 填入 NOON_PROJECT_CODE。私钥是完整的 PEM，从 -----BEGIN PRIVATE KEY----- 到 -----END PRIVATE KEY-----；可以粘贴成一行，并原样保留文件中的 \n 序列。
5. 安装连接器并运行 noon_marketplace_whoami：它会显示会话所属的服务账号（用户代码和用户名）。

登录方式：没有固定的 API 密钥。每次登录时，连接器都会用你的私钥签发一个新的 RS256 JWT（以密钥 ID 作为 subject，包含当前时间和一个随机令牌 ID），并连同项目代码发送到 noon 的登录端点。noon 返回会话 Cookie，之后每次调用都会带上它们。会话有效期为 30 天；连接器会在到期前以及任何调用返回 401 时重新登录。此外，每个请求都带有 X-Project 请求头，值为你的项目代码，这是 noon 内容 API 的要求。

标识符：partner_sku 是你自己的 SKU，在你的所有商品中唯一；价格、库存和报价都以它为准。sku_parent（以 Z 开头）是 noon 为包含所有变体的商品分配的 ID，用于内容和商品组。noon SKU（sku，以 N 开头）和 psku_code（以 P 开头）标识单个变体。warehouse_code 来自 noon_marketplace_list_warehouses；FBPI 订单和发货属于某个集成仓库。country_code 为小写的 ae、sa 或 eg，价格按 SKU 和国家设置，币种为 AED、SAR 或 EGP。订单和发货通过 fbpi_order_nr、mp_item_nr（订单中的一个商品行）以及你自己的 integration_shipment_nr 来识别。

可读取的内容：服务账号和你的仓库；noon 商品目录的所有类目代码，以及某个类目要求的属性和属性值的校验规则；商品内容的完整度、QC 状态以及未上线的原因；商品组（在同一页面一起展示的变体）；某个 partner SKU 在各个国家的报价，包括价格、库存、上线状态和导致报价下线的问题；按 SKU 和国家的价格、MSRP（划线参考价）和启用状态；按仓库和 SKU 的库存；FBPI 订单（由你自己的仓库履约）及其商品行、订单的顾客和发货；采购订单；按 AWB 单号或退货条码查找的退货商品；以及商品目录导入的状态。有几个读取操作是带 JSON 请求体的 POST 请求，这是 noon API 的设计方式；它们不会更改任何内容。

批量导出和 AWB：noon_marketplace_list_export_categories 列出可导出的报表类型，noon_marketplace_create_export 启动导出，noon_marketplace_get_export_status 显示文件何时就绪及其 download_url。noon_marketplace_generate_awbs 为交给 noon 快递的包裹生成 AWB（空运单）号码。两者都不会更改数据，因此保持开启。

安装时关闭：noon_marketplace_upsert_product、noon_marketplace_upsert_product_group、noon_marketplace_upsert_prices、noon_marketplace_update_stock、noon_marketplace_mark_items_unavailable、noon_marketplace_create_shipment 和 noon_marketplace_cancel_shipment。价格、库存、商品、订单和发货的写入会改变顾客看到和购买的内容（在售价格、可售数量、已发布的内容），或作用于真实订单，其中一些无法撤销：把商品标记为缺货会为顾客取消这些商品，取消发货会取消其中的所有商品。管理员在连接器的工具设置中开启工作区需要的工具。创建发货后，noon 揽收所需的发货清单（manifest）在 Seller Lab 中完成。

批量结果：价格、库存和商品调用即使部分条目失败也会返回 200，所以请检查每个返回条目的状态，只重发失败的条目。noon_marketplace_update_stock 设置的是绝对数量，不会在当前数量上累加。在 noon_marketplace_upsert_prices 中，省略或以 null 发送的字段会保留原值。以 status_id 3 保存的商品存在内容问题，可用 noon_marketplace_get_content 查看。

限制：列表类工具会返回 next_token，AI 会带上它和相同的筛选条件再次调用，直到它为空。速率限制按项目和端点计算，同时检查主窗口和更短的突发窗口：大多数端点每 60 秒允许 1500 个请求，noon_marketplace_list_warehouses 每 60 秒 30 个，突发上限为每 30 秒 15 个。返回 429 时，请等待 X-Ratelimit-Retry-After 请求头给出的秒数；一次批量调用胜过多次单条调用。

常见错误：401 表示登录或会话失败：密钥 ID 和私钥来自不同的密钥文件，密钥已停用或过期，或者服务器时钟与 noon 的时钟相差超过五分钟，导致 noon 拒绝签名令牌。403 PERMISSION_DENIED 表示服务账号没有该调用所需的角色；请在 Partner 门户的 User Access > Manage Role 中添加。400 INVALID_ARGUMENT 会指出字段和原因。价格条目返回 NOT_FOUND 表示该 SKU 在该国家还没有价格记录，请先设置价格。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Cursor 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目：

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 Cursor。
3. 打开 Cursor → Settings → MCP，确认 anythingmcp 已列出并处于已连接状态。
4. 开始对话，智能体现在可以调用 noon Marketplace 的工具。

可用工具

示例提示

• “检查我们迪拜仓库中 partner SKU TS-100-BLK、TS-100-WHT 和 TS-100-RED 的库存，并标出低于 10 件的。”
• “查看 SKU TS-100-BLK 在阿联酋和沙特阿拉伯的价格：价格、MSRP、每个报价是否在线，以及是什么让报价下线。”
• “列出我们集成仓库今天的 FBPI 订单及其商品行和状态，并告诉我哪些还没有发货。”
• “告诉我可以导出哪些报表类型，启动我选的那个，并持续检查状态，直到下载链接就绪。”
• “在上架一款新手机壳之前，找到合适的类目代码，并告诉我哪些属性是必填的，哪些需要英文和阿拉伯文两种值。”

FAQ

Cursor 免费套餐支持自定义 MCP 服务器吗？ 支持，Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Gemini
• 连接到 Meta Muse
• 连接到 Microsoft Copilot