AliExpress MCP 连接 Claude：卖家订单

💡 不需要安装？直接使用 cloud.anythingmcp.com。 登录，点击 Connectors → AliExpress Seller，粘贴应用密钥和密钥，点击 Authorize 并使用商店的卖家账户登录，生成一个 MCP API 密钥，完成。无需 Docker，无需 git clone，无需本地服务器。

AliExpress 卖家 + Claude

让你的 AI 运营你的 AliExpress 商店：订单和送货地址、使用你自己的承运人的运输申报、带有价格和库存的产品、类别、争议和结算报表。使用你在 AliExpress 开放平台上的卖家应用。

前提条件

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

ALIEXPRESS_SELLER_APP_KEY, ALIEXPRESS_SELLER_APP_SECRET

步骤 1 — 获取凭证

你需要的：一个 AliExpress 卖家账户、一个 AliExpress 开放平台上的开发者账户，以及一个属于 Seller-inhouse Developer 类别的应用。AliExpress 会审核开发者资料，并必须批准该应用类别才能创建应用：只有 AliExpress 能加快此过程，并且可能会拒绝。其中文 FAQ 指出开发者审核需要 2 到 5 个工作日；类别的审核时间未给出。

1. 在 https://openservice.aliexpress.com 点击 Create Account（或登录）。然后在你的用户 ID 下完成个人资料，Profile：选择开发者类型，填写字段并上传 AliExpress 要求的文件。AliExpress 会审核该资料。
2. 打开 App Console 并点击 Create。在应用类别列表中点击 Apply 选择 Seller-inhouse Developer（为自己使用的 AliExpress 卖家构建的应用），在 Reason 字段中写明你需要它的原因，然后点击 OK。该类别在 AliExpress 批准之前显示为 Pending，批准后显示为 Active。每个类别只能创建一个应用。
3. 在批准的类别上点击 Create App。输入应用名称，并将此服务器的地址作为回调 URL，后面加上 /api/iop-auth/callback（在 AnythingMCP Cloud 上为 https://cloud.anythingmcp.com/api/iop-auth/callback），然后点击 Submit。
4. 点击 APP Overview，然后在你的应用上点击 Manage。将 App Key 复制到 ALIEXPRESS_SELLER_APP_KEY 中。在 Basic Information 下点击 View，将 App Secret 复制到 ALIEXPRESS_SELLER_APP_SECRET 中。
5. 在同一页面查看 API Permission Group：标记为 Inactive 的组必须通过 Apply 和理由请求，才能使其 API 响应。
6. 在 App Console, App Management, Auth Management 下输入你的商店的卖家账户到卖家授权白名单中并提交。自开发的应用最多可以绑定 50 个商店，并且只能绑定与开发者合法相关的商店：同一公司、母公司和子公司、同一母公司，或同一法定代表人或控股股东。
7. 在连接器页面点击 Authorize。AliExpress 会显示其登录页面：选择国家，输入商店的卖家账户和密码，然后点击 Sign in And Authorize。你会自动返回到 AnythingMCP。

令牌生命周期：AnythingMCP 将访问令牌和刷新令牌加密保存，从 AliExpress 的响应中读取它们的有效期（expires_in 和 refresh_expires_in，单位为秒），并自动更新访问令牌。更新会带来新的刷新令牌，但不会改变刷新令牌的到期日期。当到达该日期时（或 AliExpress 返回 refresh_expires_in 为 0），再次点击 Authorize。Auth Management 页面显示你的应用的持续时间；AliExpress 的中文指南指出自开发的卖家应用的访问令牌为 365 天，刷新令牌为 730 天。

如何签名：每个调用都发送到 /sync，method 中包含 API 名称，此外还有 app_key、access_token、毫秒级的 timestamp、sign_method=sha256 和 sign，后者是所有按名称排序的参数的 HMAC-SHA256 大写，使用 App Secret 作为密钥。密钥不会离开 AnythingMCP。

从哪里开始

• 商店：aliexpress_seller_get_seller_profile（卖家 ID、国家、报价货币、产品数量）和 aliexpress_seller_get_shop_info（商店 ID、名称和 URL）。
• 订单：aliexpress_seller_list_orders 使用 order_status WAIT_SELLER_SEND_GOODS 列出需要发货的订单；aliexpress_seller_get_order 提供金额、子订单和跟踪信息；aliexpress_seller_get_order_receipt_info 提供送货地址。
• 使用你自己的承运人进行运输：aliexpress_seller_list_order_shipping_services 指出每个子订单是否使用你自己的承运人（DBS）或平台物流；aliexpress_seller_list_shipment_providers 提供承运人代码；aliexpress_seller_declare_shipment 将承运人和跟踪号码发送给 AliExpress，不收取费用；aliexpress_seller_modify_shipment 进行更正（最多两次，在十天内）。aliexpress_seller_list_packages 显示包裹及其状态。
• 平台物流（安装时关闭，因为它们为商店订购物流服务）：aliexpress_seller_list_seller_addresses 用于提货地址，aliexpress_seller_pack_order 创建包裹，aliexpress_seller_ship_platform_package 交接包裹，aliexpress_seller_cancel_package 撤销包裹。打印运单不包括在内：AliExpress 将其作为文件返回，需从卖家中心打印。
• 产品：aliexpress_seller_list_products 按状态，aliexpress_seller_get_product 每个 SKU，aliexpress_seller_update_prices 和 aliexpress_seller_update_stock 按 sku_code，aliexpress_seller_set_products_online 和 aliexpress_seller_set_products_offline（关闭）。发布、编辑和删除产品不包括在内。
• 目录设置：aliexpress_seller_list_categories、aliexpress_seller_list_publishable_categories 和 aliexpress_seller_list_freight_templates。
• 争议：aliexpress_seller_list_disputes 和 aliexpress_seller_get_dispute 是读取操作。aliexpress_seller_accept_dispute_solution 被关闭：接受提案是具有约束力的，并可能会退款给买家。
• 资金：aliexpress_seller_list_settlement_bills 列出结算报表。连接器本身不会支付、退款或提款。

