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

将 UPS MCP 接入 Claude

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

HC作者:HelpCode 团队更新于 3 分钟阅读 在 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

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

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

AnythingMCP 已收录在 Claude 的连接器目录中:一键添加到 Claude (在新标签页中打开),然后登录并选择 Claude 可以使用哪些 MCP 服务器。

试试这样问

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 + Claude

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

前提条件

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

UPS_CLIENT_ID, UPS_CLIENT_SECRET, UPS_ACCOUNT_NUMBER

第一步 — 获取凭据

设置大约需要 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 和密钥以获取短期有效的 Bearer 令牌,并自行续订。这些是生产凭据;不使用 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 接入点位置。

运费: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 表示稍后等待并重试。每次调用追踪一个号码是文档使用:请勿快速循环长列表。

第二步 — 安装适配器

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

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

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

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

  1. 在 Claude 中,打开 Plugins(部分套餐仍显示为 Customize)→ Connectors。
  2. 点击 + Add,然后选择 Add custom connector。
  3. 输入名称,例如 UPS,以及远程 MCP 服务器 URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,然后点击 Continue,保留检测到的设置,再次点击 Continue。
  4. 选择 Sign in now,点击 Add,并登录 AnythingMCP(OAuth)以允许访问。

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

可用工具

工具功能
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 接入点位置。"

常见问题

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

UPS 凭据来自哪里? 来自 UPS 开发者门户中的一个应用程序(developer.ups.com),使用拥有你发货人账户的 ups.com 个人资料创建。添加追踪、地址验证、评级、运输时间和定位器产品,然后复制客户端 ID 和客户端密钥。UPS_ACCOUNT_NUMBER 是你的 6 位发货人号码。

它覆盖什么,覆盖不了什么? 通过号码或参考追踪、美国地址验证(仅限美国和波多黎各)、运费和运输时间、投递和接入点位置、到岸成本估算、标签恢复和取件报价。它使用生产凭据,而不是 UPS 测试系统。

它可以创建货物或预订取件吗? ups_create_shipment、ups_void_shipment、ups_create_pickup 和 ups_cancel_pickup 安装时已关闭,因为它们需要费用。仅在 AI 应该使用它们时,才在连接器页面上添加运输和取件产品并打开它们。

下一步

这份指南对你有帮助吗?

2 分钟将 UPS 连接到 Claude

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

相关指南

连接器

将 UPS MCP 接入 ChatGPT

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 和密钥。

连接器

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

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