摘要
UPS API 供发货人使用:通过追踪号码或参考追踪包裹,验证美国地址,比较运费和运输时间,查找投递和接入点位置,估算到岸成本,恢复标签和报价取件。包括货物创建、作废和取件,但已关闭。来自 UPS 开发者门户的 OAuth 客户端 ID 和密钥。
引导式设置
2 分钟将 UPS 连接到 ChatGPT
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 UPS,再把你的 MCP URL 添加到 ChatGPT。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
ChatGPT 插件目录中的 AnythingMCP 插件可在 AnythingMCP Cloud 上回答有关企业数据库的问题(PostgreSQL、MySQL、SQL Server、Oracle、SAP HANA、SQLite、MongoDB,只读):打开插件页面 (在新标签页中打开)并点击 Install plugin。其他所有连接器都以自定义 MCP 服务器的方式添加到 ChatGPT,使用你的 AnythingMCP MCP URL。
试试这样问
UPS 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → UPS,粘贴你的凭据,生成 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
UPS + ChatGPT
UPS API 供发货人使用:通过追踪号码或参考追踪包裹,验证美国地址,比较运费和运输时间,查找投递和接入点位置,估算到岸成本,恢复标签和报价取件。货物创建、作废和取件包括在内,但已关闭。来自 UPS 开发者门户的 OAuth 客户端 ID 和密钥。
前提条件
请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
UPS_CLIENT_ID, UPS_CLIENT_SECRET, UPS_ACCOUNT_NUMBER
第一步 — 获取凭据
设置大约需要 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 和密钥以获取短期有效的 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
第三步 — 在 ChatGPT 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
ChatGPT 在网页版的 Plugins 页面把 MCP 服务器添加为插件,仅付费套餐可用,不再需要开发者模式。在 Business 工作区中只有管理员和所有者可以添加;在 Enterprise 和 Edu 中,管理员可以授予 Create plugins with MCPs 权限。
- 前往 chatgpt.com/plugins,点击 Add,然后选择 Add custom MCP server。
- 填写名称,例如 Name:
UPS。 - 在 Connection 下的 Server URL 中填入
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,Authentication 保持为 OAuth。 - 选择 I understand and want to continue,然后点击 Create as a plugin。ChatGPT 提示时,登录 AnythingMCP 并允许访问。
- 在个人插件中安装这个新插件,然后在对话中输入 @ 并选择它。
可用工具
| 工具 | 功能 |
|---|---|
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 接入点位置。"
常见问题
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 应该使用它们时,才在连接器页面上添加运输和取件产品并打开它们。
ChatGPT 免费套餐能用自定义 MCP 服务器吗? OpenAI 只为付费套餐提供自定义 MCP 服务器的说明,Free 套餐不在其列。
下一步
这份指南对你有帮助吗?