MCP para Tienda

Cada tienda Jumpseller ahora expone un endpoint 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 endpoint 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 endpoint MCP automáticamente a través de dos archivos estándar:

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

Herramientas Disponibles

El MCP para Tienda proporciona 6 herramientas de solo lectura:

Herramienta	Qué hace
`get_store_info`	Obtener nombre, URL, país, moneda, descripción y logo de la tienda
`list_products`	Explorar productos con paginación. Filtrar por permalink de categoría
`get_product`	Obtener detalles completos del producto por id o permalink: precio, imágenes, variantes, enlaces de compra
`search_products`	Búsqueda de texto completo en nombre, descripción y SKU del producto
`list_categories`	Obtener el árbol completo de categorías con nombres y permalinks
`get_category`	Obtener detalles de categoría por permalink: descripción, imágenes, campos SEO

¿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, un id, y URLs directas para agregar al carrito y comprar ahora. El id es el mismo que usan el endpoint UCP y las herramientas en la página, así un agente puede llevarlo de una a otra.

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 vendedor (costos, márgenes, configuraciones internas) nunca se incluyen.

Ejemplo: Buscar Productos

Envía una solicitud JSON-RPC al endpoint 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": {
      "product": "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 tienda y 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

	MCP Tienda	MCP Admin
URL	`tu-tienda.com/api/mcp`	`mcp.jumpseller.com`
Autenticación	Ninguna (público)	Token API u OAuth 2.0
Acceso	Solo lectura	Lectura y escritura
Datos	Solo catálogo público	Gestión completa de la tienda
Uso	Compras con IA, chatbots, descubrimiento de productos	Administración, automatización

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

¡Comenzá tu viaje con nosotros!

Probar gratis por 7 días. No se requiere tarjeta de crédito.