ID 和格式

• 订单、子订单、产品和争议 ID 是长数字：作为文本传递，仅数字。子订单 ID（订单列表中的 child_id，订单的 child_order_list 中的 id）是运输工具称之为 tradeOrderItemId 的内容。
• 订单时间为 美国太平洋时间，格式为 yyyy-MM-dd HH:mm:ss。包裹和争议过滤器使用 Unix 时间（毫秒）。结算周期的格式为 YYYY/MM/dd，其发布日期为 Unix 毫秒。
• 金额是包含 amount（十进制字符串）和 currency_code 的对象；你发送的价格是产品货币中的十进制字符串。
• 列表从 1 开始：每页最多 50 个订单和争议，包裹最多 50 个，产品少于 100 个。价格和库存更新最多处理 20 个产品，每个产品 200 个 SKU。
• order_status FINISH 包括已完成和已关闭的订单，仅在请求时返回。endReason 在其子订单的 extend_map 中区分它们。

响应和错误：结果位于 aliexpress_..._response（API 名称加下划线）。许多调用返回 200，并在内部携带自己的裁决：result.success 及 errorCode 和 errorMessage（或 error_code 和 error_message），update_success 及 update_failed_list 用于价格和库存更新。在告诉用户写入成功之前，请始终读取它。网关的拒绝以 error_response 形式返回，带有 code：IllegalAccessToken 表示授权结束（AnythingMCP 会更新令牌一次并重试），InvalidAppkey 或 IncompleteSignature 表示密钥和密钥不匹配，InsufficientPermission 表示应用缺少 API 权限组，以及当应用类别的配额用尽时的调用限制代码。

步骤 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 — 在 Claude 中添加连接器

你的服务器 URL：在 AnythingMCP 中，打开 MCP Servers → 该连接器所在的服务器，并复制其 URL（https://cloud.anythingmcp.com/mcp/…）。在本指南中显示 YOUR_SERVER_ID 的地方使用它。

推荐路径：在 claude.ai web 上工作，无需编辑任何配置文件。

1. 在 Claude 中，打开 Customize → Connectors。
2. 点击 +，然后 Add custom connector。
3. 输入名称，例如 AliExpress Seller，以及远程 MCP 服务器 URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID，然后点击 Add。
4. 点击 Connect 并登录到 AnythingMCP（OAuth）以允许访问。

以下所有工具会出现在你的聊天中：开始输入提示。

可用工具

示例提示

• "哪些 AliExpress 订单在等待我发货？"
• "声明订单 8187654321098765 的运输，使用 Cainiao 跟踪 LP00123456789012。"
• "哪些争议是开放的，买家要求什么？"
• "将 SKU AE-CASE-14-BLK 的库存设置为 300，价格设置为 4.99 美元。"
• "显示上个月的结算报表。"

常见问题

它是否适用于 Claude Code 和 Claude Desktop？ 是的，两个都指向 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。

我需要粘贴访问令牌吗？ 不需要。你粘贴的是你的 Seller-inhouse Developer 应用的 App Key 和 App Secret，将商店添加到应用的卖家白名单中，然后在连接器页面点击 Authorize。AliExpress 的登录页面会要求输入商店的卖家账户，连接器会自行保存和更新令牌。

它覆盖了什么，覆盖了什么不？ 订单和送货地址、使用你自己的承运人的运输申报、包裹、带有价格和库存的产品、类别、运费模板、争议和结算报表。发布或编辑产品和买家消息不在覆盖范围内。

哪些工具安装时关闭？ 平台物流工具（aliexpress_seller_pack_order、aliexpress_seller_ship_platform_package、aliexpress_seller_cancel_package）、aliexpress_seller_set_products_offline 和 aliexpress_seller_accept_dispute_solution。仅在 AI 应该使用它们时在连接器页面上开启。

下一步

• 连接器着陆页
• 连接到 ChatGPT
• 连接到 Cursor
• 连接到 Gemini
• 连接到 Meta Muse
• 连接到 Microsoft Copilot