Este artículo explica cómo usar Easyship con OpenAI para que puedas gestionar tareas de envío, como comparar tarifas, crear envíos, comprar etiquetas, programar recogidas y realizar el seguimiento de entregas, todo mediante lenguaje natural.
En este artículo:
- Parte 1: Uso del complemento de Easyship con ChatGpt
- Parte 2: Uso de Easyship MCP con la API de respuestas de OpenAI o el SDK de agentes
Hay dos formas de conectarse:
| Opción | Ideal para | ¿Cómo te conectas? |
| Parte 1: Complemento de Easyship para ChatGPT | Cualquier persona que quiera realizar envíos desde un chat de ChatGPT, sin necesidad de código | Inicia sesión en Easyship y autoriza (OAuth). No se necesita ningún token de API. |
| Parte 2: API de respuestas de OpenAI o SDK de agentes | Desarrolladores que crean sus propios agentes o aplicaciones de IA con OpenAI | Token de API de Easyship |
Parte 1: Uso del complemento de Easyship con ChatGPT
Antes de comenzar
Necesitarás:
Una cuenta de ChatGPT en chatgpt.com
Una cuenta activa de Easyship
No necesitas un token de API de Easyship para esta opción.
Paso 1: Instalar el complemento de Easyship
Inicia sesión en ChatGPT
Ve a Complementos
Busca Easyship
Haz clic en Instalar complemento
Paso 2: Autorizar Easyship
Después de la instalación, haz clic en Conectar
Se te redirigirá a Easyship para iniciar sesión. Inicia sesión en tu cuenta de Easyship si aún no lo has hecho
Revisa los permisos solicitados y haz clic en Autorizar
Volverás a ChatGPT y el complemento de Easyship aparecerá como Conectado
Atención: No existe un entorno de prueba independiente para las acciones de MCP. Cualquier acción que consuma créditos (como generar etiquetas) generará cargos reales.
Paso 3: Comenzar a usar Easyship en un chat
Abre un chat nuevo en ChatGPT
Escribe @easyship y selecciona Easyship - Envíos MCP en el menú desplegable
Escribe tu solicitud para comenzar
Prueba una solicitud como esta:
Quiero enviar un paquete desde Nueva York, EE. UU., a Toronto, Canadá. Origen: 350 5th Avenue, New York, US 10001. Destino: 220 Yonge Street, Toronto, ON, Canadá M5B 2H1. Paquete: 1.98 lb, 6 × 4 × 2 cm. Artículo: documentos comerciales, cantidad 1, código HS 4911.99, valor declarado de $1.00 USD, categoría documentos, DDU. Muéstrame las opciones de envío más económicas y con mejor relación calidad-precio, con los tiempos de entrega y los nombres de los transportistas.
Parte 2: Uso de Easyship MCP con la API de respuestas de OpenAI o el SDK de agentes
Antes de comenzar
Necesitarás:
- Acceso a la API de respuestas de OpenAI o al SDK de agentes
- Acceso a tu panel de Easyship
- Una cuenta de Easyship (el acceso a la API está disponible en todos los planes sin costo adicional)
Paso 1: Obtener tu token de API de Easyship
- Ve a tu panel de Easyship y haz clic en Conectar
- Haz clic en Nueva integración
- Desplázate hacia abajo hasta 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
- En la página siguiente, haz clic en Token de acceso y cópialo con el botón de copiar
Ámbitos necesarios: Tu token de API debe incluir los siguientes ámbitos. Si faltan ámbitos, algunas herramientas fallarán mientras que otras seguirán funcionando.
public.shipment:read public.shipment:write
public.label:write public.pickup:read
public.pickup:write public.address_validation:write
public.address_validation_domestic:write
public.shipment_document:read public.transaction_record:read
public.analytics:read public.rate:read
public.track:readPuedes comprobar y actualizar los ámbitos en cualquier momento en Panel → Conectar → API sin crear un token nuevo.
Paso 2: Añadir el servidor MCP de Easyship a la API de respuestas
Pasa el servidor MCP de Easyship como una herramienta en tu llamada a responses.create(). Consulta la documentación de herramientas MCP de OpenAI para obtener la referencia completa.
python
from openai import OpenAI
client = OpenAI()
resp = client.responses.create(
model="gpt-4.1",
tools=[{
"type": "mcp",
"server_label": "easyship",
"server_url": "https://mcp.easyship.com/mcp",
"require_approval": "never",
"headers": {
"Authorization": "Bearer YOUR_EASYSHIP_TOKEN"
}
}],
input="What are the cheapest shipping options from HK to NYC for a 1.5kg package?"
)
print(resp.output_text)Reemplaza YOUR_EASYSHIP_TOKEN por el token de API que copiaste en el paso 1.
Nota: require_approval: "never" indica al modelo que llame automáticamente a las herramientas de Easyship sin detenerse para solicitar confirmación. Establécelo en "always" si quieres que el modelo solicite aprobación antes de realizar acciones como crear envíos o comprar etiquetas.
Seguridad: Nunca incluyas directamente tu token de API en el código fuente ni lo compartas en una ventana de chat. Guárdalo como una variable de entorno (por ejemplo, EASYSHIP_API_ACCESS_TOKEN) y haz referencia a él durante la ejecución. Si lo expones accidentalmente, revoca y cambia tu clave de inmediato en el panel de Easyship, en Conectar → API.
Paso 3: Verificar la conexión
Ejecuta tu script. Si el servidor MCP de Easyship está conectado correctamente, el modelo llamará automáticamente a las herramientas de Easyship y devolverá los resultados de envío en resp.output_text.
Si aparece un error de conexión o autenticación, vuelve a comprobar tu token y confirma que todos los ámbitos necesarios estén habilitados en el panel de Easyship.
Paso 4: Pruébalo
Una vez conectado, prueba una solicitud como esta:
Quiero enviar un paquete desde Nueva York, EE. UU., a Toronto, Canadá. Origen: 350 5th Avenue, New York, US 10001. Destino: 220 Yonge Street, Toronto, ON, Canadá M5B 2H1. Paquete: 1.98 lb, 6 × 4 × 2 cm. Artículo: documentos comerciales, cantidad 1, código HS 4911.99, valor declarado de $1.00 USD, categoría documentos, DDU. Muéstrame las opciones de envío más económicas y con mejor relación calidad-precio, con los tiempos de entrega y los nombres de los transportistas.
Para consultar la lista completa de herramientas y flujos de trabajo disponibles, visita la documentación para desarrolladores de Easyship MCP.
Interfaz de usuario de ChatGPT para consumidores — Próximamente
La integración directa con la interfaz de usuario de ChatGPT para consumidores en chat.openai.com requiere compatibilidad con OAuth. Esta función aún no está disponible para el servidor MCP de Easyship. Cuando OAuth sea compatible, los usuarios podrán conectar Easyship directamente desde la interfaz de ChatGPT sin necesidad de código.
Preguntas frecuentes
¿Puedo usar un token de API existente o necesito uno nuevo?
Puedes usar un token existente de tu cuenta de Easyship. Solo asegúrate de que tenga todos los ámbitos necesarios indicados en el paso 1. Si faltan algunos ámbitos, ciertas herramientas fallarán mientras que otras funcionarán.
¿Funciona con la aplicación de ChatGPT o con chat.openai.com?
Todavía no. La integración con la API de respuestas y el SDK de agentes está disponible actualmente para los desarrolladores que crean soluciones con OpenAI. La interfaz de usuario de ChatGPT para consumidores requiere compatibilidad con OAuth por parte del servidor MCP, que estará disponible próximamente.
¿Qué hace require_approval: "never"?
Esta configuración indica al modelo de OpenAI que llame automáticamente a las herramientas MCP de Easyship sin detenerse para solicitar la aprobación del usuario en cada llamada a una herramienta. Establécela en "always" si quieres que el modelo solicite confirmación antes de realizar acciones como crear envíos o comprar etiquetas.
¿Qué ocurre si el modelo no llama a las herramientas de Easyship?
Vuelve a comprobar tu token y que server_url sea https://mcp.easyship.com/mcp. Asegúrate de que el valor del encabezado de autorización comience con Bearer (con un espacio), seguido de tu token. Confirma también que todos los ámbitos necesarios estén habilitados en el panel de Easyship.
¿Qué ocurre si no se cargan todas las herramientas?
- Verifica que tu token de API de Easyship sea válido y esté activo
- Confirma que todos los ámbitos necesarios estén habilitados en el panel de Easyship
- Comprueba la conexión de red del equipo que ejecuta el script
- Comprueba la respuesta de la API de OpenAI para ver si hay mensajes de error relacionados con el servidor MCP
¿Por qué no funciona mi token de API de Easyship?
Comprueba los ámbitos de tu token en el panel de Easyship, en Conectar → API. Un token puede funcionar para algunas acciones y fallar para otras, según los ámbitos que tenga. Para obtener acceso completo a todas las herramientas, habilita todos los ámbitos indicados en el paso 1.
¿Qué ocurre si no concedo todos los ámbitos necesarios?
Solo funcionarán las herramientas que correspondan a los ámbitos concedidos. Las demás herramientas devolverán un error. Puedes actualizar los ámbitos en el panel de Easyship sin crear un token nuevo.
¿Tengo que pagar por el token de API de Easyship?
No. Easyship proporciona acceso a la API en todos los planes sin costo adicional. Si superas los límites de API incluidos en tu plan, podrían aplicarse cargos por exceso. Consulta [planes de precios y límites incluidos].
¿Puedo usar el mismo token de Easyship con otros clientes (Claude, Cursor, etc.)?
Sí. El mismo token de API de Easyship funciona con cualquier cliente MCP. Ten en cuenta los límites de frecuencia y evita ejecutar operaciones conflictivas (como editar el mismo envío desde dos clientes al mismo tiempo).