Resumen
APIs de UPS para transportistas: rastrea paquetes por número de seguimiento o referencia, valida direcciones en EE. UU., compara tarifas y tiempos de tránsito, encuentra ubicaciones de entrega y puntos de acceso, estima costos de entrega, recupera etiquetas y cotiza recogidas. La creación de envíos, anulaciones y recogidas están incluidas pero desactivadas. ID de cliente y secreto de OAuth del Portal de Desarrolladores de UPS.
Configuración guiada
Conecta UPS a Microsoft Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta UPS con la configuración guiada y añade tu URL MCP a Microsoft Copilot. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para UPS
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → UPS, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
UPS + Microsoft Copilot
APIs de UPS para transportistas: rastrea paquetes por número de seguimiento o referencia, valida direcciones en EE. UU., compara tarifas y tiempos de tránsito, encuentra ubicaciones de entrega y puntos de acceso, estima costos de entrega, recupera etiquetas y cotiza recogidas. La creación de envíos, anulaciones y recogidas están incluidas pero desactivadas. ID de cliente y secreto de OAuth del Portal de Desarrolladores de UPS.
Requisitos previos
Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
UPS_CLIENT_ID, UPS_CLIENT_SECRET, UPS_ACCOUNT_NUMBER
Paso 1 — Obtén credenciales
La configuración toma aproximadamente 10 minutos.
- Inicia sesión en https://developer.ups.com con el perfil de ups.com que posee tu cuenta de transportista (registra uno primero si es necesario) y abre la página para crear una aplicación.
- Indica que deseas integrar la tecnología de UPS en tu propio negocio, elige el número de cuenta de UPS al que debe facturarse la aplicación y nombra la aplicación.
- Agrega los productos que utiliza el conector: Tracking, Address Validation, Rating, Time in Transit, Locator, y, para las herramientas desactivadas, Shipping, Pickup y Landed Cost Quote. Un producto que falta responde 401 o 403 solo para sus herramientas.
- Copia el Client ID en
UPS_CLIENT_IDy el Client Secret enUPS_CLIENT_SECRET. - Coloca tu número de cuenta UPS de 6 caracteres (número de transportista) en
UPS_ACCOUNT_NUMBER.
El conector intercambia el ID de cliente y el secreto en https://onlinetools.ups.com/security/v1/oauth/token (credenciales de cliente, HTTP Basic) por un token de portador de corta duración y lo renueva por sí mismo. Estas son credenciales de producción; no se utiliza el sistema de prueba de UPS (wwwcie.ups.com).
Dónde empezar: ups_track_package con un número de seguimiento. Para un precio, ups_shop_rates compara todos los servicios entre dos direcciones y ups_get_rate cotiza un servicio; ups_get_time_in_transit proporciona fechas de entrega sin precios.
Seguimiento: ups_track_package (cualquier número de seguimiento), ups_track_by_reference (tu propia referencia, por ejemplo, un número de pedido, dentro de tu cuenta) y ups_track_shipment_packages (todos los paquetes de un envío de múltiples paquetes). Las fechas son YYYYMMDD y las horas HHMMSS en la hora local del escaneo; gmtDate, gmtTime y gmtOffset dan el mismo momento en UTC. Lee el estado de currentStatus.description y los escaneos de activity, el más reciente primero.
Direcciones y ubicaciones: ups_validate_address cubre direcciones en EE. UU. y Puerto Rico únicamente. ups_find_locations encuentra lugares de entrega y ubicaciones de puntos de acceso de UPS cerca de una dirección en cualquier país que UPS sirva.
Tarifas: ups_shop_rates y ups_get_rate envían tu número de cuenta como el número de transportista. Las tarifas publicadas regresan por defecto; pasa rating_options con NegotiatedRatesIndicator para ver las tarifas de contrato de tu cuenta en NegotiatedRateCharges. Los montos son cadenas en la moneda nombrada junto a ellos. Los pesos son LBS o KGS y las dimensiones IN o CM: usa las unidades del país de origen. ups_quote_landed_cost estima derechos e impuestos para un envío transfronterizo y funciona mejor con un código HS por artículo.
Etiquetas y envíos: ups_recover_label devuelve la etiqueta de un envío existente nuevamente y no cuesta nada. ups_create_shipment crea un envío que UPS factura a la cuenta, y ups_void_shipment cancela uno antes de la recogida; ambos están instalados desactivados. Actívalos en el conector solo si el asistente debe crear envíos reales. Los nombres de campo de UPS difieren entre llamadas: las herramientas de tarifas llaman al embalaje PackagingType, la herramienta de envío Packaging.
Recogidas: ups_get_pickup_rate cotiza una recogida a demanda y ups_get_pending_pickups lista las que están reservadas. ups_create_pickup reserva un conductor por una tarifa y ups_cancel_pickup cancela por PRN; ambos están instalados desactivados.
Errores: UPS responde con response.errors, una lista de code y message. 401 significa que las credenciales o el token fueron rechazados, 403 que la aplicación no tiene acceso a ese producto o que UPS bloqueó la cuenta, 404 en seguimiento que UPS no tiene datos para el número aún (las etiquetas aparecen después del primer escaneo o algunas horas después de la creación), 429 que la cuota de la aplicación se ha agotado.
Límites: UPS establece una cuota por aplicación y producto y no publica los números en sus archivos API; un 429 significa esperar y volver a intentar más tarde. Rastrear un número por llamada es el uso documentado: no hagas bucles sobre listas largas rápidamente.
Paso 2 — Instala el adaptador
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
Paso 3 — Agrega el conector en Microsoft Copilot
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
UPS. - Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.
¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
ups_track_package | Rastrea un paquete de UPS por número de seguimiento: estado actual con código y descripción, cada escaneo (fecha como YYYYMMDD, hora local como HHMMSS… |
ups_track_by_reference | Encuentra y rastrea envíos de tu cuenta de UPS por un número de referencia que pusiste en el envío (número de pedido, número de factura). Devuelve lo mismo… |
ups_track_shipment_packages | Rastrea cada paquete de un envío de múltiples paquetes de UPS desde uno de sus números de seguimiento: por paquete el número de seguimiento, estado actual, último… |
ups_validate_address | Verifica una dirección en EE. UU. o Puerto Rico contra los datos de UPS. Devuelve ValidAddressIndicator, AmbiguousAddressIndicator… |
ups_get_rate | Cotiza un servicio de UPS para un envío. Devuelve RateResponse.RatedShipment con el código de servicio, peso de facturación, transporte, servicio… |
ups_shop_rates | Compara cada servicio de UPS disponible entre dos direcciones para un envío. Devuelve un RatedShipment por servicio con su código, facturación… |
ups_get_time_in_transit | Lista los servicios de UPS disponibles entre dos lugares bajo emsResponse.services: serviceLevel y serviceLevelDescription… |
ups_find_locations | Encuentra lugares de entrega de UPS cerca de una dirección: ubicaciones de puntos de acceso de UPS, The UPS Store, centros de atención al cliente y buzones. Devuelve… |
ups_quote_landed_cost | Estima derechos, impuestos y tarifas de corretaje para un envío internacional antes de que se envíe (Cotización de Costo de Entrega de UPS). Devuelve por mercancía el… |
ups_recover_label | Obtiene la etiqueta de un envío que ya existe nuevamente, por número de seguimiento. Devuelve LabelRecoveryResponse.LabelResults con la etiqueta como un… |
ups_get_pickup_rate | Cotiza cuánto costaría una recogida a demanda de UPS en una dirección, sin reservarla. Devuelve PickupRateResponse.RateResult con el tipo de tarifa… |
ups_get_pending_pickups | Lista las recogidas reservadas en tu cuenta de UPS que aún no han ocurrido. Devuelve PickupPendingStatusResponse.PendingStatus con el estado de la recogida… |
ups_create_shipment | Crea un envío de UPS y su etiqueta. UPS factura el envío a tu cuenta tan pronto como esta llamada tiene éxito, por lo que la herramienta está instalada… |
ups_void_shipment | Anula (cancela) un envío de UPS que fue creado pero aún no recogido, o paquetes individuales de este. No se puede deshacer: las etiquetas se vuelven… |
ups_create_pickup | Reserva una recogida a demanda de UPS: un conductor viene a la dirección en el día dado. UPS cobra una tarifa de recogida a tu cuenta, por lo que la herramienta está… |
ups_cancel_pickup | Cancela una recogida de UPS reservada por su número de solicitud de recogida (PRN). No se puede deshacer; se debe reservar una nueva recogida. Devuelve… |
Ejemplos de indicaciones
- "¿Dónde está el paquete de UPS 1Z999AA10123456784?"
- "Compara tarifas de UPS desde Chicago 60601 a Austin 78701 para una caja de 5 lb."
- "¿Es 1600 Amphitheatre Pkwy, Mountain View, CA 94043 una dirección válida?"
- "¿Cuándo llegaría un paquete de UPS Ground desde Atlanta a Seattle si se envía hoy?"
- "Encuentra ubicaciones de puntos de acceso de UPS cerca de 10115 Berlín."
Preguntas frecuentes
¿De dónde provienen las credenciales de UPS? De una aplicación en el Portal de Desarrolladores de UPS (developer.ups.com), creada con el perfil de ups.com que posee tu cuenta de transportista. Agrega los productos Tracking, Address Validation, Rating, Time in Transit y Locator, luego copia el Client ID y Client Secret. UPS_ACCOUNT_NUMBER es tu número de transportista de 6 caracteres.
¿Qué cubre y qué no? Seguimiento por número o referencia, validación de direcciones en EE. UU. (solo Estados Unidos y Puerto Rico), tarifas y tiempos de tránsito, ubicaciones de entrega y puntos de acceso, estimaciones de costos de entrega, recuperación de etiquetas y cotizaciones de recogida. Utiliza credenciales de producción, no el sistema de prueba de UPS.
¿Puede crear envíos o reservar recogidas? ups_create_shipment, ups_void_shipment, ups_create_pickup y ups_cancel_pickup están instalados desactivados, porque tienen un costo. Agrega los productos Shipping y Pickup a tu aplicación y actívalos en la página del conector solo si la IA debe usarlos.
¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.
¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.
El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.
Próximos pasos
¿Te ha sido útil esta guía?