Amazon Vendor Central MCP 连接 Cursor

💡 没有安装？直接使用 cloud.anythingmcp.com。 登录，点击 Connectors → Amazon Vendor Central，粘贴你的凭据，生成一个 MCP API 密钥，完成。无需 Docker，无需 git clone，无需本地服务器。

Amazon Vendor Central + Cursor

通过销售合作伙伴 API 的 Amazon Vendor Central：零售采购订单、确认、发货确认、发票、带标签的直接履行订单、装箱单和库存、交易状态和供应商报告。使用私有供应商应用的 Amazon 刷新令牌登录。

前提条件

请查看连接器中包含的完整设置说明（在选择连接器时可在应用内商店中查看）。此连接器所需的环境变量为：

SPAPI_CLIENT_ID, SPAPI_CLIENT_SECRET, SPAPI_REFRESH_TOKEN, SPAPI_ENDPOINT, SPAPI_MARKETPLACE_ID

第 1 步 — 获取凭据

设置大约需要 20 分钟。你需要通过 Amazon 对开发者资料的审核。

1. 在 Vendor Central 中打开 Integration，然后选择 API Integration，并完成 Developer Profile。在 Data Access 下选择 Private Developer: I build application(s) that integrate my own company with Amazon Services APIs，选择所需的角色并点击 Register。Amazon 会审核该资料并开启后续步骤的案例。
2. 在同一页面选择 Add new app client，填写表单，勾选 Amazon 提供的 Vendors 选项，并选择角色。然后在 LWA credentials 下选择 View，将客户端标识符复制到 SPAPI_CLIENT_ID，将客户端密钥复制到 SPAPI_CLIENT_SECRET。
3. 选择 Authorize app 为你的供应商账户授权。Amazon 会显示一个 refresh token（以 Atzr| 开头）：将其粘贴到 SPAPI_REFRESH_TOKEN。
4. 在 SPAPI_ENDPOINT 中选择你的区域（北美、欧洲或远东），并在 SPAPI_MARKETPLACE_ID 中输入你的 Amazon 商店的市场 ID，例如 ATVPDKIKX0DER（美国）、A1PA6795UKMFR9（德国）、A1F83G8C2ARO7P（英国）、APJ6JRA9NG5V4（意大利）、A13V1IB3VIYZZH（法国）、A1RKKUPIHCS9HS（西班牙）、A1VC38T7YXB528（日本）。

角色：零售工具需要角色 Amazon Fulfillment。直接履行工具需要 Direct-to-Consumer Shipping (Restricted)，这是一个受限角色，因为订单包含客户地址；Amazon 在授予之前会要求提供更多关于数据保护的信息。供应商报告需要 Brand Analytics。没有角色的调用会返回 403。

从哪里开始：amazon_vendor_list_purchase_orders 与 purchase_order_state New 显示 Amazon 订购的内容；amazon_vendor_get_purchase_order 提供完整的订单信息。

零售采购：amazon_vendor_list_purchase_orders、amazon_vendor_get_purchase_order、amazon_vendor_list_purchase_order_statuses（接受和接收的数量）。通过 amazon_vendor_submit_acknowledgements 回复订单，通过 amazon_vendor_submit_shipment_confirmations 宣布发货，然后使用 amazon_vendor_list_shipments 和 amazon_vendor_list_transport_labels 跟踪。确认和发货确认是对 Amazon 的约束性回复，因此 amazon_vendor_submit_acknowledgements 和 amazon_vendor_submit_shipment_confirmations 默认关闭，amazon_vendor_submit_invoices 也是：当 AI 应该发送它们时，请在连接器页面上将它们打开；它会要求你确认每一个。

直接履行（你将货物发给 Amazon 的客户）：amazon_vendor_list_df_orders、amazon_vendor_get_df_order、amazon_vendor_acknowledge_df_orders、amazon_vendor_list_df_packing_slips、amazon_vendor_get_df_packing_slip、amazon_vendor_list_df_customer_invoices、amazon_vendor_list_df_shipping_labels、amazon_vendor_get_df_shipping_label、amazon_vendor_submit_df_shipment_confirmations 和 amazon_vendor_update_df_inventory。创建标签的运输：amazon_vendor_request_df_shipping_labels 和 amazon_vendor_create_df_shipping_labels 默认关闭，amazon_vendor_acknowledge_df_orders、amazon_vendor_submit_df_shipment_confirmations 和 amazon_vendor_submit_df_invoices 也是。

提交是异步的：每个提交工具都会返回一个 transactionId，没有其他信息。使用 amazon_vendor_get_transaction_status（零售）或 amazon_vendor_get_df_transaction_status（直接履行）读取结果：处理、成功或失败及错误。在结果显示成功之前，不要报告提交已完成。

报告（3 步）：amazon_vendor_create_report，然后 amazon_vendor_get_report 直到完成，然后 amazon_vendor_download_report_document。

字段说明：列表调用每次最多覆盖 7 天；直接履行列表需要同时提供 created_after 和 created_before。时间格式为 ISO 8601。数量带有单位（零售为箱或每个，直接履行为每个）；货币为带货币代码的十进制字符串。partyId 是你的销售方供应商代码和发货方及收货方的仓库代码。列表页面带有 pagination.nextToken。

速率限制：每个操作每秒 10 次调用，突发 10 次（交易状态：突发 20 次）。在 429 错误时稍等片刻再调用。

第 2 步 — 安装适配器

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. 开始对话 — 智能体现在可以调用 Amazon Vendor Central 的工具。

可用工具

示例提示

• "本周有哪些新的 Amazon 采购订单，要求的数量是多少？"
• "显示采购订单 2JK3S9VC 及其项目和发货窗口。"
• "哪些直接履行订单仍需发货标签？"
• "检查交易 12345-abcde：Amazon 是否接受了我提交的发票？"
• "请求上周的供应商销售报告，并告诉我何时准备好。"

常见问题

凭据来自哪里？ 来自 Vendor Central 中的私有应用（Integration，API Integration），在 Amazon 审核你的开发者资料后。复制 LWA 客户端 ID 和密钥，选择授权应用以获取刷新令牌，并输入你的区域和市场 ID。无需 AWS 密钥。

需要哪些角色？ 零售工具需要 Amazon Fulfillment，直接履行工具需要受限角色 Direct-to-Consumer Shipping，报告需要 Brand Analytics。这是针对供应商（1P）；在 Seller Central 上的卖家使用 Amazon Seller Central 连接器。

哪些工具默认关闭？ 对 Amazon 的约束性回复：amazon_vendor_submit_acknowledgements、amazon_vendor_submit_shipment_confirmations、amazon_vendor_submit_invoices、amazon_vendor_acknowledge_df_orders、amazon_vendor_request_df_shipping_labels、amazon_vendor_create_df_shipping_labels、amazon_vendor_submit_df_shipment_confirmations 和 amazon_vendor_submit_df_invoices。当 AI 应该发送它们时，请在连接器页面上将它们打开。

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

下一步

• 连接器着陆页
• 连接到 Claude