Gelato

Un servidor de Model Context Protocol (MCP) para integrarse con la API de Print-on-Demand de Gelato. Este servidor permite que agentes de IA (como Antigravity, Claude, ChatGPT, etc.) automaticen la creación de productos a partir de URLs/archivos de diseño personalizados, inspeccionen plantillas de productos, gestionen conexiones de tiendas Shopify, exploren especificaciones del catálogo y procesen pedidos de cumplimiento de impresión.

GitHub
2
Prueba este MCPPatrocinado

Documentación

Gelato API & Shopify Automation MCP Server

Model Context Protocol License: MIT Node.js

Un servidor de Model Context Protocol (MCP) para integrarse con la API de impresión bajo demanda de Gelato. Este servidor permite que los agentes de IA (como Antigravity, Claude, ChatGPT, etc.) automaticen la creación de productos a partir de URL/archivos de diseño personalizados, inspeccionen plantillas de productos, gestionen conexiones de tiendas Shopify, exploren especificaciones del catálogo y procesen pedidos de cumplimiento de impresión.

✨ Características Clave

  • 🎨 Creación de productos basada en plantillas: Sube archivos de diseño (PNG, JPG, PDF) programáticamente a los marcadores de posición de plantillas de productos de Gelato (ImageFront, ImageBack, etc.) y publica artículos de impresión bajo demanda personalizados directamente en tus tiendas de comercio electrónico conectadas (Shopify, WooCommerce, etc.).
  • 🏪 Gestión de múltiples tiendas: Inspecciona las tiendas conectadas (gelato_list_stores), visualiza los productos de la tienda (gelato_list_products), consulta el estado de los productos (gelato_get_product) y elimina productos (gelato_delete_product).
  • 📐 Inspección de plantillas: Lista las plantillas (gelato_list_templates) e inspecciona las estructuras de capas y los IDs de variantes (gelato_get_template).
  • 📚 Exploración del catálogo: Busca en el catálogo global de productos de Gelato (gelato_search_catalog_products), lista las categorías (gelato_list_catalogs) y obtén las especificaciones de los productos (gelato_get_catalog_product).
  • 📦 Cumplimiento de pedidos y cotizaciones: Solicita cotizaciones de precios de envío/impresión (gelato_quote_order), realiza pedidos de impresión (gelato_create_order), rastrea el estado de los pedidos (gelato_get_order) y busca pedidos (gelato_search_orders).

🛠️ Herramientas MCP Disponibles

1. Gestión de Tiendas y Productos

  • gelato_list_stores — Lista todas las tiendas conectadas y sus storeIds.
  • gelato_create_product_from_template — Crea y publica un nuevo producto en una tienda a partir de una plantilla de Gelato con URLs de diseño, títulos, descripciones, etiquetas y variantes personalizados.
  • gelato_list_products — Lista todos los productos publicados en una tienda específica.
  • gelato_get_product — Recupera información detallada y el estado de publicación (publishing, active, publishing_error) de un producto.
  • gelato_delete_product — Elimina un producto de una tienda.

2. Plantillas de Gelato

  • gelato_list_templates — Lista todas las plantillas de productos creadas en tu cuenta de Gelato.
  • gelato_get_template — Recupera los detalles de una plantilla específica, incluidos los nombres de los marcadores de posición de las capas de imagen (ImageFront, ImageBack) y los templateVariantIds.

3. Catálogo de Productos

  • gelato_list_catalogs — Lista las categorías principales del catálogo de productos (Ropa, Arte de Pared, Tazas, Tarjetas, etc.).
  • gelato_search_catalog_products — Busca artículos del catálogo utilizando filtros de atributos.
  • gelato_get_catalog_product — Obtén especificaciones, áreas imprimibles, dimensiones disponibles, opciones y precios para un UID de producto del catálogo.

4. Pedidos y Cotizaciones

  • gelato_create_order — Envía un pedido de cumplimiento de impresión a Gelato.
  • gelato_quote_order — Calcula opciones de envío y cotizaciones de costos antes de realizar un pedido.
  • gelato_get_order — Recupera el estado actual del pedido y los detalles de seguimiento.
  • gelato_search_orders — Busca pedidos con paginación y búsqueda de texto.

⚙️ Instalación y Configuración

Requisitos previos

  • Node.js 18.x o superior
  • Clave de API de Gelato (obtenible desde Panel de Gelato → Desarrollador > Claves de API)

Instalación

git clone https://github.com/altetsa/gelato-mcp-server.git
cd gelato-mcp-server
npm install

Configuración

Agrega la entrada del servidor a tu archivo de configuración MCP (por ejemplo, mcp_config.json o claude_desktop_config.json de Claude Desktop):

{
  "mcpServers": {
    "gelato": {
      "command": "node",
      "args": [
        "/path/to/gelato-mcp-server/index.js"
      ],
      "env": {
        "GELATO_API_KEY": "your_gelato_api_key_here"
      }
    }
  }
}

🚀 Flujo de Trabajo de Creación de Productos

  1. Obtén el ID de la tienda: Llama a gelato_list_stores para obtener el storeId de tu tienda objetivo.
  2. Inspecciona la plantilla: Llama a gelato_get_template con tu templateId para comprobar los nombres de los marcadores de posición de las capas (por ejemplo, ImageFront) y los templateVariantIds.
  3. Crea el producto: Llama a gelato_create_product_from_template con:
    • storeId
    • templateId
    • title y description
    • variants: Matriz de objetos que contienen templateVariantId y imagePlaceholders con name y fileUrl público de tu diseño de impresión.

Ejemplo de Payload de Llamada a Herramienta:

{
  "storeId": "82ceff8e-c559-45da-9c93-3982702a0906",
  "templateId": "c12a363e-0d4e-4d96-be4b-bf4138eb8743",
  "title": "Custom Printed T-Shirt",
  "description": "<p>High quality custom printed unisex crewneck t-shirt.</p>",
  "isVisibleInTheOnlineStore": true,
  "tags": ["t-shirt", "custom-print", "unisex"],
  "salesChannels": ["web"],
  "variants": [
    {
      "templateVariantId": "83e30e31-0aee-4eca-8a8f-dceb2455cdc1",
      "imagePlaceholders": [
        {
          "name": "ImageFront",
          "fileUrl": "https://example.com/designs/front_artwork.png"
        }
      ]
    }
  ]
}

📄 Licencia

MIT © altetsa