Кратко
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 и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → UPS, вставь свои учетные данные, создай ключ API MCP, и всё готово. Никакого Docker, никакого
git clone, никакого локального сервера.
UPS
UPS API для отправителей: отслеживайте посылки по номеру отслеживания или ссылке, проверяйте адреса в США, сравнивайте тарифы и время в пути, находите места для сдачи и точки доступа, оценивайте стоимость доставки, восстанавливайте ярлыки и запрашивайте забор. Создание отправлений, аннулирование и забор включены, но отключены. Идентификатор клиента OAuth и секрет из UPS Developer Portal.
Настройка
Настройка занимает около 10 минут.
- Войди на https://developer.ups.com с профилем ups.com, который владеет твоим аккаунтом отправителя (зарегистрируй его сначала, если нужно), и открой страницу для создания приложения.
- Скажи, что ты хочешь интегрировать технологии UPS в свой бизнес, выбери номер аккаунта UPS, на который должно выставляться счет, и назови приложение.
- Добавь продукты, которые использует коннектор: Отслеживание, Проверка адресов, Тарифы, Время в пути, Локатор, а для отключенных инструментов Доставка, Забор и Оценка стоимости доставки. Продукт, который отсутствует, отвечает 401 или 403 только для своих инструментов.
- Скопируй Client ID в
UPS_CLIENT_IDи Client Secret вUPS_CLIENT_SECRET. - Вставь свой 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 Берлин."
Следующие шаги
Это руководство помогло?