Shopify MCP migra a UCP: guía de migración antes de junio 2026

Qué cambió en el Storefront Catalog MCP de Shopify

Shopify ha migrado oficialmente el Storefront Catalog MCP a la Unified Commerce Platform (UCP). No se trata de una actualización menor: cambian el endpoint de referencia, los nombres de las herramientas y los esquemas de request/response. Quienes hayan construido integraciones AI-assisted o arquitecturas headless que dependan de las antiguas herramientas MCP tienen una fecha límite clara: 15 de junio de 2026.

Hasta esa fecha las herramientas antiguas siguen activas, pero toda la documentación oficial de Shopify ya apunta a la nueva versión. Esperar significa enfrentarse a una migración de urgencia, con los riesgos operativos que eso conlleva.

---

Las nuevas herramientas UCP: nombres, funciones y diferencias

La nueva superficie MCP expone tres herramientas principales, con nombres y comportamientos redefinidos respecto a la versión anterior.

search_catalog

Sustituye a la antigua herramienta search. Realiza búsquedas en el catálogo de productos con soporte para:

• filtros estructurados por atributo, categoría y disponibilidad
• paginación nativa de resultados
• contexto de comprador (buyer context), útil para personalizar los resultados según mercado, moneda o segmento

lookup_catalog

Sustituye a la antigua herramienta lookup. Permite la recuperación en batch de productos o variantes a partir de uno o varios identificadores. Es la herramienta correcta cuando ya se conoce el ID del producto o la variante y se quieren obtener datos estructurados sin realizar una búsqueda.

get_product

Herramienta nueva respecto a la versión anterior. Devuelve el detalle completo de un único producto, incluida la selección de variante y las señales de disponibilidad (availability signals). Es el punto de acceso para agentes e integraciones que necesitan mostrar una ficha de producto detallada o gestionar la lógica de selección de variante en el lado de la IA.

---

El nuevo endpoint de referencia

El endpoint cambia de forma sustancial. El path antiguo se reemplaza por:

`` https://{storedomain}/api/ucp/mcp ``

Todas las llamadas MCP deben redirigirse a este path. Las integraciones que sigan apuntando al endpoint antiguo funcionarán hasta la fecha límite, pero no se beneficiarán de las actualizaciones y extensiones previstas para la UCP.

---

Por qué esta migración importa más allá del saneamiento técnico

El paso a la UCP no es solo un cambio de nomenclatura. Shopify está unificando bajo una única superficie de acceso todos los puntos de contacto entre agentes de IA, integraciones headless y el catálogo de productos. Esto tiene implicaciones arquitectónicas concretas:

• Consistencia de esquemas: una sola estructura de request/response para todas las integraciones, independientemente del canal
• Contexto de comprador integrado: la UCP incorpora de forma nativa el concepto de buyer context, habilitando personalizaciones que antes requerían capas adicionales
• Escalabilidad para agentes de IA: las herramientas UCP están diseñadas para ser consumidas por agentes basados en LLM, con descripciones estructuradas que mejoran la capacidad del modelo para seleccionar la herramienta correcta

Quienes estén evaluando o ya hayan implementado arquitecturas AI-assisted para el storefront deben considerar la UCP como la referencia estable sobre la que construir, no como un destino futuro.

---

Plan de migración: qué hacer ahora

La migración está técnicamente acotada, pero requiere atención a los esquemas. Estos son los pasos operativos:

1. Verificar las integraciones existentes: comprobar si la aplicación usa las antiguas herramientas search y lookup en las llamadas MCP
2. Actualizar los nombres de las herramientas: reemplazar search por search_catalog y lookup por lookup_catalog; evaluar dónde integrar get_product
3. Migrar el endpoint: actualizar el path hacia /api/ucp/mcp en todos los entornos (desarrollo, staging, producción)
4. Revisar los esquemas de request/response: cada tool call puede tener parámetros adicionales o renombrados; es necesaria una prueba de regresión sobre todas las llamadas antes del go-live
5. Actualizar la documentación interna: si el equipo mantiene documentación sobre las integraciones, alinearla antes de que las referencias antiguas generen confusión

Si estás construyendo o manteniendo integraciones de Shopify con herramientas de IA, puedes consultar los planes para desarrolladores disponibles en Barikreativa para valorar el soporte técnico disponible.

---

Fecha límite y riesgo operativo

El 15 de junio de 2026 es la fecha de deprecación confirmada. Pasada esa fecha, las herramientas antiguas dejarán de estar garantizadas. Las integraciones que no hayan completado la migración corren el riesgo de sufrir interrupciones del servicio sin aviso previo adicional.

El mejor momento para iniciar la migración es ahora, mientras las herramientas antiguas siguen activas y los equipos pueden probar en paralelo sin presión operativa.