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 ChatGPT en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta UPS con la configuración guiada y añade tu URL MCP a ChatGPT. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
El plugin de AnythingMCP en el directorio de ChatGPT responde, en AnythingMCP Cloud, a preguntas sobre las bases de datos de tu empresa (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, solo lectura): abre la ficha (se abre en una pestaña nueva) y pulsa Install plugin. Los demás conectores se añaden a ChatGPT como servidor MCP personalizado con la URL MCP de tu AnythingMCP.
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 + ChatGPT
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 ChatGPT
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.
ChatGPT añade servidores MCP como plugins desde su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio Business solo pueden hacerlo los administradores y propietarios; en Enterprise y Edu un administrador puede conceder el permiso Create plugins with MCPs.
- Ve a chatgpt.com/plugins, pulsa Add y luego Add custom MCP server.
- Escribe un nombre, por ejemplo Name:
UPS. - En Connection, introduce como Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDy deja Authentication en OAuth. - Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP y permite el acceso.
- Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.
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.
¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no aparece en su lista.
Próximos pasos
¿Te ha sido útil esta guía?