Руководство по коннектору5 мин чтенияMCP-инструментов: 167 языков

UPS MCP-сервер: отслеживание и тарифы

UPS API для отправителей: отслеживайте посылки по номеру отслеживания или ссылке, проверяйте адреса в США, сравнивайте тарифы и время в пути, находите места для сдачи и точки доступа, оценивайте стоимость доставки, восстанавливайте ярлыки и запрашивайте забор. Создание отправлений, аннулирование и забор включены, но отключены. Идентификатор клиента OAuth и секрет из UPS Developer Portal.

HCАвтор: команда HelpCodeОбновлено 5 мин чтения Открытый код на GitHub

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

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

Требуемые env-vars

UPS_CLIENT_IDUPS_CLIENT_SECRETUPS_ACCOUNT_NUMBER
Установить в Cloud одним кликом

7 дней бесплатно · Без карты

  • 7 дней бесплатно
    Без банковской карты
  • GDPR и готовность к SOC 2
    Данные в ЕС, журналы аудита
  • Открытый код на GitHub
    Open source · AGPL-3.0
  • Работает с ChatGPT, Claude, Gemini
    Любой MCP-совместимый клиент

Кратко

UPS API для отправителей: отслеживайте посылки по номеру отслеживания или ссылке, проверяйте адреса в США, сравнивайте тарифы и время в пути, находите места для сдачи и точки доступа, оценивайте стоимость доставки, восстанавливайте ярлыки и запрашивайте забор. Создание отправлений, аннулирование и забор включены, но отключены. Идентификатор клиента OAuth и секрет из UPS Developer Portal.

Пошаговая настройка

Подключи UPS к Claude, ChatGPT или Copilot за 2 минуты

Начни бесплатный пробный период в AnythingMCP Cloud, подключи UPS в пошаговой настройке и добавь свой MCP URL в своего ИИ-ассистента. Без кода и без собственного сервера.

Без банковской карты · 7 дней пробного периода · Есть вариант self-host

Попробуй спросить

Примеры промптов для UPS

Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.

UPS · live via MCP
Поделиться
Opus 4.7

Claude — это AI, он может ошибаться. Проверяйте ответы.

💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → UPS, вставь свои учетные данные, создай ключ API MCP, и всё готово. Никакого Docker, никакого git clone, никакого локального сервера.

UPS

UPS API для отправителей: отслеживайте посылки по номеру отслеживания или ссылке, проверяйте адреса в США, сравнивайте тарифы и время в пути, находите места для сдачи и точки доступа, оценивайте стоимость доставки, восстанавливайте ярлыки и запрашивайте забор. Создание отправлений, аннулирование и забор включены, но отключены. Идентификатор клиента OAuth и секрет из UPS Developer Portal.

Настройка

Настройка занимает около 10 минут.

  1. Войди на https://developer.ups.com с профилем ups.com, который владеет твоим аккаунтом отправителя (зарегистрируй его сначала, если нужно), и открой страницу для создания приложения.
  2. Скажи, что ты хочешь интегрировать технологии UPS в свой бизнес, выбери номер аккаунта UPS, на который должно выставляться счет, и назови приложение.
  3. Добавь продукты, которые использует коннектор: Отслеживание, Проверка адресов, Тарифы, Время в пути, Локатор, а для отключенных инструментов Доставка, Забор и Оценка стоимости доставки. Продукт, который отсутствует, отвечает 401 или 403 только для своих инструментов.
  4. Скопируй Client ID в UPS_CLIENT_ID и Client Secret в UPS_CLIENT_SECRET.
  5. Вставь свой 6-значный номер аккаунта UPS (номер отправителя) в UPS_ACCOUNT_NUMBER.

Коннектор обменивает идентификатор клиента и секрет на https://onlinetools.ups.com/security/v1/oauth/token (учетные данные клиента, HTTP Basic) для получения краткосрочного токена доступа и обновляет его самостоятельно. Это производственные учетные данные; тестовая система 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 Access Point рядом с адресом в любой стране, которую обслуживает 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 Access Point, The UPS Store, центры обслуживания клиентов и почтовые ящики. Возвращает…
ups_quote_landed_costОценивает пошлины, налоги и брокерские сборы для международной отправки до ее отправки (UPS Landed Cost Quote). Возвращает по товару…
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Отменяет забронированный забор UPS по его номеру запроса на забор (PRN). Это нельзя отменить; нужно забронировать новый забор. Возвращает…

