Ir al contenido

API y MCP para imprimir etiquetas desde tus herramientas

Los planes Pro y Equipos abren una API REST y un servidor MCP para buscar productos, ver las plantillas y generar el PDF de etiquetas sin pasar por la pantalla: desde un script, una herramienta interna o un asistente como Claude o ChatGPT. Cada llamada usa una clave de API del espacio, y cada etiqueta cuenta en el plan y en el historial.

Prueba gratis de 7 días con lo de Pro (hasta 200 etiquetas), una vez por persona y por tienda Shopify. Después, el plan Gratis si no eliges nada.

La API REST

  • GET /api/v1/productos?q= busca variantes; GET /api/v1/plantillas lista las plantillas; POST /api/v1/imprimir devuelve un PDF; GET /api/v1/impresiones lee los últimos trabajos.
  • Autenticación: la cabecera Authorization: Bearer kl_live_… con una clave creada en Integraciones; solo se enseña una vez.
  • Límite: 120 peticiones por minuto y por clave.

El servidor MCP

  • Dirección https://labels.krealomedia.com/mcp, con la misma clave en la cabecera Authorization.
  • Cuatro herramientas: buscar_productos, listar_plantillas, imprimir_etiquetas (hasta 50 etiquetas por llamada) e historial_impresiones.
  • Funcionan Claude, ChatGPT y los demás clientes MCP que aceptan un servidor HTTP con cabecera.

Conviene saber

  • El PDF lo crea el servidor; la impresión física sigue haciéndose en un navegador o en un dispositivo: la API no envía nada a una impresora.
  • Revoca una clave en Integraciones en cuanto deje de usarse.

Preguntas frecuentes

¿Qué planes incluyen la API y el MCP?

Los planes Pro y Equipos, y la prueba de 7 días, que lleva lo de Pro.

¿La API manda el trabajo a mi impresora?

No. Devuelve un PDF al tamaño exacto del papel; después hay que imprimirlo.

¿Cuántas etiquetas por llamada?

Hasta 500 por PDF con la API REST (100 copias como máximo por variante) y 50 por llamada con el MCP.

¿Dónde está la clave de API?

En Integraciones: se crean, nombran y revocan las claves. Una clave se enseña entera solo al crearla.

¿Estas etiquetas cuentan en mi plan?

Sí. Las etiquetas generadas cuentan en el plan del mes y salen en el historial con API o MCP como origen.

Ver también

Tu primera etiqueta en cinco minutos

Pruébalo con el catálogo de demostración y luego conecta tu tienda.

Prueba gratis