Easyship MCP te permite gestionar tus operaciones de envío mediante lenguaje natural; solo escribe lo que necesitas, como si estuvieras chateando con un asistente.
En lugar de cambiar entre herramientas o gestionar los envíos manualmente, puedes comparar tarifas, generar etiquetas, hacer seguimiento de envíos, sincronizar pedidos, verificar direcciones, gestionar recogidas, calcular impuestos y aranceles, y mucho más.
En este artículo:
- ¿Para quién está diseñado?
- Plataformas compatibles
- Qué necesitas
- Configuración rápida
- Alcances del token de API
- Acciones disponibles
- Preguntas frecuentes
¿Para quién está diseñado?
Easyship MCP está diseñado para:
- Comerciantes de comercio electrónico
- Equipos de operaciones y gestión logística
- Agentes de atención al cliente
- Cualquier persona que gestione envíos y logística
No se requiere programación; para la configuración inicial, es útil tener conocimientos básicos sobre ajustes y claves de API.
Plataformas compatibles
Easyship MCP es compatible con cualquier plataforma que admita el Model Context Protocol. La forma de conectarte depende de la aplicación:
- Iniciar sesión con Easyship (OAuth): No se necesita ningún token de API. Inicias sesión en Easyship y autorizas el acceso desde la aplicación.
- Token de API: Creas un token de API de Easyship y lo añades a los ajustes de MCP de la aplicación.
| Tipo de plataforma | Aplicaciones compatibles | Aplicaciones compatibles |
| Aplicaciones de chat o asistentes | ChatGPT, Grok (grok.com), Claude (Desktop, Claude Code y más) | ChatGPT y Grok: iniciar sesión con Easyship (OAuth). Claude: token de API. Próximamente habrá un conector nativo de Claude con inicio de sesión en Easyship (OAuth). |
| Entornos de programación con IA | Cursor, Windsurf, Google Antigravity | Token de API |
| IA y API en la nube | OpenAI (Responses API, Agents SDK), Google Gemini (CLI, Code Assist y navegador), Grok (API de xAI y navegador) | Token de API |
| Automatización de flujos de trabajo | n8n, make.com, Zapier, Celigo | Token de API |
| Enfoque basado en habilidades / híbrido | Perplexity, OpenClaw | Easyship Skill (disponible en ClawHub) |
Qué necesitas
Antes de comenzar, asegúrate de tener:
- Una cuenta activa de Easyship
- Una aplicación compatible con MCP (consulta la sección Plataformas compatibles más arriba)
- Un token de API de Easyship, solo si tu aplicación se conecta mediante un token de API (no es necesario para ChatGPT o Grok)
Cómo conectarte
Opción A: Iniciar sesión con Easyship (OAuth): ChatGPT y Grok
No se necesita ningún token de API. Conectas Easyship desde la aplicación y autorizas el acceso con tus credenciales de Easyship.
- Añade Easyship en tu aplicación (instala el complemento de Easyship en ChatGPT o añade un conector personalizado en Grok)
- Inicia sesión en tu cuenta de Easyship cuando se te redirija
- Revisa los permisos y haz clic en Autorizar
- Vuelve a tu aplicación. Easyship aparecerá como conectado y podrás empezar a escribir indicaciones
Para consultar instrucciones paso a paso para tu plataforma específica, visita:
- Cómo conectar ChatGPT y la API de OpenAI al servidor MCP de Easyship
- Cómo conectar Grok al servidor MCP de Easyship
Opción B: Token de API: Cursor, Claude, API de OpenAI y otros clientes MCP
Obtén tu token de API
- Inicia sesión en Easyship y ve a Conectar > Nueva integración.
- Desplázate hacia abajo y selecciona Integración de API.
- En Tipo de integración, selecciona Estoy desarrollando una integración personalizada.
- Asigna a la clave el nombre Easyship MCP para identificarla fácilmente.
- Mantén la versión predeterminada 2024-09 y haz clic en Conectar.
- Haz clic en Token de acceso y cópialo con el botón de copiar.
⚠️ Advertencia de seguridad: Mantén tu token en secreto. Nunca pegues tu token de API en un mensaje de chat. Añádelo únicamente en los ajustes de tu aplicación, donde se almacena de forma segura. Cualquier persona que tenga tu token puede comprar etiquetas con cargo a tu cuenta.
Conecta
- Añade el servidor MCP de Easyship en la aplicación que hayas elegido.
- Pega tu token de API cuando se te solicite.
- Guarda y conecta.
Para consultar instrucciones paso a paso para tu plataforma específica, visita:
- Guía de configuración de Easyship MCP para Cursor
- Cómo conectar ChatGPT y la API de OpenAI al servidor MCP de Easyship
- Documentación para desarrolladores de Easyship MCP
⚠️ Ten en cuenta: No existe un entorno de prueba independiente para las acciones de MCP. Cualquier acción que consuma créditos (como generar etiquetas) supondrá cargos reales. Si te conectas con un token de API, te recomendamos utilizar un token de API de prueba con alcances limitados durante tu primera ejecución. Revisa tus planes de precios y límites incluidos.
Alcances del token de API
Esta sección solo se aplica si te conectas con un token de API. Si te conectas iniciando sesión con Easyship (OAuth), los permisos se conceden al hacer clic en Autorizar.
Tu token de API de Easyship requiere los siguientes alcances. Sin ellos, algunas herramientas no funcionarán:
| Alcance | Se utiliza para |
| public.shipment:read | Enumerar, consultar y hacer seguimiento de envíos |
| public.shipment:write | Crear, actualizar, eliminar y cancelar envíos |
| public.label:write | Comprar etiquetas de envío |
| public.pickup:read | Enumerar recogidas y consultar franjas horarias de recogida |
| public.pickup:write | Crear y cancelar recogidas |
| public.address_validation:write | Validar direcciones internacionales |
| public.address_validation_domestic:write | Validar direcciones de EE. UU. |
| public.shipment_document:read | Recuperar metadatos de facturas comerciales |
| public.transaction_record:read | Consultar transacciones y facturación |
| public.analytics:read | Todas las herramientas de análisis |
| public.rate:read | Comparar opciones y tarifas de transportistas |
| public.track:read | Hacer seguimiento del estado de entrega de paquetes |
Acciones disponibles
Tarifas
| Herramienta | Qué hace | Prueba esta indicación |
| get_rates | Compara opciones de transportistas con tarifas con descuento negociadas previamente y tiempos de entrega. | "Quiero enviar un paquete de 0,05 kg (6×2×4 cm) desde 350 5th Avenue, Nueva York, EE. UU., hasta 220 Yonge Street, Toronto, Canadá. Muéstrame las opciones más baratas y con mejor relación calidad-precio, con los tiempos de entrega." |
Envíos
| Herramienta | Qué hace | Prueba esta indicación |
| create_shipment | Inicia un envío con direcciones y datos del paquete. Guárdalo como borrador o compra una etiqueta cuando esté listo. | "Crea un envío como borrador desde Jane Sender, 350 5th Avenue, Nueva York, NY, hasta John Recipient, 220 Yonge Street, Toronto, ON. Paquete: 0,12 kg, 22×15×3 cm. No compres todavía una etiqueta." |
| create_label | Compra y genera una etiqueta de envío para un envío existente. | "Compra una etiqueta para el envío ESSG10006001 y dame el enlace de descarga." |
| get_shipment | Consulta el estado y los costes de un envío, así como los enlaces para descargar su etiqueta, albarán o factura. | "Abre el envío ESSG10006001. Necesito todos los detalles y los enlaces a los documentos: etiqueta de 4×6, albarán y factura comercial A4." |
| list_shipments | Explora o busca tus envíos por país, estado y otros criterios. | "Muéstrame la página 1 de mis envíos, 20 por página. Excluye los cancelados. Muestra únicamente los envíos con una etiqueta generada o impresa, cuyo destino sea Canadá." |
| update_shipment | Edita los datos de un envío existente antes de que se envíe. | "Para el envío ESSG10006001, actualiza el teléfono de destino a +1 416-555-0200 y añade Suite 400 como línea 2 de la dirección. Deja todo lo demás tal como está." |
| cancel_shipment | Cancela un envío que aún no se ha recogido. | "Cancela el envío ESSG10006001 y dime si se realizó correctamente o qué error se devolvió." |
| delete_shipment | Elimina un envío en borrador o que aún no se ha enviado. | "Elimina el envío ESSG10006001; todavía está en borrador. Confirma cuando hayas terminado." |
| track_shipment | Consulta dónde está un paquete, su fecha estimada de entrega y los eventos de seguimiento recientes. | "Haz seguimiento del envío ESSG10006001. ¿Cuál es el estado más reciente? ¿Hay una fecha estimada de entrega? ¿Cuáles fueron los tres últimos eventos de seguimiento?" |
Validación de direcciones
| Herramienta | Qué hace | Prueba esta indicación |
| validate_address | Comprueba si una dirección admite entregas y obtiene correcciones sugeridas. | "¿Es válida esta dirección para realizar envíos con Easyship: 1600 Amphitheatre Parkway, Building 43, Mountain View, CA 94043, EE. UU.? No la sustituyas automáticamente; solo muestra si es válida y las correcciones recomendadas." |
Recogidas
| Herramienta | Qué hace | Prueba esta indicación |
| get_pickup_slots | Consulta cuándo puede recoger tus paquetes un transportista antes de realizar la reserva. | "Para el envío ESSG10006001, consulta el ID del servicio del transportista y, después, obtén las franjas horarias de recogida disponibles. Resume los próximos tres días con las franjas disponibles." |
| create_pickup | Reserva un transportista para recoger uno o más paquetes del mismo transportista. | "Programa una recogida para los envíos ESSG10006001 y ESSG10006002 el 14 de abril de 2026. Obtén el ID del transportista del primer envío y confirma el ID de recogida cuando se cree." |
| list_pickups | Consulta las recogidas que has programado, filtradas por transportista, fecha o estado. | "Muestra mis recogidas: página 1, 25 por página, transportista USPS, fecha de recogida 15 de abril de 2026, estado solicitada." |
| get_pickup | Abre una recogida para consultar todos los detalles, incluidos la hora, el transportista y los envíos vinculados. | "Dame todos los detalles de la recogida ESPICKUP-US-2026-0001." |
| cancel_pickup | Cancela una recogida programada. | "Cancela la recogida ESPICKUP-US-2026-0001 e informa del resultado." |
| list_pickup_shipments | Consulta qué paquetes están incluidos en una recogida programada. | "Para la recogida ESPICKUP-US-2026-0001, enumera los ID de envío y los destinos; página 1, 20 por página." |
Facturación y análisis
| Herramienta | Qué hace | Prueba esta indicación |
| list_transactions | Revisa los cargos y créditos de tu cuenta de Easyship por fecha, tipo o envío. | "Obtén mis transacciones: página 1, 50 por página, del 1 de marzo al 9 de abril de 2026, tipo: envío." |
| list_billing_transactions | Consulta las partidas que componen una factura específica. | "Para el documento de facturación BDOC-2026-03-0042, enumera las transacciones de facturación, página 1, 50 por página, entre el 1 y el 31 de marzo de 2026." |
| analytics_shipments | Consulta cuántos envíos has creado a lo largo del tiempo, incluidas las tendencias diarias. | "Muestra los análisis del volumen de envíos del 9 de enero al 9 de abril de 2026, incluida la tendencia diaria y el día de mayor volumen." |
| analytics_shipped_activity | Consulta si las etiquetas se utilizaron realmente durante un periodo determinado, no solo los borradores creados. | "Del 9 de enero al 9 de abril de 2026, ¿qué muestra Easyship sobre la actividad real de envíos durante ese periodo?" |
| analytics_status_breakdown | Consulta el desglose de tus envíos por etapa. | "Muéstrame el desglose del estado de los envíos del 9 de enero al 9 de abril de 2026: ¿cuáles están en curso y cuáles se han completado?" |
| analytics_top_couriers | Consulta qué transportistas utilizas más por volumen. | "Del 9 de enero al 9 de abril de 2026, ¿qué transportistas utilicé más? Ordénalos con los recuentos y la proporción del volumen." |
| analytics_top_destinations | Consulta dónde envías más paquetes. | "Del 9 de enero al 9 de abril de 2026, ¿a dónde envío más paquetes? Resume los principales países y zonas." |
| analytics_by_channel | Consulta qué fuente genera tus envíos. | "Durante los últimos 3 meses, desglosa mis envíos por canal de ventas, con los recuentos y el porcentaje de cada canal." |
Preguntas frecuentes
¿Necesito un token de API para utilizar Easyship MCP?
No siempre. ChatGPT y Grok se conectan iniciando sesión con tu cuenta de Easyship (OAuth), por lo que no se necesita ningún token de API. Aplicaciones como Cursor, Claude Desktop, n8n y la API de OpenAI utilizan un token de API de Easyship. Consulta la sección Plataformas compatibles más arriba para saber cómo se conecta cada aplicación.
¿Necesito aprender comandos específicos?
No; solo escribe lo que necesitas en lenguaje natural. Intenta incluir todos los detalles posibles desde el principio. Si falta algún dato necesario, el agente te lo pedirá o te sugerirá valores entre los que podrás elegir.
¿Puedo utilizarlo con Shopify u otras plataformas?
Sí. Conecta tu agente al MCP de Shopify (o al MCP de tu plataforma) junto con Easyship MCP para gestionar flujos de trabajo de envíos entre plataformas desde un solo lugar.
¿Se aplican mis reglas de automatización de envíos de Easyship?
Sí. Los envíos procesados mediante MCP son envíos estándar de Easyship, por lo que se aplican todas tus reglas de envío, preferencias de tarifas y ajustes de automatización existentes.
¿Se me cobrará por consultar tarifas mediante MCP?
No. Consultar tarifas, enumerar envíos y hacer seguimiento son acciones gratuitas. Solo comprar etiquetas o reservar recogidas consume créditos.
¿Tengo que pagar para utilizar Easyship MCP?
No. Easyship proporciona acceso a la API en todos los planes sin coste adicional. Pueden aplicarse cargos por excedente si superas los límites mensuales. Consulta todos los planes de precios y límites de la API para obtener más información.
¿Puedo conectar Easyship MCP a varias aplicaciones?
Sí. Puedes conectar Easyship a tantas aplicaciones MCP como quieras. Las aplicaciones OAuth, como ChatGPT y Grok, se conectan cada una con su propio inicio de sesión de Easyship. En las aplicaciones que utilizan un token de API, el mismo token funciona con Cursor, Claude, Gemini y otras. Ten en cuenta los límites de frecuencia y evita ejecutar operaciones que entren en conflicto al mismo tiempo.
¿Puedo procesar varios envíos a la vez?
Sí. Puedes gestionar pedidos en lote mediante indicaciones sencillas: carga un CSV o pide al agente que obtenga tus últimos X envíos y genere automáticamente etiquetas para todos. El agente seleccionará cada envío y comprará una etiqueta para él de uno en uno, y señalará los envíos en los que se necesiten tus datos antes de poder comprar la etiqueta.
¿Por qué aparece el error Suscripción inactiva y cómo lo soluciono?
Tu suscripción de Easyship no está activa, por lo que no se pueden procesar las solicitudes de tu cuenta. Reactiva tu plan o actualiza tu método de pago en el panel de Easyship y vuelve a intentarlo. No necesitas conectarte de nuevo.