Примеры запросов

  • "Где посылка UPS 1Z999AA10123456784?"
  • "Сравни тарифы UPS из Чикаго 60601 в Остин 78701 для коробки весом 5 фунтов."
  • "Является ли 1600 Amphitheatre Pkwy, Mountain View, CA 94043 действительным адресом?"
  • "Когда посылка UPS Ground из Атланты достигнет Сиэтла, если она отправится сегодня?"
  • "Найди местоположения UPS Access Point рядом с 10115 Берлин."

Следующие шаги

Это руководство помогло?

Подключи UPS к Claude, ChatGPT или Copilot за 2 минуты

Начни бесплатный пробный период в AnythingMCP Cloud, подключи UPS в пошаговой настройке и добавь свой MCP URL в своего ИИ-ассистента. Без кода и без собственного сервера.

Похожие руководства

Коннекторы

Подключить UPS MCP к ChatGPT: отслеживание и тарифы

API UPS для отправителей: отслеживайте посылки по номеру отслеживания или ссылке, проверяйте адреса в США, сравнивайте тарифы и время в пути, находите места для сдачи и точки доступа, оценивайте стоимость доставки, восстанавливайте ярлыки и запрашивайте забор. Создание отправлений, аннулирование и забор включены, но отключены. Идентификатор клиента OAuth и секрет из Портала разработчиков UPS.

Коннекторы

Подключить UPS MCP к Claude: отслеживание и тарифы

API UPS для отправителей: отслеживайте посылки по номеру отслеживания или ссылке, проверяйте адреса в США, сравнивайте тарифы и время в пути, находите места для сдачи и точки доступа, оценивайте стоимость доставки, восстанавливайте ярлыки и запрашивайте забор. Создание отправлений, аннулирование и забор включены, но отключены. Идентификатор клиента OAuth и секрет из Портала разработчиков UPS.

Коннекторы

Подключить UPS MCP к Microsoft Copilot

API UPS для отправителей: отслеживайте посылки по номеру отслеживания или ссылке, проверяйте адреса в США, сравнивайте тарифы и время в пути, находите места для сдачи и точки доступа, оценивайте стоимость доставки, восстанавливайте ярлыки и запрашивайте забор. Создание отправлений, аннулирование и забор включены, но отключены. Идентификатор клиента OAuth и секрет из Портала разработчиков UPS.

Коннекторы

Подключить UPS MCP к Cursor: отслеживание и тарифы

API UPS для отправителей: отслеживайте посылки по номеру отслеживания или ссылке, проверяйте адреса в США, сравнивайте тарифы и время в пути, находите места для сдачи и точки доступа, оценивайте стоимость доставки, восстанавливайте ярлыки и запрашивайте забор. Создание отправлений, аннулирование и забор включены, но отключены. Идентификатор клиента OAuth и секрет из Портала разработчиков UPS.

Коннекторы

Подключить UPS MCP к Gemini CLI

API UPS для отправителей: отслеживайте посылки по номеру отслеживания или ссылке, проверяйте адреса в США, сравнивайте тарифы и время в пути, находите места для сдачи и точки доступа, оценивайте стоимость доставки, восстанавливайте ярлыки и запрашивайте забор. Создание отправлений, аннулирование и забор включены, но отключены. Идентификатор клиента OAuth и секрет из Портала разработчиков UPS.

Коннекторы

Подключить UPS MCP к Meta Muse

API UPS для отправителей: отслеживайте посылки по номеру отслеживания или ссылке, проверяйте адреса в США, сравнивайте тарифы и время в пути, находите места для сдачи и точки доступа, оценивайте стоимость доставки, восстанавливайте ярлыки и запрашивайте забор. Создание отправлений, аннулирование и забор включены, но отключены. Идентификатор клиента OAuth и секрет из Портала разработчиков UPS.