摘要
UPS API 供发货人使用:通过追踪号码或参考跟踪包裹,验证美国地址,比较费率和运输时间,查找投递和接入点位置,估算到岸成本,恢复标签和报价取件。包括货件创建、作废和取件,但已关闭。来自 UPS 开发者门户的 OAuth 客户端 ID 和密钥。
引导式设置
2 分钟将 UPS 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 UPS,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
UPS 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 不需要安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → UPS,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
UPS
UPS API 供发货人使用:通过追踪号码或参考跟踪包裹,验证美国地址,比较费率和运输时间,查找投递和接入点位置,估算到岸成本,恢复标签和报价取件。货件创建、作废和取件包括在内,但已关闭。来自 UPS 开发者门户的 OAuth 客户端 ID 和密钥。
设置
设置大约需要 10 分钟。
- 使用拥有你的发货账户的 ups.com 个人资料登录 https://developer.ups.com(如有需要,请先注册一个),并打开创建应用程序的页面。
- 表示你想将 UPS 技术集成到自己的业务中,选择应用程序应计费的 UPS 账户号码,并命名应用程序。
- 添加连接器使用的产品:跟踪、地址验证、费率、运输时间、定位器,以及对于已关闭的工具,运输、取件和到岸成本报价。缺少的产品仅对其工具返回 401 或 403。
- 将 客户端 ID 复制到
UPS_CLIENT_ID,将 客户端密钥 复制到UPS_CLIENT_SECRET。 - 将你的 6 位 UPS 账户号码(发货人号码)放入
UPS_ACCOUNT_NUMBER。
连接器在 https://onlinetools.ups.com/security/v1/oauth/token(客户端凭据,HTTP Basic)交换客户端 ID 和密钥以获取短期有效的承载令牌,并自行续订。这些是生产凭据;不使用 UPS 测试系统(wwwcie.ups.com)。
从哪里开始:使用追踪号码的 ups_track_package。要获取价格,ups_shop_rates 比较两个地址之间的所有服务,ups_get_rate 为一种服务定价;ups_get_time_in_transit 提供没有价格的交货日期。
跟踪:ups_track_package(任何追踪号码),ups_track_by_reference(你在账户内放置的参考,例如订单号),以及 ups_track_shipment_packages(多包裹货件的所有包裹)。日期格式为 YYYYMMDD,时间格式为 HHMMSS,以扫描的本地时间为准;gmtDate、gmtTime 和 gmtOffset 提供相同时刻的 UTC 时间。从 currentStatus.description 读取状态,从 activity 读取扫描,最新的在前。
地址和位置:ups_validate_address 仅覆盖美国和波多黎各的街道地址。ups_find_locations 查找 UPS 服务的任何国家中靠近地址的投递地点和 UPS 接入点位置。
费率:ups_shop_rates 和 ups_get_rate 将你的账户号码作为发货人号码发送。默认情况下返回已发布的费率;传递 rating_options 和 NegotiatedRatesIndicator 以查看你账户的合同费率在 NegotiatedRateCharges 中。金额为字符串,单位为旁边命名的货币。重量为 LBS 或 KGS,尺寸为 IN 或 CM:使用原产国的单位。ups_quote_landed_cost 估算跨境货件的关税和税费,最好为每个项目提供一个 HS 代码。
标签和货件:ups_recover_label 再次返回现有货件的标签且不收费。ups_create_shipment 创建一个 UPS 向账户收费的货件,ups_void_shipment 在取件前取消一个;两者均已关闭。仅在助手应创建真实货件时在连接器中启用它们。UPS 字段名称在调用之间有所不同:费率工具称包装为 PackagingType,发货工具称为 Packaging。
取件:ups_get_pickup_rate 报价一次按需取件,ups_get_pending_pickups 列出已预订但尚未发生的取件。ups_create_pickup 以费用预订司机,ups_cancel_pickup 通过 PRN 取消;两者均已关闭。
错误:UPS 通过 response.errors 返回,包含 code 和 message 的列表。401 表示凭据或令牌被拒绝,403 表示应用程序无权访问该产品或 UPS 阻止了账户,404 表示 UPS 尚无该号码的跟踪数据(标签在第一次扫描后或创建后几个小时显示),429 表示应用程序的配额已用完。
限制:UPS 为每个应用程序和产品设置配额,并未在其 API 文件中发布数字;429 表示等待并稍后重试。每次调用跟踪一个号码是文档化的用法:不要快速循环长列表。
先决条件:UPS_CLIENT_ID、UPS_CLIENT_SECRET、UPS_ACCOUNT_NUMBER
本地安装连接器
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,选择 UPS 并粘贴在先决条件下列出的环境变量。
可用工具
| 工具 | 功能 |
|---|---|
ups_track_package | 通过追踪号码跟踪一个 UPS 包裹:当前状态及代码和描述,每次扫描(日期格式为 YYYYMMDD,本地时间为 HHMMSS… |
ups_track_by_reference | 通过你在货件上放置的参考号码(订单号、发票号)查找和跟踪你的 UPS 账户的货件。返回相同… |
ups_track_shipment_packages | 通过其中一个追踪号码跟踪多包裹 UPS 货件的每个包裹:每个包裹的追踪号码、当前状态、最后… |
ups_validate_address | 根据 UPS 数据检查美国或波多黎各的街道地址。返回 ValidAddressIndicator、AmbiguousAddressIndicator… |
ups_get_rate | 为一个货件定价一种 UPS 服务。返回 RateResponse.RatedShipment,包含服务代码、计费重量、运输、服务… |
ups_shop_rates | 比较两个地址之间可用的每种 UPS 服务。返回每种服务的一个 RatedShipment,包含其代码、计费… |
ups_get_time_in_transit | 列出两个地点之间可用的 UPS 服务,位于 emsResponse.services 下:serviceLevel 和 serviceLevelDescription… |
ups_find_locations | 查找靠近地址的 UPS 投递地点:UPS 接入点位置、UPS 商店、客户中心和投递箱。返回… |
ups_quote_landed_cost | 在货件发出前估算国际货件的关税、税费和代理费用(UPS 到岸成本报价)。按商品返回… |
ups_recover_label | 通过追踪号码再次获取已存在货件的标签。返回 LabelRecoveryResponse.LabelResults,标签作为… |
ups_get_pickup_rate | 报价在地址上的一次按需 UPS 取件的费用,而不进行预订。返回 PickupRateResponse.RateResult,包含费率类型… |
ups_get_pending_pickups | 列出你 UPS 账户上尚未发生的已预订取件。返回 PickupPendingStatusResponse.PendingStatus,包含取件… |
ups_create_shipment | 创建一个 UPS 货件及其标签。UPS 在此调用成功后立即向你的账户收费,因此该工具已… |
ups_void_shipment | 作废(取消)一个已创建但尚未取件的 UPS 货件,或其单个包裹。无法撤销:标签变为… |
ups_create_pickup | 预订一次按需 UPS 取件:司机在指定日期到达给定地址。UPS 向你的账户收取取件费用,因此该工具… |
ups_cancel_pickup | 通过其取件请求号码(PRN)取消已预订的 UPS 取件。无法撤销;必须重新预订新的取件。返回… |
示例提示
- "UPS 包裹 1Z999AA10123456784 在哪里?"
- "比较从芝加哥 60601 到奥斯丁 78701 的 UPS 费率,适用于 5 磅的箱子。"
- "1600 Amphitheatre Pkwy, Mountain View, CA 94043 是有效地址吗?"
- "如果今天发货,从亚特兰大发出的 UPS Ground 包裹何时到达西雅图?"
- "查找靠近 10115 柏林的 UPS 接入点位置。"
下一步
这份指南对你有帮助吗?