En esta página
Shopify documenta dos interfaces oficiales de Catalog MCP: Global Catalog busca productos entre los comercios de Shopify y Storefront Catalog se limita a la tienda de un comerciante. Ambas usan la capacidad de catálogo UCP de Shopify y ofrecen herramientas para buscar, consultar y seleccionar variantes. La interfaz documentada de Catalog MCP sirve para descubrir productos; no ofrece operaciones de Shopify Admin para editar pedidos o el catálogo.
El 13 de octubre de 2026, Shopify anunció también Shop MCP, que añade carritos, checkout y búsqueda de pedidos de clientes con sesión iniciada mediante otra conexión MCP. Esto amplía el comercio con agentes, pero no convierte Catalog MCP en un editor de Shopify Admin.
Respuesta rápida: Usa Catalog MCP para descubrir productos y elegir variantes, con Global Catalog para búsquedas entre comerciantes y Storefront Catalog para una tienda. El pago y la consulta de pedidos con sesión iniciada corresponden a interfaces de comercio separadas, incluido Shop MCP.
¿Qué permite hacer MCP con el catálogo de Shopify?
Catalog MCP es una interfaz oficial de Shopify para que los agentes de IA descubran y consulten información de productos. Global Catalog busca entre los comercios que cumplen los requisitos de Shopify; Storefront Catalog se limita a la tienda de un comerciante. Ambas implementan la capacidad de catálogo UCP de Shopify y usan las mismas tres herramientas MCP, aunque el alcance y los campos de respuesta varían.
El flujo habitual tiene dos pasos. Primero, search_catalog encuentra productos a partir de texto, imágenes o identificadores; lookup_catalog resuelve identificadores de productos o variantes conocidos. Después, get_product devuelve los detalles del producto elegido, las combinaciones de opciones disponibles y enlaces de checkout. Así se puede descubrir productos y elegir variantes sin dar al agente acceso amplio a Admin API.
El paquete @shopify/dev-mcp es distinto: ofrece documentación y herramientas para desarrolladores de Shopify. No es Catalog MCP ni Shop MCP, que añade funciones de carrito, checkout y consulta de pedidos para clientes con sesión iniciada.
Cómo funciona el acceso al catálogo de Shopify mediante MCP
La capa del protocolo: qué hace MCP
MCP define cómo un cliente descubre y llama las herramientas de un servidor. UCP define la capacidad de comercio y el formato de las solicitudes y respuestas del catálogo. En el Catalog MCP actual de Shopify, el agente envía una solicitud al endpoint de Shopify e incluye la URL de su perfil de agente UCP. Las herramientas disponibles dependen de las capacidades declaradas en ese perfil. Shopify aloja el servicio; no hace falta crear un servidor MCP propio para llamar a las herramientas documentadas.
La capa de API: Admin frente a Storefront
Shopify documenta dos endpoints de Catalog MCP:
- Global Catalog:
https://catalog.shopify.com/api/ucp/mcpbusca entre comercios de Shopify. - Storefront Catalog:
https://{storeDomain}/api/ucp/mcpbusca en una sola tienda.
Ambos requieren un perfil de agente y no requieren una clave API para las solicitudes estándar. Las herramientas devuelven datos de descubrimiento del catálogo; no son un proxy de Shopify Admin API. Para cambiar productos o pedidos se necesita otra app o integración con las API y permisos adecuados. El acceso al catálogo tiene límites de frecuencia; no se deben almacenar en caché los resultados de búsqueda ni las imágenes de productos. Shopify marca algunos atributos de respuesta como inferidos, por lo que pueden faltar o variar en precisión. Antes de mostrar resultados a clientes, consulta las directrices de uso actuales.
| Función | Global Catalog MCP | Storefront Catalog MCP |
|---|---|---|
| Búsqueda de productos | Entre comerciantes aptos de Shopify | Dentro del catálogo de un comerciante |
| Endpoint | https://catalog.shopify.com/api/ucp/mcp |
https://{storeDomain}/api/ucp/mcp |
| Autenticación estándar | Perfil de agente; sin clave API obligatoria | Perfil de agente; sin clave API obligatoria |
| Herramientas de descubrimiento | search_catalog, lookup_catalog, get_product |
Las mismas tres herramientas de catálogo |
| Límite de consulta | Hasta 50 IDs de producto o variante | Hasta 10 IDs de producto o variante |
| Detalles del producto | Opciones, señales de disponibilidad y enlaces de pago | Opciones, señales de disponibilidad y enlaces de pago de la tienda |
| Escritura de productos, inventario o pedidos | No disponible | No disponible |
| Ejecución del pago | Requiere una interfaz de pago separada | Requiere una interfaz de pago separada |
Qué operaciones de catálogo admite MCP en Shopify
Las herramientas documentadas de Catalog MCP permiten estas tareas:
- Buscar por texto: encontrar productos a partir de una solicitud en lenguaje natural.
- Buscar por imagen o similitud: Global Catalog admite consultas de imágenes e identificadores de productos para descubrir artículos parecidos.
- Filtrar resultados: se admiten filtros como disponibilidad, precio, destino u origen del envío y atributos del producto.
- Consultar identificadores conocidos: recuperar datos actuales de productos o variantes; una consulta de Global Catalog puede resolver hasta 50 identificadores y Storefront Catalog hasta 10.
- Consultar un producto:
get_productdevuelve detalles completos, combinaciones de opciones y señales de disponibilidad. - Precisar una variante: enviar opciones seleccionadas, como color o talla, para obtener la variante coincidente y su enlace de checkout.
- Buscar en varias tiendas o en una: elegir Global Catalog para buscar entre comercios o Storefront Catalog para limitarse a una tienda.
Son funciones de descubrimiento. Las herramientas de catálogo no cambian precios, metacampos o inventario, no editan pedidos ni realizan el checkout.
Qué implica MCP para las operaciones posteriores a la compra
Catalog MCP puede ayudar a un agente a encontrar un producto o consultar sus opciones, pero no lee pedidos de Shopify ni realiza cambios posteriores a la compra. Mantén separadas estas funciones: usa las herramientas de agentes documentadas por Shopify para descubrir productos y una app de gestión de pedidos o una integración con los permisos adecuados para modificarlos.
La app de edición de pedidos para clientes de Revize ofrece cambios por autoservicio antes de la preparación, dentro de la ventana del comerciante. Este elige las acciones disponibles; el cliente edita mediante el bloque activado de Revize en la página de estado o de agradecimiento de Shopify o el enlace Editar pedido del correo de confirmación. Revize valida el inventario en tiempo real para cambios de variante. Una ventana de tiempo por sí sola no retiene la preparación; el comerciante debe configurar el modo y las reglas adecuados. Consulta la guía de edición de pedidos de Shopify para el editor nativo.
Comercio con agentes de IA y MCP para catálogos: qué funciona hoy y qué está por llegar
Las herramientas actuales de Shopify para agentes cumplen funciones distintas:
- Catalog MCP: búsqueda, consulta, detalles y descubrimiento de variantes mediante Global o Storefront Catalog.
- Shop MCP: servidor MCP independiente anunciado el 13 de octubre de 2026. Puede buscar productos, crear carritos, preparar checkout en tiendas Shopify, completar el pago con Shop Pay después de que el cliente confirme y buscar pedidos de clientes con sesión iniciada. Al lanzarse, el estado del pedido se consulta mediante
get_checkout; las notas indican que aún no hay webhooks. - Shopify dev MCP: documentación y herramientas para desarrolladores, no acciones de catálogo u operaciones de pedidos para comerciantes.
Para configurarlos, sigue la guía actual de Catalog o las notas de lanzamiento de Shop MCP. No des por hecho que una herramienta de un servidor también existe en otro.
Lista de implementación
Si estás evaluando Shopify Catalog MCP:
- Decide si el agente necesita búsquedas entre comerciantes o el catálogo de una tienda.
- Lee las instrucciones del endpoint y de configuración del perfil de agente correspondientes.
- Prueba búsqueda, consulta y selección de variantes con solicitudes reales, incluidas opciones no disponibles o ambiguas.
- Respeta los límites de solicitudes y las reglas contra almacenar en caché resultados e imágenes.
- Asigna descubrimiento de productos, pago y edición poscompra a herramientas que admitan explícitamente cada tarea.
Preguntas frecuentes
¿Es Catalog MCP un producto específico de Shopify?
Sí. Global Catalog MCP de Shopify busca entre comercios elegibles y Storefront Catalog MCP se limita a una tienda. El servidor @shopify/dev-mcp, dirigido a desarrolladores, es distinto.
¿Qué es exactamente Model Context Protocol?
MCP es un protocolo que permite a un cliente de IA descubrir y llamar las herramientas de un servidor. En la implementación de catálogo de Shopify, UCP define la capacidad de comercio y el formato de las solicitudes y respuestas que se transmiten mediante MCP.
¿Necesito ayuda de un desarrollador para configurar MCP con el catálogo de Shopify?
Necesitas un cliente compatible con MCP y un perfil de agente, y después configurar el endpoint de Catalog de Shopify correspondiente. Shopify aloja el servidor documentado, por lo que no hace falta crear uno propio para estas herramientas. Las funciones más avanzadas del agente pueden requerir desarrollo.
¿Qué planes de Shopify admiten MCP para el catálogo?
La documentación de Catalog describe endpoints y autenticación mediante perfil de agente, no una matriz de planes. Consulta la documentación actual de Shopify y confirma si tu tienda cumple los requisitos de la función de catálogo o de agentes que quieres usar.
¿Puede MCP modificar mi catálogo de Shopify o solo leerlo?
No. Catalog MCP ofrece herramientas de descubrimiento de productos, no operaciones para editar productos o pedidos. Shop MCP es independiente y añade carritos, checkout y búsqueda de pedidos de clientes con sesión iniciada. Los cambios mediante Admin API requieren otra app o integración autorizada.
¿En qué se diferencia MCP para el catálogo de Shopify Flow?
Flow ejecuta automatizaciones basadas en eventos en Shopify Admin. Catalog MCP permite que un agente llame herramientas de descubrimiento de productos cuando las necesita. Pueden complementarse, pero Catalog MCP no activa ni ejecuta por sí mismo un flujo de Flow.
¿Qué permisos de la Admin API requiere MCP para el catálogo?
Los endpoints alojados de Catalog MCP usan un perfil de agente y no requieren un token de Admin API ni una clave API para solicitudes estándar. Si otra integración usa operaciones de Admin API, solicita solo los permisos que necesite.
¿Puede MCP para el catálogo gestionar casos B2B de Shopify?
Las herramientas de Catalog MCP están documentadas para descubrir productos. No exponen las asignaciones de empresas ni un flujo completo de pedidos B2B. Comprueba la compatibilidad B2B actual en la API o capacidad de agente que vayas a usar; no supongas que Catalog MCP expone datos de Admin API exclusivos de Plus.
¿Qué clientes de IA funcionan con MCP para el catálogo de Shopify?
Usa un cliente compatible con MCP que pueda conectarse al endpoint y proporcionar un perfil de agente. Las notas de Shop MCP del 13 de octubre describen flujos de inicio de sesión para clientes MCP como Claude y ChatGPT; la compatibilidad y el funcionamiento dependen del cliente.
¿Consultar datos del catálogo mediante MCP afecta al rendimiento?
Shopify no publica en la documentación citada un tiempo de respuesta garantizado para Catalog MCP. La latencia depende del cliente, la consulta y las condiciones del servicio. Respeta los límites de frecuencia y no almacenes en caché los resultados del catálogo.
¿Cómo protejo mi servidor MCP para el catálogo de Shopify?
Usa el perfil de agente requerido, protege la configuración del cliente, respeta las reglas de uso y revisa qué información de producto muestra el agente. Catalog MCP no usa un token de Admin API para las solicitudes estándar; otras integraciones pueden tener credenciales y controles de acceso propios.
¿Puedo usar MCP para recomendar productos en tiempo real en el escaparate?
Catalog MCP está diseñado para que los agentes descubran productos y seleccionen variantes. Devuelve datos de producto y enlaces de checkout; Shopify no lo documenta como una API de storefront de baja latencia. Para una experiencia de tienda personalizada, elige la interfaz adecuada para los requisitos de rendimiento y presentación.
Lecturas relacionadas
Estadísticas de edición de pedidos en Shopify · Guía de endpoints MCP y UCP de Shopify · Guía para desarrolladores de Universal Commerce Protocol · Guía de Shopify AI Toolkit · Guía de gestión de pedidos de Shopify · Guía de cancelación de pedidos para clientes de Shopify · Cómo vender en ChatGPT con tiendas agénticas de Shopify · Tutorial de migración a Shopify Functions · Cómo permitir que los clientes editen pedidos de Shopify