Guía de integración · Actualizado el 18 de febrero de 2026 · 5 min de lectura
Resumen
Spaces se integra con el servidor Storefront MCP (Model Context Protocol) de Shopify para brindarles a sus clientes una experiencia de compra impulsada por IA. A través de esta conexión, un asistente de IA puede buscar en su catálogo de productos, gestionar los carritos de compra y guiar a los compradores durante el proceso de pago, todo dentro de una conversación natural.
Nota: no se requiere ninguna configuración. Spaces se conecta automáticamente a los datos existentes de su tienda a través del extremo MCP integrado de Shopify. No es necesario instalar aplicaciones, escribir código ni realizar configuraciones en su panel de administración de Shopify.
Cómo funciona
Cuando un cliente utiliza Spaces para comprar en su tienda, esto es lo que sucede:
1. El cliente hace una pregunta. Un comprador que navega por su tienda le pregunta sobre los productos al asistente de IA de Spaces, como si hablara con un empleado de la tienda que conoce bien el catálogo.
2. La IA busca en su catálogo. El asistente consulta el servidor Storefront MCP de su tienda para encontrar los productos que coincidan, junto con precios, imágenes, descripciones y enlaces directos.
3. Se gestiona el carrito. El asistente puede crear un carrito, agregar artículos, actualizar cantidades, quitar productos y compartir un enlace de pago, todo dentro de la conversación.
4. El cliente finaliza la compra. El comprador es dirigido a la página de pago nativa de Shopify de su tienda para completar la compra utilizando los métodos de pago y las opciones de envío configurados.
Todo el proceso ocurre a través de la infraestructura segura de Shopify. Los datos de productos, precios e inventario se entregan en tiempo real, sin sincronización ni duplicación de datos.
Búsqueda de catálogos
La herramienta search_shop_catalog permite que el asistente de IA busque en todo su catálogo de productos en nombre del cliente. Admite consultas en lenguaje natural, de modo que los compradores pueden describir lo que buscan tal como se lo preguntarían a una persona real.
Qué pueden hacer los clientes
- Buscar productos por nombre, categoría o descripción
- Solicitar recomendaciones basadas en preferencias o casos de uso
- Explorar resultados que incluyen nombres de productos, precios, imágenes y enlaces directos a su tienda
Lo que se devuelve al cliente
| Datos | Descripción |
|---|---|
| Nombre del producto | El título del producto que coincide |
| Precio y moneda | El precio actual en la moneda de su tienda |
| ID de variante | La variante específica (utilizada internamente para operaciones de carrito) |
| URL del producto | Enlace directo a la página del producto en su escaparate |
| URL de la imagen | Imagen del producto |
| Descripción | La descripción del producto desde su panel de administración de Shopify |
Interacción de ejemplo
Cliente: "Estoy buscando café orgánico, de preferencia de comercio justo".
Spaces AI: "¡Encontré 3 opciones en la tienda! Estas son las mejores coincidencias:
- ☕ Fair Trade Organic Blend – $18.99
- ☕ Ethiopian Single Origin – $22.50
- ☕ Decaf Organic Roast – $16.99
¿Le gustaría agregar alguno de estos a su carrito?"
Gestión del carrito de compras
Spaces ofrece funcionalidad completa de carrito a través de dos herramientas: get_cart y update_cart.
Recuperar el carrito
get_cart recupera el contenido actual del carrito de un cliente, incluidos todos los artículos, las cantidades, los precios y una URL directa de pago. El asistente de IA puede mostrarle al cliente su carrito en cualquier momento durante la conversación.
Importante: el carrito existe dentro de Spaces y no se comparte con Shopify.
Actualización del carrito
update_cart gestiona todas las modificaciones del carrito:
- Crear un carrito nuevo — Cuando un cliente agrega su primer artículo, el carrito se crea automáticamente.
- Agregar artículos — Los productos encontrados mediante la búsqueda en el catálogo se agregan utilizando su ID de variante.
- Actualizar las cantidades — Los clientes pueden cambiar la cantidad de cualquier artículo del carrito.
- Quitar artículos — Si se establece la cantidad en 0, el artículo se elimina por completo.
Proceso de pago
Cuando el cliente está listo para comprar, el asistente le proporciona un enlace directo a la página de pago de Shopify de su tienda. El pago se procesa mediante su flujo de pago estándar, con cualquier personalización, método de pago y opción de envío que usted haya configurado.
Interacción de ejemplo
Cliente: "Agregue 2 bolsas de Fair Trade Organic Blend a mi carrito."
Spaces AI: "¡Listo! Agregué 2 × Fair Trade Organic Blend (18,99 USD cada una) a su carrito. Total del carrito: 37,98 USD. ¿Desea continuar con el pago o seguir explorando?"
Cliente: "En realidad, hágalo 3 bolsas."
Spaces AI: "¡Actualizado! Su carrito ahora tiene 3 × Fair Trade Organic Blend. Nuevo total: 56,97 USD. Aquí tiene su enlace de pago para cuando esté listo →"
El extremo MCP de su tienda
Cada tienda de Shopify tiene un extremo MCP dedicado al que Spaces se conecta automáticamente. No se requiere ninguna configuración.
Formato del extremo
https://{your-store}.myshopify.com/api/mcpReemplace {your-store} con su dominio de Shopify. Por ejemplo, si su tienda es cool-beans-coffee.myshopify.com, su extremo será:
https://cool-beans-coffee.myshopify.com/api/mcp
Aspectos clave
- No se requiere autenticación — El extremo es de acceso público, igual que su escaparate. Solo expone datos que ya son visibles en su tienda en línea.
- Datos en tiempo real — Los cambios que realice en su panel de administración de Shopify se reflejan de inmediato.
- Seguro por diseño — Solo permite acceso de lectura al catálogo y operaciones estándar de carrito. No hay acceso administrativo, datos de cuentas de clientes ni historial de pedidos.
Referencia de funciones
En la siguiente tabla se resumen todas las herramientas de Storefront MCP y su estado dentro de la integración con Spaces:
| Herramienta | Lo que hace | Estado |
|---|---|---|
search_shop_catalog |
Busca en su catálogo de productos mediante consultas en lenguaje natural y devuelve los productos coincidentes con todos sus detalles. | ✅ Activo |
get_cart |
Recupera el contenido actual del carrito, incluidos los artículos, las cantidades y la URL de pago. | ✅ Activo |
update_cart |
Crea carritos, agrega artículos, actualiza cantidades y elimina artículos. | ✅ Activo |
search_shop_policies_and_faqs |
Responde preguntas sobre las políticas de la tienda, las preguntas frecuentes y la información general del negocio. | ❌ No se utiliza |
Nota: la búsqueda de políticas y preguntas frecuentes no está activa. La herramienta
search_shop_policies_and_faqsestá disponible en el servidor Storefront MCP de Shopify, pero actualmente Spaces no la utiliza. Esta función podría agregarse en una futura actualización.
Preguntas frecuentes
¿Necesito instalar algo? No. El extremo de Storefront MCP viene integrado en cada tienda de Shopify. Spaces se conecta a él automáticamente: no se necesitan aplicaciones, código ni configuraciones administrativas.
¿Esto afectará mi tienda en línea existente? Para nada. El extremo MCP funciona junto con su escaparate. Lee los mismos datos de producto que ya son visibles públicamente y no modifica la configuración de la tienda, los temas ni los datos de los clientes.
¿Qué datos de producto se comparten? Solo los datos que ya son visibles públicamente en su escaparate: nombres de productos, descripciones, precios, imágenes, información de variantes y URLs. No se expone ningún dato privado ni exclusivo de administración.
¿Puede el asistente de IA procesar pagos? No. El asistente ayuda a los clientes a armar su carrito y luego los dirige a la página de pago estándar de Shopify. Todo el proceso de pago se realiza a través de su flujo de pago existente.
¿Con qué rapidez se reflejan los cambios en los productos? Los cambios se reflejan en tiempo real. Cuando usted actualiza el precio, el título, la descripción o la disponibilidad de un producto en su panel de administración de Shopify, esos cambios quedan disponibles de inmediato a través del extremo MCP.
¿Esto es seguro? Sí. El extremo ofrece acceso de solo lectura al catálogo y operaciones estándar de carrito. No puede acceder a su panel de administración, las cuentas de los clientes, el historial de pedidos ni ningún dato privado.
Obtener ayuda
Si tiene preguntas sobre la integración con Spaces o necesita ayuda, puede consultar:
- Shopify Help Center — Para preguntas generales sobre la gestión y configuración de tiendas.
- Shopify Developer Docs — Para obtener información técnica sobre el servidor Storefront MCP, visite shopify.dev/docs/apps/build/storefront-mcp/servers/storefront.
- Spaces Support — Para preguntas específicas sobre la integración con Spaces y la experiencia de compra con IA.