MCP para Tienda

Cada tienda Jumpseller ahora expone un punto MCP público que los agentes de IA pueden usar para explorar tu catálogo, buscar productos y generar enlaces de compra directos — todo sin autenticación.

Este es el complemento para la tienda del Servidor MCP Admin. Mientras que el MCP Admin requiere autenticación y permite administrar tu tienda, el MCP para Tienda es de acceso público y proporciona acceso solo de lectura a la misma información que un visitante ve en tu sitio web.

¿Por Qué es Importante?

Los agentes de IA son cada vez más la forma en que las personas descubren y compran productos. Con el MCP para Tienda, tu tienda está preparada para este cambio:

• Asistentes de compra con IA pueden buscar tus productos, comparar precios y enviar a los clientes un enlace de compra directo
• Chatbots en tu sitio o en plataformas externas pueden responder preguntas sobre productos con datos en tiempo real
• Recomendaciones de productos con IA pueden obtener tu catálogo real en lugar de depender de feeds desactualizados
• Motores de búsqueda y agregadores de IA pueden descubrir tu punto MCP a través de llms.txt y .well-known/mcp.json

Punto de Acceso

El MCP para Tienda está disponible en cada tienda en:

POST https://tu-tienda.com/api/mcp

Reemplaza tu-tienda.com con el dominio real de tu tienda (dominio personalizado o tutienda.jumpseller.com).

Transporte: Streamable HTTP (JSON-RPC 2.0 sobre POST). Sin estado — cada solicitud es independiente.

Autenticación: No se requiere. Es un punto de acceso público.

Descubrimiento

Los agentes de IA y rastreadores pueden descubrir el punto MCP automáticamente a través de dos archivos estándar:

• /api/mcp/llms.txt — Descripción legible del servidor MCP y sus herramientas
• /api/mcp/.well-known/mcp.json — Metadatos de descubrimiento MCP legibles por máquina

Herramientas Disponibles

El MCP para Tienda proporciona 6 herramientas de solo lectura:

¿Qué Datos se Devuelven?

Productos incluyen: nombre, descripción (texto plano), precio, precio de comparación, marca, SKU, disponibilidad de stock, imágenes, variantes con precios por variante y enlaces de compra, categorías, permalink, y URLs directas para agregar al carrito y comprar ahora.

Categorías incluyen: nombre, descripción, permalink, URL, imágenes, título de página y meta descripción.

Información de la tienda incluye: nombre, descripción, país, moneda, URL y logo.

Solo se devuelven productos disponibles. Los productos desactivados u ocultos por falta de stock nunca se exponen. Datos sensibles del comerciante (costos, márgenes, configuraciones internas) nunca se incluyen.

Ejemplo: Buscar Productos

Envía una solicitud JSON-RPC al punto MCP de tu tienda:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "search_products",
    "arguments": {
      "query": "vestido verano",
      "limit": 5
    }
  },
  "id": 1
}

La respuesta incluye productos que coinciden con nombres, precios, imágenes y enlaces de compra directos.

Ejemplo: Obtener un Producto

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_product",
    "arguments": {
      "permalink": "vestido-verano-azul"
    }
  },
  "id": 1
}

Límites de Uso

El MCP para Tienda tiene dos límites para garantizar un uso justo:

• 50 solicitudes por minuto por dirección IP (en todas las herramientas)
• 10 búsquedas por minuto por tienda (solo para search_products)

Si excedes estos límites, recibirás una respuesta de error. Espera un minuto e intenta de nuevo.

Conectar un Agente de IA

Cualquier cliente compatible con MCP puede conectarse al MCP de tu tienda. Aquí tienes un ejemplo de configuración:

{
  "mcpServers": {
    "mi-tienda": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://tu-tienda.com/api/mcp"
      ]
    }
  }
}

No se necesitan encabezados de autenticación — solo apunta el cliente al endpoint /api/mcp de tu tienda.

MCP Tienda vs MCP Admin

Muy Pronto

Estamos trabajando en ampliar el MCP para Tienda con herramientas de checkout y pago, para que los agentes de IA puedan guiar a los clientes a través de todo el flujo de compra — desde el descubrimiento del producto hasta el pedido completado.

Privacidad y Seguridad

El MCP para Tienda solo expone datos que ya son visibles públicamente en el sitio web de tu tienda:

• Nombres, descripciones, precios e imágenes de productos
• Nombres y descripciones de categorías
• Nombre, país y moneda de la tienda

No expone:

• Datos de clientes
• Información de pedidos
• Costos o márgenes de productos
• Configuraciones internas o tokens de API
• Direcciones de correo electrónico