En esta página
El Shopify AI Toolkit es un conjunto de herramientas para desarrolladores; Universal Commerce Protocol (UCP) y los endpoints de comercio de Shopify son partes relacionadas, pero separadas, de la plataforma. Esta guía describe el Toolkit actual, los endpoints UCP de la documentación para desarrolladores de Shopify y lo que esas interfaces hacen para los responsables de tiendas. El análisis de Revize concluyó que el 5,2 % de los pedidos se editan después del checkout (Revize, 2026); ese dato aporta contexto para las operaciones poscompra, no es una afirmación sobre pedidos de IA.
El Toolkit puede ayudar a los desarrolladores a encontrar documentación actual de Shopify y orientación sobre API desde herramientas de programación con IA compatibles. Los comerciantes deben evaluar las integraciones de comercio según sus propias necesidades, la documentación actual de endpoints de Shopify y el comportamiento de cada proveedor de agentes. Esta guía se centra en esos aspectos verificables.
¿Qué es el kit de herramientas de IA de Shopify?
El AI Toolkit de Shopify ofrece un plugin, agent skills y un servidor Dev MCP local para herramientas de desarrollo con IA compatibles. Shopify enumera actualmente Claude Code, Codex, Antigravity CLI, Cursor, OpenClaw, Pi, VS Code y Hermes para el plugin; OpenClaw, Pi y Hermes solo están disponibles mediante el plugin. Consulta la documentación oficial del AI Toolkit para conocer los pasos actuales de configuración y las herramientas compatibles. Dev MCP se ejecuta localmente y no requiere autenticación en una tienda Shopify para sus herramientas de documentación y esquemas.
Dev MCP local expone recursos de desarrollo mediante Model Context Protocol. Las operaciones de tienda usan un contexto autenticado separado de Shopify CLI; instalar un servidor de documentación no autoriza acceder a la tienda de un comerciante.
Las funciones útiles de desarrollo son concretas:
- Encuentra documentación actual: identifica la API y versión adecuadas antes de generar una integración.
- Inspecciona esquemas GraphQL: comprueba nombres de campos, argumentos y tipos de retorno antes de redactar una consulta o mutación.
- Valida código: contrasta el GraphQL, Liquid y código de extensiones generado con los esquemas de Shopify y prueba después el comportamiento de ejecución localmente.
- Gestiona una tienda mediante CLI: prepara una operación de alcance limitado, autentica la tienda seleccionada, revisa la consulta y variables y elige cuándo ejecutarla. Las mutaciones requieren una activación explícita.
La validación detecta errores de esquemas y componentes; no demuestra que un cambio se ajuste a las reglas del negocio. Revisa las diferencias, los permisos solicitados y la tienda de destino antes de ejecutar.
Interfaces de Commerce MCP y UCP de Shopify
Shopify documenta interfaces de comercio separadas para descubrir catálogos, realizar el checkout y acceder a pedidos. Tienen patrones de endpoints, autenticación y operaciones distintos; ninguna debe tratarse como una interfaz universal para agentes.
1. Storefront Catalog mediante UCP
El endpoint de catálogo específico de tienda de Shopify es https://{shop}.myshopify.com/api/ucp/mcp, con search_catalog, lookup_catalog y get_product y un perfil de agente en meta.ucp-agent.profile. La guía de migración de Storefront MCP traslada las herramientas de catálogo y carrito a UCP, pero conserva search_shop_policies_and_faqs en /api/mcp. Usa la referencia de Storefront Catalog para el contrato de descubrimiento.
No asumas que este endpoint cubre el checkout o los cambios de pedidos. Shopify documenta el checkout y los pedidos como interfaces de agentes separadas, con su propia autenticación, permisos y operaciones compatibles.
2. Global Catalog
Shopify documenta un endpoint de Global Catalog en https://catalog.shopify.com/api/ucp/mcp para descubrir catálogos en todo Shopify. Sus herramientas y requisitos de acceso difieren del endpoint de catálogo específico de la tienda de un comerciante. Consulta la descripción general del catálogo para agentes de Shopify antes de desarrollar; no reutilices ejemplos antiguos de endpoints o herramientas de Storefront MCP.
3. Order MCP: acceso a pedidos originados por el agente
Order MCP de Shopify documenta actualmente una herramienta get_order para recuperar el estado actual de los pedidos originados por el agente. No proporciona acceso general a todo el historial de pedidos de un cliente ni edita pedidos. La herramienta requiere los permisos pertinentes de acceso a pedidos y del perfil del agente. Lee la documentación de Order MCP de Shopify antes de basar un flujo en ella.
Shopify también documenta capacidades de checkout separadas mediante Checkout MCP. Se requiere autenticación o una solicitud firmada, y el flujo puede derivar al comprador para que revise o complete el checkout. Consulta la documentación de Checkout MCP para conocer el contrato actual.
4. Customer Accounts MCP: solicitudes autenticadas de clientes
Customer Accounts MCP sigue siendo compatible. Descubre mcp_api mediante https://{shop}/.well-known/customer-account-api; su patrón de endpoint es https://{shop}/customer/api/mcp. El código de autorización OAuth con PKCE concede acceso específico del cliente a detalles y estado de pedidos y preferencias de cuenta en esa tienda. La app necesita configuración de autenticación de clientes, un dominio personalizado y acceso a datos protegidos de clientes. Usa tools/list para descubrir las operaciones compatibles. Esto difiere del alcance de pedidos originados por el agente de Order MCP; ninguno de los nombres implica cambios arbitrarios de pedidos.
| Interfaz | Para qué sirve | Documentación actual |
|---|---|---|
| Shopify AI Toolkit / Dev MCP | Documentación de desarrollo y herramientas de esquemas | AI Toolkit |
| Storefront Catalog | Descubrimiento de productos de un comerciante | Storefront Catalog |
| Políticas y FAQ | Preguntas públicas sobre las políticas de un comerciante | Herramienta de políticas y FAQ — /api/mcp |
| Global Catalog | Descubrimiento de catálogos en Shopify | Resumen del catálogo para agentes |
| Checkout MCP | Sesión de pago y derivación del comprador | Checkout MCP |
| Order MCP | Leer el estado de pedidos compatibles originados por agentes | Order MCP |
| Customer Accounts MCP | Solicitudes de pedidos y cuentas autorizadas por el cliente | Customer Accounts MCP — /customer/api/mcp, OAuth PKCE |
Universal Commerce Protocol (UCP): la capa que conecta a las demás
Shopify describe UCP como un protocolo de comercio abierto para las interacciones entre agentes, comerciantes, proveedores de pagos y proveedores de credenciales. Su documentación especifica flujos de descubrimiento, checkout y pedidos. Las implementaciones siguen teniendo endpoints, formatos de solicitud, autenticación y permisos distintos; la etiqueta UCP no significa que cualquier cliente pueda llamar a cualquier herramienta. Consulta la documentación de perfiles de agente de Shopify y las referencias específicas de cada endpoint antes de implementar un flujo.
Las áreas principales del protocolo incluyen:
- Descubrimiento del catálogo: encontrar productos y recuperar los detalles de producto compatibles mediante los endpoints de catálogo documentados.
- Checkout: crear o continuar el checkout mediante el flujo documentado, que puede requerir autenticación o una derivación del comprador.
- Acceso a pedidos: recuperar información compatible de pedidos conforme a las reglas documentadas de perfil y acceso; esto no implica que un agente pueda editar o reembolsar un pedido.
Como comerciante, confirma si el endpoint de catálogo de Shopify correspondiente está disponible y configurado para tu tienda. La existencia de un endpoint no garantiza que un producto de IA concreto lo utilice ni muestre todos los artículos. Revisa la guía de UCP de Shopify y la documentación actual del endpoint, y después prueba con el cliente que quieras admitir.
Qué pueden verificar los comerciantes ahora
1. El tráfico de búsqueda con IA crece, pero eso no demuestra que MCP lo haya causado. 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. Son cifras de búsqueda con IA comunicadas por Shopify, no una previsión para todos los comerciantes ni una prueba de que un endpoint MCP concreto generara esos pedidos. Consulta la actualización de junio de 2026 de Shopify.
2. Comprueba el flujo poscompra real. El Order MCP documentado de Shopify puede leer información compatible de pedidos originados por agentes; no edita pedidos. Los comerciantes deben verificar la vía disponible para que sus clientes corrijan pedidos elegibles, en lugar de asumir que un endpoint de agentes la cubre.
3. Mantén la información de producto precisa. Los títulos, opciones, disponibilidad y políticas claros ayudan a los clientes y a los sistemas de comercio a interpretar un catálogo. Mide los resultados en tu propia tienda, en lugar de asumir que un formato de datos concreto garantiza posicionamiento o conversión.
Cómo usar el kit de herramientas de IA si desarrollas aplicaciones o trabajas en una agencia
Empieza con una tarea de desarrollo: inspecciona el esquema, genera una consulta, valídala y revisa el resultado en una tienda de desarrollo.
Instala el plugin de Shopify para tu cliente compatible o sigue la vía documentada de instalación de habilidades o Dev MCP. Los plugins se actualizan automáticamente; las habilidades instaladas manualmente requieren actualizaciones. Sigue las instrucciones del cliente que realmente utilizas.
Para gestionar la tienda, autentícate con Shopify CLI usando solo los permisos necesarios. El comando store execute ejecuta una operación Admin GraphQL revisada con esa autenticación guardada. Por ejemplo, esto lee los diez primeros productos de una tienda de desarrollo:
shopify store auth --store YOUR-DEV-STORE.myshopify.com --scopes read_products
shopify store execute --store YOUR-DEV-STORE.myshopify.com --query '{ products(first: 10) { nodes { id title } } }'Sustituye el marcador por tu tienda de desarrollo. Las lecturas funcionan sin activar mutaciones; las escrituras requieren --allow-mutations y los permisos correspondientes. Revisa la mutación completa y las variables antes de activarlas, verifica la tienda de destino y prueba el comportamiento previsto antes de un cambio en producción.
Cómo habilitar las compras mediante agentes en tu tienda
Si vas a desarrollar sobre un endpoint de catálogo de Shopify, sigue el formato actual de solicitud de Storefront Catalog, incluido meta.ucp-agent.profile. Una búsqueda de productos correcta no demuestra acceso al pago ni a pedidos. Nuestra guía de Shopify Catalog MCP explica las herramientas de descubrimiento y sus límites.
Para un agente de marca, utiliza los proyectos de ejemplo actuales de Shopify y la documentación de checkout específica de cada endpoint. Planifica un lanzamiento gradual según tus propios requisitos de catálogo, autenticación, pagos y soporte; un proyecto de ejemplo no es una lista de comprobación de integración en producción. Prueba los detalles de producto visibles para el cliente y las derivaciones del checkout antes del lanzamiento.
El papel de la infraestructura posterior a la compra en un conjunto de herramientas para agentes
El descubrimiento de productos, pago, seguimiento de pedidos y cambios de clientes necesitan sus propias interfaces compatibles. Nuestra guía de endpoints MCP y UCP de Shopify relaciona esas responsabilidades.
Shopify documenta Order MCP como interfaz de lectura para pedidos compatibles originados por agentes, con webhooks de pedidos UCP para actualizaciones del ciclo de vida. No ofrece un flujo general de edición de pedidos. Revize ofrece un portal para cambios permitidos de dirección, variante, cantidad y cancelación antes de la preparación, sujetos a la ventana de edición del comerciante. Añadir productos, cambiar entre productos distintos, aplicar descuentos y reembolsar en crédito en tienda son funciones Pro. La edición por el personal está en desarrollo. El portal requiere el bloque de Revize en la página de estado y también puede abrirse desde el enlace Editar pedido del correo. Consulta Revize en Shopify App Store para los detalles del producto.
Preguntas frecuentes
¿Qué es el kit de herramientas de IA de Shopify en una frase?
El AI Toolkit de Shopify es un conjunto de herramientas de desarrollo que incluye un plugin, agent skills y un servidor Dev MCP local. Los endpoints de agentes de comercio de Shopify y UCP se documentan por separado.
¿El kit de herramientas de IA de Shopify es gratuito?
La documentación del AI Toolkit de Shopify no indica un precio de suscripción independiente para el Toolkit. Comprueba las condiciones actuales del plan de Shopify, del cliente de IA, de la aplicación y de los endpoints para conocer posibles cargos o requisitos de cuenta.
¿Necesito Shopify Plus para usar MCP en mi tienda?
No asumas que todos los endpoints o capacidades de agentes están disponibles en todos los planes. Comprueba la documentación actual de endpoints y planes de Shopify para tu tienda y la integración concreta.
¿Qué diferencia hay entre Storefront Catalog y Global Catalog?
El endpoint de catálogo actual de Shopify específico de la tienda está documentado en /api/ucp/mcp; Global Catalog tiene un endpoint separado. Sus herramientas y requisitos de solicitud difieren. Consulta la descripción general del catálogo de Shopify.
¿Qué es Universal Commerce Protocol?
UCP es un protocolo de comercio abierto descrito en la documentación para desarrolladores de Shopify. Lee la especificación actual y la documentación específica de cada endpoint antes de asumir que otra plataforma o agente admite el mismo flujo.
¿ChatGPT, Claude y Gemini usarán los servidores MCP de Shopify?
Las integraciones de proveedores cambian de forma independiente. Comprueba la documentación actual de cada proveedor y no asumas que ChatGPT, Claude o Gemini admite todos los endpoints o herramientas UCP de Shopify.
¿Activar las compras mediante agentes perjudicará mi tasa de conversión?
No hay un efecto universal. Mide la conversión, la finalización del checkout y los contactos con soporte para el canal y el recorrido de cliente específicos que habilites.
¿Cómo protege el kit de herramientas de IA los datos de los clientes?
Revisa la documentación actual de Shopify y del proveedor de IA sobre privacidad, autenticación y tratamiento de datos para cada herramienta que utilices. Los requisitos dependen del endpoint, el cliente y la información solicitada; no asumas que todas las llamadas son locales o que no contienen datos personales.
¿Puede el agente de un competidor hacer transacciones en mi tienda mediante MCP?
El acceso del agente depende del endpoint, el perfil del agente, la autenticación y los controles actuales de Shopify. Revisa la documentación pertinente de Shopify y tus propios ajustes de acceso antes de habilitar un flujo de terceros; no asumas que la compatibilidad del protocolo por sí sola concede acceso al checkout.
¿Tengo que hacer algo para que mi tienda aparezca en los resultados de búsqueda de los agentes?
Mantén la información de producto precisa y completa, y después comprueba las reglas de elegibilidad y descubrimiento del canal que quieras utilizar. Shopify no promete que un cambio concreto de contenido haga que un artículo aparezca en los resultados de un agente.
¿Qué relación hay entre el kit de herramientas de IA y Shopify Functions?
Shopify Functions y el AI Toolkit tienen objetivos distintos. Functions implementa lógica de comercio compatible; el Toolkit ayuda a los desarrolladores. Consulta la documentación del endpoint y de Functions para confirmar cómo una integración concreta interactúa con tu configuración. Aquí explicamos en detalle la migración a Functions.
¿Cómo puedo saber qué hace un agente en mi tienda para resolver problemas?
Utiliza los registros, diagnósticos y capacidades de observabilidad documentados para el endpoint y el cliente específicos de Shopify. Un agente de terceros puede ofrecer sus propios registros de conversación por separado; confirma qué registra tu integración y cómo se tratan esos datos.
Lecturas relacionadas
Estadísticas de edición de pedidos en Shopify · Cómo vender en ChatGPT con tiendas agénticas de Shopify · Cómo permitir que los clientes editen pedidos de Shopify