Кратко
API UPS для отправителей: отслеживайте посылки по номеру отслеживания или ссылке, проверяйте адреса в США, сравнивайте тарифы и время в пути, находите места для сдачи и точки доступа, оценивайте стоимость доставки, восстанавливайте ярлыки и запрашивайте забор. Создание отправлений, аннулирование и забор включены, но отключены. Идентификатор клиента OAuth и секрет из Портала разработчиков UPS.
Пошаговая настройка
Подключи UPS к Meta Muse за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи UPS в пошаговой настройке и добавь свой MCP URL в Meta Muse. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для UPS
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → UPS, вставь свои учетные данные, создай ключ API MCP, и всё готово. Никакого Docker, никакого
git clone, никакого локального сервера.
UPS + Meta Muse
API UPS для отправителей: отслеживайте посылки по номеру отслеживания или ссылке, проверяйте адреса в США, сравнивайте тарифы и время в пути, находите места для сдачи и точки доступа, оценивайте стоимость доставки, восстанавливайте ярлыки и запрашивайте забор. Создание отправлений, аннулирование и забор включены, но отключены. Идентификатор клиента OAuth и секрет из Портала разработчиков UPS.
Предварительные требования
См. полные инструкции по настройке, встроенные в коннектор (видны в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:
UPS_CLIENT_ID, UPS_CLIENT_SECRET, UPS_ACCOUNT_NUMBER
Шаг 1 — Получи учетные данные
Настройка занимает около 10 минут.
- Войди на https://developer.ups.com с профилем ups.com, который принадлежит твоему учетной записи отправителя (зарегистрируй его сначала, если необходимо), и открой страницу для создания приложения.
- Скажи, что ты хочешь интегрировать технологии UPS в свой бизнес, выбери номер счета UPS, на который должно выставляться счет, и назови приложение.
- Добавь продукты, которые использует коннектор: Отслеживание, Проверка адреса, Оценка, Время в пути, Локатор, а для отключенных инструментов Доставка, Забор и Оценка стоимости доставки. Продукт, который отсутствует, отвечает 401 или 403 только для своих инструментов.
- Скопируй Идентификатор клиента в
UPS_CLIENT_IDи Секрет клиента в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 рядом с адресом в любой стране, которую обслуживает UPS.
Тарифы: ups_shop_rates и ups_get_rate отправляют твой номер счета как номер отправителя. Опубликованные тарифы возвращаются по умолчанию; передай rating_options с NegotiatedRatesIndicator, чтобы увидеть контрактные тарифы твоего счета в NegotiatedRateCharges. Суммы — это строки в валюте, указанной рядом с ними. Вес в фунтах или килограммах, а размеры в дюймах или сантиметрах: используй единицы страны происхождения. 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 означает, что нужно подождать и попробовать снова позже. Отслеживание одного номера за вызов — это документированное использование: не перебирай длинные списки быстро.
Шаг 2 — Установи адаптер
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
Шаг 3 — Добавь коннектор в Muse
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Muse добавляет удалённые MCP-серверы как пользовательские коннекторы и входит в них через OAuth.
- В Muse открой Settings → Connectors и выбери Add custom connector.
- Вставь URL MCP-сервера
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse откроет страницу входа AnythingMCP: войди и подтверди доступ.
- В чате попроси Muse о том, для чего нужны инструменты
UPS.
Настроить коннектор можно и из чата — в вебе, в приложениях для iOS и Android или в WhatsApp. Отправь Muse это сообщение:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Muse подключается из облака Meta, поэтому localhost не подойдёт.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
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 | Отменяет забронированный забор UPS по его номеру запроса на забор (PRN). Это нельзя отменить; новый забор нужно забронировать. Возвращает… |
Примеры подсказок
- "Где посылка UPS 1Z999AA10123456784?"
- "Сравни тарифы UPS из Чикаго 60601 в Остин 78701 для коробки весом 5 фунтов."
- "Является ли 1600 Amphitheatre Pkwy, Mountain View, CA 94043 действительным адресом?"
- "Когда посылка UPS Ground из Атланты достигнет Сиэтла, если она отправится сегодня?"
- "Найди точки доступа UPS рядом с 10115 Берлин."
Часто задаваемые вопросы
Откуда берутся учетные данные UPS? Из приложения в Портале разработчиков UPS (developer.ups.com), созданного с профилем ups.com, который принадлежит твоему аккаунту отправителя. Добавь продукты Отслеживание, Проверка адреса, Оценка, Время в пути и Локатор, затем скопируй Идентификатор клиента и Секрет клиента. UPS_ACCOUNT_NUMBER — это твой 6-значный номер отправителя.
Что он охватывает, а что нет? Отслеживание по номеру или ссылке, проверка адресов в США (только США и Пуэрто-Рико), тарифы и время в пути, места для сдачи и точки доступа, оценки стоимости доставки, восстановление ярлыков и запросы на забор. Используются производственные учетные данные, а не тестовая система UPS.
Может ли он создавать отправления или бронировать заборы? ups_create_shipment, ups_void_shipment, ups_create_pickup и ups_cancel_pickup установлены в отключенном состоянии, потому что они стоят денег. Добавь продукты Доставка и Забор в свое приложение и включи их на странице коннектора только если ИИ должен их использовать.
Где доступен Muse? Сейчас Meta предлагает Muse в США и Канаде — в вебе, в приложениях для iOS и Android и в WhatsApp.
Проверяет ли Meta этот коннектор? Нет. Meta не проверяет пользовательские коннекторы. Muse видит только те инструменты, которые ты включил для этого MCP-сервера в AnythingMCP, а отключить коннектор можно в любой момент в Settings → Connectors.
Следующие шаги
Это руководство помогло?