Amazon Shipping MCP 接入 Gemini CLI

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

Amazon Shipping + Gemini

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

前提条件

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

SPAPI_CLIENT_ID, SPAPI_CLIENT_SECRET, SPAPI_REFRESH_TOKEN, SPAPI_ENDPOINT, AMAZON_SHIPPING_BUSINESS_ID

第一步 — 获取凭据

设置大约需要 20 分钟。你需要加上 Amazon 评价。

1. 你需要一个 Amazon Shipping 账户。Amazon 的卖家使用他们的 Seller Central 账户；其他发货人可以在 https://solutionproviderportal.amazon.com 创建账户（无需卖家账户）并完成开发者身份验证。
2. 完成开发者资料：在 数据访问 中选择 私有开发者：我构建与 Amazon 服务 API 集成的应用，在 角色 中选择 Amazon Logistics。Amazon 会在大约 5 个工作日内回复。
3. 创建一个名为 AmazonShipping_YourCompany 的 SP-API 应用客户端，选择 Shipping 业务实体和 Amazon Logistics 角色，并对委托受限（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 Shipping 国家。美国：北美。英国、法国、意大利、西班牙、印度、阿联酋、沙特阿拉伯、埃及：欧洲。日本：远东。

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

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

从哪里开始：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 Shipping 账户。传递一个幂等性密钥，并在重试时重用，以免超时导致重复购买。

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

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

第二步 — 安装适配器

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

第三步 — 在 Gemini 中添加连接器

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

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list）— anythingmcp 应显示为已连接。
4. 开始输入提示 — Gemini CLI 现在可以调用 Amazon Shipping 的工具。

可用工具

示例提示

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

常见问题

凭据来自哪里？ 来自具有 Amazon Logistics 角色的私有 SP-API 应用，在 Seller Central 创建，或者在没有卖家账户的情况下，在 Amazon 解决方案提供商门户中创建。复制 LWA 客户端 ID 和密钥，授权应用访问你自己的账户以获取刷新令牌，并选择你的区域和 Amazon Shipping 国家。

它覆盖哪些国家？ Amazon Shipping 运行的国家：美国、英国、法国、意大利、西班牙、印度、阿联酋、沙特阿拉伯、埃及和日本。适用于使用 Amazon 作为承运人的包裹，也适用于不来自 Amazon 的订单。

它可以购买标签或取消发货吗？ amazon_shipping_purchase_shipment、amazon_shipping_direct_purchase_shipment、amazon_shipping_one_click_shipment、amazon_shipping_cancel_shipment 和 amazon_shipping_generate_collection_form 安装时处于关闭状态。仅在 AI 应该使用它们时在连接器页面上打开它们。

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器登录页面
• 连接到 Claude