En esta página
Shopify MCP abarca interfaces con objetivos distintos. La guía de migración de Storefront MCP traslada las antiguas herramientas de catálogo y carrito a UCP y conserva la herramienta de políticas/FAQ y Customer Accounts MCP. Elige según la tarea del comprador y comprueba esquema y autorización. Esta guía también explica dónde encaja la edición poscompra para clientes.
La versión breve de la parte técnica
MCP (Model Context Protocol) es una interfaz de herramientas utilizada por clientes de IA. La documentación de comercio actual de Shopify también describe endpoints UCP (Universal Commerce Protocol) para descubrir catálogos, realizar el checkout y acceder a pedidos. Un cliente debe utilizar el esquema, la autenticación y los permisos actuales del endpoint; los nombres y capacidades de los endpoints no son intercambiables.
| Interfaz | Para qué sirve | Documentación actual |
|---|---|---|
| Catálogo por tienda | Descubrimiento de productos de un comerciante | Storefront Catalog — https://{shop}.myshopify.com/api/ucp/mcp |
| Global Catalog | Descubrimiento de productos en Shopify | Resumen del catálogo para agentes |
| Políticas y FAQ | Respuestas sobre políticas y FAQ de un comerciante | Herramienta de políticas y FAQ — https://{shop}/api/mcp |
| Checkout MCP | Sesión de pago y derivación del comprador | Checkout MCP |
| Order MCP | Leer información compatible de pedidos originados por agentes | Order MCP |
| Customer Accounts MCP | Solicitudes autenticadas de pedidos y cuentas de clientes | Customer Accounts MCP — descubierto https://{shop}/customer/api/mcp, código de autorización OAuth con PKCE |
| Dev MCP | Documentación de desarrollo y herramientas de esquemas | Shopify AI Toolkit |
Storefront Catalog documenta search_catalog, lookup_catalog y get_product y requiere el perfil en meta.ucp-agent.profile. Checkout y Order MCP tienen reglas de acceso y operaciones distintas. Para herramientas de descubrimiento y límites, consulta nuestra guía de Shopify Catalog MCP.
Nuestra recomendación: desarrolla contra el endpoint documentado actual
Migra integraciones herramienta por herramienta: el descubrimiento usa Storefront Catalog, las operaciones de carrito usan Cart MCP y el pago usa Checkout MCP. Mantén las consultas de políticas en /api/mcp. Prueba esquema y reglas de acceso de cada sustitución en desarrollo antes de trasladar tráfico.
El endpoint de catálogo puede permitir descubrir productos, pero por sí solo no demuestra que un agente pueda crear un checkout, leer el pedido de un comprador o modificarlo. Son flujos separados. Dev MCP del AI Toolkit está dirigido a desarrolladores y es distinto de los endpoints de comercio para compradores.
Qué hace realmente un agente de IA en tu tienda
La secuencia depende del agente y de la interfaz de Shopify que utilice. Una solicitud de catálogo puede buscar o recuperar datos de productos. Un flujo de checkout puede requerir autenticación o una solicitud firmada, y puede enviar al comprador a revisar o completar la compra. Order MCP de Shopify documenta get_order para pedidos compatibles originados por agentes; no es una API general de historial de pedidos entre canales. Lee el alcance de cada endpoint antes de conectarlo con soporte al cliente o preparación de pedidos.
El acceso autenticado del cliente es una integración separada
Customer Accounts MCP permite a un asistente gestionar detalles y estado de pedidos y preferencias del cliente con sesión iniciada en esa tienda. Descubre mcp_api en https://{shop}/.well-known/customer-account-api y autentica con código de autorización OAuth 2.0 y PKCE. Requiere dominio personalizado, configuración de autenticación y acceso adecuado a datos protegidos de clientes. Tras autenticar, usa tools/list para inspeccionar herramientas y esquemas reales; no supongas cambios arbitrarios ni acceso entre comerciantes.
Order MCP, en cambio, usa credenciales del agente para leer pedidos realizados mediante él. La guía de webhooks de pedidos describe actualizaciones UCP y registro por parte de Shopify mediante un responsable de partners. Nuestra guía de operaciones de pedidos agénticos cubre entrega y conciliación.
El flujo poscompra es independiente
Un endpoint de descubrimiento de productos o de checkout no proporciona una operación general de edición de pedidos. La documentación actual de Order MCP de Shopify describe la lectura del estado de pedidos compatibles originados por agentes; no los edita. Esa distinción importa cuando un cliente necesita corregir una dirección, cantidad o variante después del checkout.
La tienda debe ofrecer al cliente una vía para cambios aptos según política y estado de preparación. La app de edición de pedidos para clientes de Revize admite cambios de dirección, cantidad, variante y cancelación antes de la preparación durante la ventana del comerciante. Cambiar entre productos, añadir artículos, aplicar descuentos y reembolsar en crédito son funciones Pro. El portal requiere el bloque de Revize en la página de estado y también se abre desde Editar pedido por correo. Consulta nuestra guía de edición de pedidos de Shopify para el flujo y límites nativos.
Qué documenta Shopify hoy
Estas son las capacidades documentadas que debes verificar con las referencias actuales de Shopify:
- Descubrimiento del catálogo específico de la tienda mediante el endpoint UCP, con herramientas de catálogo documentadas y un perfil de agente.
- Un endpoint de Global Catalog separado para descubrir productos de forma más amplia.
- Checkout MCP con sus propios requisitos de autenticación o solicitud firmada y posible derivación del comprador.
- Order MCP con una herramienta
get_orderpara pedidos compatibles originados por agentes. - Customer Accounts MCP para solicitudes autorizadas de clientes y herramienta de políticas/FAQ para preguntas públicas de la tienda.
- Un conjunto local de herramientas de desarrollo mediante el AI Toolkit y Dev MCP de Shopify.
El nombre de un endpoint por sí solo no establece acceso ilimitado, historial universal de cuentas ni permisos de edición. Usa el alcance documentado de cada interfaz. Nuestra guía de Shopify AI Toolkit explica las herramientas de desarrollo por separado.
Qué haríamos realmente este trimestre
- Elige el endpoint según la tarea. Utiliza la documentación actual de Storefront Catalog para descubrir productos, la de Checkout MCP para el checkout y la de Order MCP para lecturas de pedidos compatibles.
- Comprueba los requisitos de perfil y acceso. Las solicitudes de Storefront Catalog incluyen
meta.ucp-agent.profile; comprueba por separado los requisitos exactos de cada otro endpoint. - Prueba en un entorno de desarrollo. Valida el esquema de solicitud, los campos devueltos, la autenticación y la derivación del comprador antes de planificar un lanzamiento para clientes.
- Audita la poscompra por separado. Asegúrate de que los clientes puedan revisar o solicitar cambios elegibles de pedidos; no esperes que MCP edite un pedido completado.
- Vuelve a comprobar la documentación antes de publicar. Las API de agentes de Shopify y la compatibilidad de clientes pueden cambiar; utiliza documentación primaria actual en lugar de ejemplos copiados.
La conclusión
Define qué datos necesita el cliente y de quién procede la autorización. Descubrimiento, pago, respuestas públicas de políticas, cuentas y lecturas de pedidos de agentes tienen contratos distintos. Nuestra guía para desarrolladores de Universal Commerce Protocol explica la negociación de capacidades bajo las interfaces UCP.
Como comerciante, incluye explícitamente el servicio al cliente y la edición poscompra en el diseño. El Order MCP documentado de Shopify puede leer pedidos compatibles originados por agentes; no ofrece un flujo general de edición de pedidos. Un portal de edición para clientes, la política del comerciante y el límite de preparación del pedido siguen siendo consideraciones separadas.
Preguntas frecuentes
¿Cuál es el endpoint actual de Shopify MCP?
Usa /api/ucp/mcp para Storefront Catalog y herramientas documentadas de carrito y pago. Las políticas públicas siguen en /api/mcp; las solicitudes autenticadas usan el endpoint descubierto de Customer Accounts MCP. Elige el que admita la tarea concreta.
¿Qué endpoint de Shopify debo usar para descubrir productos?
Utiliza el endpoint de catálogo específico de la tienda documentado para el catálogo de un comerciante, o el endpoint separado de Global Catalog de Shopify para descubrir catálogos de forma más amplia. Consulta la descripción general del catálogo para conocer las herramientas y requisitos de solicitud actuales.
¿Qué es UCP?
UCP es el protocolo de comercio abierto de Shopify para interacciones documentadas entre agentes, comerciantes, proveedores de credenciales y proveedores de pagos. Utiliza las referencias específicas de cada endpoint, porque las operaciones de descubrimiento, checkout y pedidos no comparten un modelo universal de permisos.
¿Necesito un perfil de agente?
La documentación de Storefront Catalog exige el perfil en meta.ucp-agent.profile. Consulta la documentación de cada otro endpoint, en lugar de asumir que el mismo requisito o permiso se aplica en todas partes.
¿Puede un agente de IA completar el checkout?
Shopify documenta Checkout MCP por separado. Su flujo actual requiere autenticación o una solicitud firmada, y puede enviar al comprador a revisar o completar el checkout. Consulta la referencia de Checkout MCP para conocer la vía compatible.
¿Shopify MCP está disponible en todos los planes?
La disponibilidad y el acceso dependen del endpoint y de la configuración de la tienda. Comprueba la documentación actual de planes y endpoints de Shopify para la integración concreta; no deduzcas el acceso por plan a partir de un ejemplo de MCP.
¿En qué se diferencia Global Catalog de Storefront Catalog?
Storefront Catalog se limita a un comerciante. Global Catalog es un endpoint de descubrimiento separado para buscar productos en todo Shopify. Sus endpoints y contratos de herramientas difieren.
¿Qué hace Order MCP?
Shopify documenta una herramienta get_order para leer el estado actual de pedidos compatibles originados por agentes. No es un endpoint general de historial de pedidos para todos los canales de un cliente.
¿En qué se diferencia Customer Accounts MCP de Order MCP?
Customer Accounts MCP usa la autorización OAuth del cliente para solicitudes de cuenta y pedidos de esa tienda. Order MCP usa acceso limitado al agente y recupera solo pedidos realizados mediante él. Descubre el esquema de cada herramienta antes de elegir una operación de atención al cliente.
¿Resuelve Shopify MCP los cambios de pedidos después de la compra?
No. La documentación actual de Order MCP describe lecturas de pedidos, no edición. Los cambios de pedidos por parte del cliente necesitan un flujo separado y siguen sujetos a la política de la tienda y al estado de preparación del pedido.
¿Cómo pruebo un endpoint de Shopify?
Sigue la referencia oficial de ese endpoint y prueba la solicitud documentada en un entorno de desarrollo. Confirma su autenticación, los datos de perfil obligatorios, los campos devueltos y cualquier derivación del checkout antes de publicar.
¿Qué informó Shopify sobre el crecimiento de la búsqueda con IA?
Shopify informó en junio de 2026 de que los pedidos procedentes de búsquedas con IA se habían multiplicado por 13 interanualmente, con una conversión un 49 % mayor y un valor medio del pedido un 14 % mayor. Esas cifras describen los datos de búsqueda con IA de Shopify, no el rendimiento de un endpoint MCP concreto. Consulta el informe de Shopify.
¿Cuál es el paso de implementación más prioritario?
Elige una tarea concreta, sigue la documentación actual del endpoint de Shopify correspondiente y prueba la solicitud completa y la experiencia del cliente. Mantén separados los flujos de catálogo, checkout, lectura de pedidos y edición poscompra.
Lecturas relacionadas
Cómo vender en ChatGPT con tiendas agénticas de Shopify · Cómo permitir que los clientes editen pedidos de Shopify