连接器指南阅读约 2 分钟16 个 MCP 工具7 种语言

UPS MCP服务器:追踪、运费与网点

UPS API 供发货人使用:通过追踪号码或参考跟踪包裹,验证美国地址,比较费率和运输时间,查找投递和接入点位置,估算到岸成本,恢复标签和报价取件。包括货件创建、作废和取件,但已关闭。来自 UPS 开发者门户的 OAuth 客户端 ID 和密钥。

HC作者:HelpCode 团队更新于 2 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

UPS

UPS

UPS APIs for shippers: track packages by tracking number or reference, validate US addresses, compare rates and transit times, find drop-off and Access Point locations, estimate landed cost, recover labels and quote pickups. Shipment creation, voids and pickups are included but switched off. OAuth client ID and secret from the UPS Developer Portal.

个工具

16

区域

INTL

类别

物流

身份验证

OAuth 2.0

所需环境变量

UPS_CLIENT_IDUPS_CLIENT_SECRETUPS_ACCOUNT_NUMBER
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

摘要

UPS API 供发货人使用:通过追踪号码或参考跟踪包裹,验证美国地址,比较费率和运输时间,查找投递和接入点位置,估算到岸成本,恢复标签和报价取件。包括货件创建、作废和取件,但已关闭。来自 UPS 开发者门户的 OAuth 客户端 ID 和密钥。

引导式设置

2 分钟将 UPS 连接到 Claude、ChatGPT 或 Copilot

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 UPS,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。

无需信用卡 · 7 天试用 · 提供自托管方案

试试这样问

UPS 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

UPS · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

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

UPS

UPS API 供发货人使用:通过追踪号码或参考跟踪包裹,验证美国地址,比较费率和运输时间,查找投递和接入点位置,估算到岸成本,恢复标签和报价取件。货件创建、作废和取件包括在内,但已关闭。来自 UPS 开发者门户的 OAuth 客户端 ID 和密钥。

设置

设置大约需要 10 分钟。

  1. 使用拥有你的发货账户的 ups.com 个人资料登录 https://developer.ups.com(如有需要,请先注册一个),并打开创建应用程序的页面。
  2. 表示你想将 UPS 技术集成到自己的业务中,选择应用程序应计费的 UPS 账户号码,并命名应用程序。
  3. 添加连接器使用的产品:跟踪、地址验证、费率、运输时间、定位器,以及对于已关闭的工具,运输、取件和到岸成本报价。缺少的产品仅对其工具返回 401 或 403。
  4. 将 客户端 ID 复制到 UPS_CLIENT_ID,将 客户端密钥 复制到 UPS_CLIENT_SECRET。
  5. 将你的 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 接入点位置。"

下一步

这份指南对你有帮助吗?

2 分钟将 UPS 连接到 Claude、ChatGPT 或 Copilot

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 UPS,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。

相关指南

连接器

将 UPS MCP 接入 ChatGPT

UPS API 供发货人使用:通过追踪号码或参考追踪包裹,验证美国地址,比较运费和运输时间,查找投递和接入点位置,估算到岸成本,恢复标签和报价取件。包括货物创建、作废和取件,但已关闭。来自 UPS 开发者门户的 OAuth 客户端 ID 和密钥。

连接器

将 UPS MCP 接入 Claude

UPS API 供发货人使用:通过追踪号码或参考追踪包裹,验证美国地址,比较运费和运输时间,查找投递和接入点位置,估算到岸成本,恢复标签和报价取件。包括货物创建、作废和取件,但已关闭。来自 UPS 开发者门户的 OAuth 客户端 ID 和密钥。

连接器

将 UPS MCP 接入 Microsoft Copilot

UPS API 供发货人使用:通过追踪号码或参考追踪包裹,验证美国地址,比较运费和运输时间,查找投递和接入点位置,估算到岸成本,恢复标签和报价取件。包括货物创建、作废和取件,但已关闭。来自 UPS 开发者门户的 OAuth 客户端 ID 和密钥。

连接器

将 UPS MCP 接入 Cursor

UPS API 供发货人使用:通过追踪号码或参考追踪包裹,验证美国地址,比较运费和运输时间,查找投递和接入点位置,估算到岸成本,恢复标签和报价取件。包括货物创建、作废和取件,但已关闭。来自 UPS 开发者门户的 OAuth 客户端 ID 和密钥。

连接器

将 UPS MCP 接入 Gemini CLI

UPS API 供发货人使用:通过追踪号码或参考追踪包裹,验证美国地址,比较运费和运输时间,查找投递和接入点位置,估算到岸成本,恢复标签和报价取件。包括货物创建、作废和取件,但已关闭。来自 UPS 开发者门户的 OAuth 客户端 ID 和密钥。

连接器

将 UPS MCP 接入 Meta Muse

UPS API 供发货人使用:通过追踪号码或参考追踪包裹,验证美国地址,比较运费和运输时间,查找投递和接入点位置,估算到岸成本,恢复标签和报价取件。包括货物创建、作废和取件,但已关闭。来自 UPS 开发者门户的 OAuth 客户端 ID 和密钥。