Amazon Shipping MCP 服务器：运费、追踪与面单

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

Amazon 运输

适用于使用 Amazon 作为承运人的企业的 Amazon 运输 API v2 (SP-API)：比较费率、跟踪包裹、重新获取标签和文档、查找储物柜和取件柜台，以及阅读收集表单。购买、单击购买和取消功能包含但已关闭。具有 Amazon 物流角色的私人 SP-API 应用。

设置

设置大约需要 20 分钟。你需要额外的 Amazon 评价。

1. 你需要一个 Amazon 运输账户。Amazon 上的卖家使用他们的卖家中心账户；其他发货人可以在 https://solutionproviderportal.amazon.com 创建账户（不需要卖家账户）并完成开发者身份验证。
2. 完成开发者资料：在 数据访问 中选择 私人开发者：我构建与 Amazon 服务 API 集成的应用，在 角色 中选择 Amazon 物流。Amazon 会在大约 5 个工作日内回复。
3. 创建一个名为 AmazonShipping_YourCompany 的 SP-API 应用客户端，选择 运输 业务实体和 Amazon 物流 角色，并对委托受限（PII）数据访问回答 否。
4. 在 LWA 凭据 下选择 查看，将客户端标识符 (amzn1.application-oa2-client.…) 复制到 SPAPI_CLIENT_ID，将客户端密钥复制到 SPAPI_CLIENT_SECRET。
5. 授权应用访问你自己的账户（授权应用），并将刷新令牌 (Atzr|…) 复制到 SPAPI_REFRESH_TOKEN。
6. 在 SPAPI_ENDPOINT 中选择区域，在 AMAZON_SHIPPING_BUSINESS_ID 中选择你的 Amazon 运输国家。美国：北美。英国、法国、意大利、西班牙、印度、阿联酋、沙特阿拉伯、埃及：欧洲。日本：远东。

该连接器在 https://api.amazon.com/auth/o2/token 处用刷新令牌交换一个小时的访问令牌，并在 x-amz-access-token 头中发送；x-amzn-shipping-business-id 头携带国家。变量的名称与 Amazon 卖家中心连接器中的名称相同，但应用必须具有 Amazon 物流角色：没有该角色的销售应用的凭据会返回 403。

在第一次真实标签之前：Amazon 要求每个新集成都生成一个测试标签并获得批准（Amazon 运输测试标签指南），然后确认第一次发货日期。在完成之前，请保持购买工具关闭。

从哪里开始：amazon_shipping_get_rates，提供发货地址、目的地和一个包裹，返回服务和价格；amazon_shipping_get_tracking 通过跟踪 ID 和承运人 ID 跟踪包裹。

费率：amazon_shipping_get_rates 每个包裹需要一个你自己的 packageClientReferenceId、尺寸、重量、保险价值和至少一个物品。channel_details.channelType 对于来自你自己商店的订单为 EXTERNAL，对于 Amazon 订单为 AMAZON（带有 Amazon 订单 ID）。响应中携带一个 requestToken 和每个服务一个 rateId；两者在购买时都需要，并在 10 分钟后过期。当费率显示 requiresAdditionalInputs 时，请使用 amazon_shipping_get_additional_inputs 阅读模式。

跟踪和文档：amazon_shipping_get_tracking 返回摘要状态和事件历史；amazon_shipping_get_shipment_documents 再次返回购买包裹的标签（base64），需要发货 ID 和你的 packageClientReferenceId。amazon_shipping_get_access_points 查找邮政编码附近的储物柜和柜台。

收集表单：amazon_shipping_get_unmanifested_shipments 显示仍在等待清单的内容，amazon_shipping_get_collection_form_history 和 amazon_shipping_get_collection_form 读取早期表单，amazon_shipping_get_carrier_accounts 列出关联的承运人账户。amazon_shipping_generate_collection_form 关闭承运人的开放发货，并且安装时默认关闭。

购买（已关闭）：amazon_shipping_purchase_shipment 购买费率，amazon_shipping_one_click_shipment 通过服务 ID 购买，无需费率请求，amazon_shipping_direct_purchase_shipment 为 Amazon 订单购买，服务由 Amazon 选择，amazon_shipping_cancel_shipment 在交付之前取消已购买的发货。每次购买都计入 Amazon 运输账户。传递一个幂等性密钥，并在重试时重用，以便超时不会重复购买。

格式：金额是带有 value 和 unit（货币）的对象；重量使用克、千克、盎司或磅，尺寸使用英寸或厘米；时间为 ISO 8601。响应被包装在 payload 中；失败以 errors 的形式返回，包含 code、message 和 details 的列表。

限制：大多数操作每秒 80 次调用，突发可达 100；响应头 x-amzn-RateLimit-Limit 显示应用的限制。429 表示等待并重试。

先决条件：SPAPI_CLIENT_ID、SPAPI_CLIENT_SECRET、SPAPI_REFRESH_TOKEN、SPAPI_ENDPOINT、AMAZON_SHIPPING_BUSINESS_ID

本地安装连接器

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

打开 http://localhost:3000/connectors/store，选择 Amazon Shipping 并粘贴在先决条件下列出的环境变量。

可用工具

示例提示

• “比较从曼彻斯特 M1 1AE 到伦敦 SW1A 1AA 的 2 公斤包裹的 Amazon 运输费率。”
• “跟踪 Amazon 运输包裹 QA0123456789，并告诉我最后一次扫描。”
• “查找邮政编码 EC1A 1BB 附近的 Amazon 储物柜。”
• “再次获取我今天早上购买的发货的标签。”
• “哪些发货尚未在收集表单上？”

下一步

• 连接到 Claude
• 连接到 ChatGPT