Zaslat.cz

Conecta asistentes de IA a la plataforma de envíos Zaslat.cz mediante el Protocolo de Contexto de Modelo. Crea envíos, obtén tarifas, rastrea paquetes y busca puntos de recogida, todo mediante lenguaje natural.

Por qué MCP: la tercera interfaz para la logística

Zaslat ha ofrecido durante mucho tiempo dos formas de enviar: la aplicación web para humanos y la API REST para sistemas. MCP es la tercera, creada para asistentes de IA que actúan en nombre de un usuario real, con su cuenta, sus direcciones y sus contratos de transportista.

Mientras que la API REST requiere una integración limpia y un desarrollador detrás, MCP destaca en las tareas complicadas intermedias:

• Una hoja de Excel con direcciones en tres formatos diferentes: solo súbela y pide al asistente que las envíe todas.
• Un pedido de cliente que llegó como texto plano en un correo electrónico: pégalo y obtén un envío.
• Preguntas rápidas como “¿cuál es la forma más barata de enviar 2 kg a Berlín mañana?” respondidas en segundos.
• Recogidas puntuales, cancelaciones masivas, reimpresiones de etiquetas: sin hacer clic en el panel ni escribir un script.

El servidor MCP de Zaslat conecta cualquier asistente compatible con MCP (Claude, ChatGPT, n8n, agentes personalizados) a una cuenta real de Zaslat. La IA entiende el contexto, sigue las preferencias del usuario (remitente predeterminado, transportista preferido, configuración de COD) y realiza acciones reales: comparación de tarifas, creación de envíos, seguimiento, impresión de etiquetas, cancelación.

Es adecuado para usuarios con curiosidad técnica y equipos de operaciones que quieran automatizar los envíos sin tener un proyecto de integración propio. Si puedes describir lo que necesitas en lenguaje sencillo, el asistente puede hacerlo.

Inicio rápido (Claude.ai / Claude Desktop)

1. Configuración → Conectores → Añadir conector personalizado
2. URL: https://mcp.zaslat.cz/mcp
3. Elige OAuth: serás redirigido a la página de inicio de sesión de Zaslat
4. Aprueba el acceso: el conector está listo

Autenticación

El servidor acepta dos tipos de credenciales. Ambos se validan contra el backend de Zaslat en initialize y se revalidan cada 30 minutos durante toda la sesión MCP.

OAuth 2.1 (recomendado)

El servidor anuncia sus metadatos de autorización en:

GET https://mcp.zaslat.cz/.well-known/oauth-protected-resource

Los clientes MCP que admiten OAuth (Claude.ai, Claude Desktop) descubren automáticamente el servidor de autorización y ejecutan el flujo estándar de código de autorización con PKCE contra api.zaslat.cz.

Scopes: rates, shipments:read, shipments:write

Clave API

Para clientes sin interfaz (n8n, scripts, agentes personalizados) pasa una clave API de Zaslat en el encabezado X-ApiKey:

POST /mcp HTTP/1.1
Host: mcp.zaslat.cz
X-ApiKey: <your-api-key>
Content-Type: application/json

Puedes generar una clave API después de iniciar sesión en app.zaslat.cz en Configuración → Integraciones → Integración API.

Herramientas

El servidor MCP de Zaslat expone 9 herramientas que cubren todo el flujo de envío: desde la comparación de tarifas y la búsqueda de puntos de paquetería hasta la creación de envíos, la impresión de etiquetas, el seguimiento y la cancelación.

Tarifas e información

Herramienta	Descripción	Modifica datos
get_rates	Compara tarifas de transportistas para una ruta y lista de paquetes determinadas.	No
get_profile	Carga el perfil de usuario, la dirección de remitente predeterminada y la configuración de la cuenta.	No
search_parcel_points	Encuentra los puntos de recogida / entrega más cercanos por dirección, código postal o transportista.	No

Gestión de envíos

Herramienta	Descripción	Modifica datos
create_shipment	Crea un nuevo envío (Home2Home, Shop2Home, Home2Shop, Shop2Shop).	Sí
cancel_shipment	Cancela un envío que aún no ha sido recogido por el transportista.	Sí

Listado y seguimiento

Herramienta	Descripción	Modifica datos
list_shipments	Lista envíos con filtros y paginación.	No
get_shipment_detail	Detalles completos del envío, incluido el número de seguimiento del transportista.	No
track_shipment	Estado de seguimiento con historial de eventos.	No

Etiquetas

Herramienta	Descripción	Modifica datos
print_label	Genera una etiqueta de envío (enlace PDF o base64).	No

Flujo de trabajo típico

1. get_profile           → Load default sender address
2. get_rates             → Compare carrier rates
3. search_parcel_points  → Find pickup point (Home2Shop / Shop2Shop)
4. create_shipment       → Create shipment with the selected carrier
5. print_label           → Download label for printing
6. track_shipment        → Track shipment status

Ejemplos de indicaciones

Comparación de tarifas

¿Cuáles son las tarifas de envío para un paquete de 30×20×15 cm, 3 kg de Praga a Brno?

Compara los precios de los transportistas para un envío de 5 kg a Bratislava.

¿Cuánto cuesta enviar 2 paquetes de Ostrava a Berlín?

Creación de un envío

Envía un paquete por DPD a Jan Novák, Příčná 5, Brno 602 00, 2 kg.

Crea un envío de Zásilkovna al punto de recogida 12345, destinataria Eva Malá, teléfono 777123456.

Pide PPL con contra reembolso de 500 CZK a la cuenta 1234567890/0100.

Seguimiento y listado

¿Dónde está mi envío IZ123456?

Muéstrame mis últimos 10 envíos.

Encuentra todos los envíos de DPD no entregados de la semana pasada.

Muéstrame los envíos con COD impago del último mes.

Etiquetas

Imprime la etiqueta del envío IZ123456.

Necesito una etiqueta A6 para una impresora térmica.

Envío masivo

(sube un archivo de Excel) Envía todos los envíos de este archivo por DPD.

Cancelación

Cancela el envío IZ123456.

Valores predeterminados y convenciones

• Tamaño de paquete predeterminado: 20 × 20 × 20 cm, 1 kg cuando se omiten las dimensiones. Para FedEx y UPS siempre proporciona las dimensiones exactas: cada centímetro afecta el precio.
• Identificadores de envío: los envíos de Zaslat usan el formato IZxxxxx (p. ej., IZ123456). Esto difiere del número de seguimiento del transportista: recupéralo mediante get_shipment_detail.
• Códigos de país: usa ISO 3166-1 alpha-2 (CZ, SK, DE).
• Códigos postales: sin espacios (60200, no 602 00).