Shopify y Universal Commerce Protocol: guía para desarrolladores

Por Shubham Vats, Fundador de Revize

Publicado el Actualizado el 9 min de lectura

En esta página

Universal Commerce Protocol (UCP) es un protocolo abierto y versionado para comercio agéntico. La implementación actual de Shopify expone servidores MCP compatibles con UCP para búsqueda de catálogos, carritos, pago y flujos de pedidos. UCP está disponible hoy para desarrolladores, pero un protocolo abierto no significa que cada agente o comerciante admita todas las capacidades.

Nodo central que conecta agente IA, tienda, pagos y carrito para representar el comercio UCP

El panorama general: ¿qué cambió?

Shopify y Google anunciaron UCP el 11 de enero de 2026. El protocolo sigue evolucionando; la documentación actual de agentes usa ejemplos de perfil 2026-08-25. El 13 de octubre de 2026, Shopify anunció Shop MCP, que permite buscar Shopify Catalog, crear carritos y generar checkout mediante una sola conexión MCP a agentes compatibles.

Para desarrolladores Shopify, la pregunta práctica es qué flujo actual necesitas admitir: descubrir productos, crear carritos, derivar al checkout o seguir pedidos. Comprueba herramientas y permisos compatibles en la documentación antes de prometer una capacidad a comerciantes.

¿Qué es exactamente UCP?

UCP es un protocolo abierto que describe cómo agentes y sistemas comerciales intercambian información y realizan acciones definidas. Está versionado y basado en capacidades: una integración declara qué admite y el agente debe usar solo esas capacidades.

Shopify implementa UCP mediante endpoints y herramientas MCP. Según endpoint y permisos, puedes trabajar con catálogo, carritos, pago o información de pedidos. Son flujos distintos; admitir uno no implica admitir todas las demás capacidades UCP.

Nodo central UCP conectado a iconos de robot, tienda, pago y perfil de usuario

Roles en un flujo de comercio agéntico

  • Agente o aplicación: ayuda a encontrar productos, crear un carrito o continuar al checkout.
  • Sistema del comerciante: suministra información de productos y pago y procesa el pedido mediante su interfaz compatible de Shopify.
  • Proveedor de credenciales: suministra credenciales o tokens mediante el método de pago negociado.
  • Servicio de pago: gestiona el pago mediante el checkout o método disponible.
  • Comprador: revisa y autoriza la compra. Sigue los requisitos de confirmación y permisos del flujo.

El problema: por qué el comercio necesitaba un protocolo

Esta es la realidad del comercio actual: está muy fragmentado.

Piensa en lo que ocurre cuando un cliente quiere comprar algo mediante un asistente de IA:

Conexiones comerciales enredadas frente a una red organizada por un nodo central para un protocolo compartido

  • La IA debe encontrar productos en los catálogos de los comerciantes
  • Debe conocer en tiempo real la disponibilidad, el precio y las opciones de envío
  • Tiene que gestionar programas de fidelización, códigos de descuento y preferencias de suscripción
  • Debe recopilar la información de pago de forma segura
  • Tiene que completar el pago según los requisitos específicos del comerciante
  • Por último, debe facilitar el seguimiento del pedido, las devoluciones y la atención al cliente

Las integraciones personalizadas añaden mantenimiento. UCP ofrece esquemas compartidos y negociación de capacidades que pueden reducirlo, pero dos implementaciones siguen necesitando versiones, capacidades, autenticación y gestores de pago compatibles. La compatibilidad del protocolo por sí sola no garantiza completar una compra.

Capacidades UCP que debes entender primero

Checkout, vinculación de identidad y estado de pedidos son puntos de partida útiles en la especificación. Shopify también documenta capacidades de catálogo y carrito. Cada interfaz implementa su conjunto; comprueba el perfil negociado antes de llamar una herramienta.

Capas ilustradas de descubrimiento de productos, pago y seguimiento de pedidos

1. Pantalla de pago

Checkout crea y actualiza una sesión de compra con artículos, datos del comprador, totales y gestor de pagos. El comerciante sigue siendo el vendedor responsable de la transacción. El flujo estándar lleva al comprador a una interfaz de confianza para confirmar el pago; completarlo de forma autónoma depende de extensiones de autorización compatibles y la integración concreta.

2. Vinculación de identidades

La vinculación de identidad usa OAuth 2.0 para que el comprador autorice a un agente a actuar en su nombre. Puede admitir funciones de cuenta como direcciones guardadas o historial. La búsqueda pública de catálogo funciona sin vincular identidad, por lo que la autorización es una capacidad y decisión de permisos separada.

3. Pedidos

La capacidad Order comparte estado y eventos como preparación, devoluciones y reembolsos. No es una API general de edición. Order MCP y las APIs de solicitudes de edición de Shopify tienen sus alcances y límites documentados, descritos abajo.

La arquitectura técnica: diseñada para evolucionar

UCP usa perfiles para declarar versión y capacidades compatibles. Empresas y agentes negocian las capacidades comunes para una sesión; el agente debe usar solo ese conjunto. Los ejemplos de Shopify usan versiones con fecha, así que copia el perfil y esquema actuales de la documentación en vivo, no un ejemplo antiguo.

Servicio de comercio por capas con módulos opcionales que muestra la arquitectura extensible de UCP

Las extensiones añaden detalles opcionales a una capacidad base, como preparación o descuentos. Una empresa puede exponer el checkout base sin todas las extensiones, y el agente debe comprobar cuáles admite la otra parte antes de depender de ellas. Consulta el resumen UCP y la guía de perfiles de agente de Shopify.

Diseñado para la interoperabilidad

El estándar UCP está diseñado para funcionar con distintas vinculaciones de protocolo, como REST, MCP y A2A. Esto describe el estándar general; no garantiza que una implementación de Shopify ofrezca todas las capacidades mediante todos los transportes.

Núcleo UCP conectado a conceptos MCP, A2A, AP2 y REST del ecosistema de protocolos

Shopify documenta servidores MCP compatibles con UCP y herramientas concretas. En cada integración, verifica el endpoint, la autenticación, la versión del perfil y las confirmaciones requeridas al comprador. Una capacidad de la especificación no está necesariamente disponible en cada interfaz de Shopify.

Interfaces actuales de UCP y MCP en Shopify

La documentación de agentes de Shopify describe interfaces distintas:

Las herramientas Catalog MCP permiten buscar en Shopify Catalog y recuperar detalles. Global Catalog MCP usa https://catalog.shopify.com/api/ucp/mcp; Shop MCP está en https://mcp.shop.com y ofrece búsqueda y herramientas de productos. La visibilidad y resultados dependen de los datos actuales y de la interfaz utilizada.

Creación de carritos y pago

Cart MCP crea y actualiza carritos. Checkout MCP crea y gestiona sesiones y deriva al comprador a la tienda para completar pasos que lo requieren. Shopify documenta Checkout MCP como enfoque recomendado del servidor; Checkout WebMCP sirve a un agente que ya opera en el navegador del comprador. Las herramientas del navegador no gestionan algunos tipos de checkout e interacciones definidas por apps.

Shop MCP es una conexión separada para buscar Shopify Catalog, crear carritos y generar checkout con Shop Pay. No significa que todos los comerciantes estén automáticamente en cada app de IA.

Información de pedidos

Order MCP de Shopify lee el estado actual de pedidos realizados mediante el agente, incluida preparación y ajustes poscompra. get_order sirve para vistas solicitadas por compradores y conciliación. Los webhooks de pedidos UCP ofrecen instantáneas continuas tras cambios confirmados; un responsable de partners debe registrar el endpoint de entrega. Este canal de lectura/actualización no ejecuta cambios arbitrarios.

Por separado, las APIs del 1 de octubre de 2026 permiten a compradores solicitar eliminar artículos sin preparar; un comerciante o app revisa, resuelve o rechaza. Ese flujo limitado no equivale a cambiar dirección o producto.

Qué significa esto para los comerciantes de Shopify

Portátil con controles de tiendas agénticas y canales de compra con IA conectados

Las herramientas de agentes de Shopify pueden ofrecer flujos de producto y checkout a agentes compatibles. La experiencia depende de la interfaz que use el agente, las capacidades habilitadas para la tienda y la autorización del comprador. Mantén actualizados los datos de productos, la disponibilidad y las políticas, y confirma qué canales tiene habilitados tu tienda.

Trátalo como interfaz de integración, no garantía de presencia universal en IA ni acceso a todos los comerciantes. La descripción de tiendas agénticas de Shopify explica disponibilidad y checkout estándar de referencias de ChatGPT.

Qué significa esto para quienes desarrollan aplicaciones de Shopify

Mano interactuando con componentes comerciales junto a un monitor con código

UCP y las herramientas MCP dan a desarrolladores interfaces definidas. Antes de empezar, identifica la tarea del comprador, endpoint, perfil y permisos necesarios y dónde debe revisar o confirmar una acción.

Desarrolla con capacidades compatibles

Usa la documentación y tutoriales actuales para descubrir endpoints, autenticar, trabajar con carritos y pago y seguir pedidos. No supongas que una app de terceros expone sus funciones a un agente solo porque UCP admite extensiones; verifica que estén implementadas la interfaz y capacidad.

Mantén separada la edición de pedidos

Order MCP cubre información y flujos del ciclo de vida. No hace cambios arbitrarios como direcciones o productos. Las APIs del 1 de octubre de 2026 se limitan a solicitudes de eliminar artículos sin preparar, con revisión del comerciante o app. Para otros cambios poscompra, verifica funciones y permisos actuales de la app separada.

Qué significa esto para las agencias

Equipo de agencia planificando una integración UCP alrededor de un diagrama comercial

Las agencias ayudan a preparar datos de productos y checkout para las interfaces de agentes elegidas. Empieza con documentación actual y el plan, apps, datos y recorrido reales del comerciante. Trata disponibilidad, alcance y conversión como cuestiones que medir por tienda, no garantías del protocolo.

UCP junto a otros protocolos de comercio agéntico

UCP y Agentic Commerce Protocol (ACP) son iniciativas separadas. Definen interfaces y flujos distintos, así que no supongas que una integración UCP funciona automáticamente con ACP o viceversa. Revisa especificaciones actuales y desarrolla solo para interfaces que pretendas admitir.

Comparación conceptual de plataformas UCP y ACP con un puente de integración

El puente representa trabajo de integración que evaluar, no una función de interoperabilidad ya lanzada por Shopify.

Primeros pasos: guía práctica de implementación

Usa la documentación actual de comercio agéntico de Shopify como punto de partida. Incluye interfaces MCP actuales, ejemplos de perfil UCP, autenticación y tutoriales. Shopify recomienda el inicio rápido de AI Toolkit para una configuración guiada; también puedes seguir tutoriales individuales.

Ruta de implementación desde revisar la especificación y trabajar en sandbox hasta las pruebas y el lanzamiento

Paso 1: identifica la tarea del comprador

Decide si tu app busca productos, crea carritos, crea o actualiza checkout o lee el ciclo de vida del pedido. Estas tareas usan herramientas y permisos diferentes.

Paso 2: sigue la guía actual de Shopify

Usa perfiles de agente y ejemplos API actuales. No copies endpoints, versiones de perfil, repositorios de ejemplo o URL de pruebas antiguos sin comprobar que sigan documentados.

Paso 3: prueba todo el recorrido del comprador

Usa una tienda de desarrollo y prueba autenticación, mensajes y estados devueltos, derivación al checkout y confirmación del comprador. Prueba el tipo exacto de pedido o checkout que admitirás; Shopify documenta casos no gestionados por herramientas del navegador.

Paso 4: limita la integración a capacidades verificadas

Declara y solicita solo los permisos necesarios. Explica pasos no compatibles o que requieren confirmación y verifica el comportamiento actual antes de desplegar.

Qué viene después

La documentación publicada cubre catálogo, carritos, pago e información de pedidos mediante flujos MCP separados. Shop MCP añade una conexión para agentes compatibles para buscar Shopify Catalog, crear carritos y checkout con Shop Pay. Considera no anunciadas las funciones y fechas futuras hasta que aparezcan en la especificación o registro de cambios oficial.

Antes de fijar una hoja de ruta, consulta perfil, endpoint, permisos y tipos de pedidos o checkout concretos. Herramientas, confirmaciones y tipos compatibles difieren por interfaz y pueden cambiar con las APIs.

En resumen

UCP da a desarrolladores un protocolo compartido y en evolución para crear comercio agéntico. Las herramientas actuales de Shopify cubren productos, carrito y pago e información del ciclo de vida, con endpoints, permisos y límites separados.

Los comerciantes deben comprobar qué interfaces están activadas y qué recorrido admiten. Desarrolladores y agencias deben seguir documentación actual, probar en desarrollo y evitar insinuar que la integración edita pedidos o lista productos en todas las interfaces de IA salvo que el destino lo admita.

Desarrollador observando una red comercial conectada mientras planifica un lanzamiento

Preguntas frecuentes

¿UCP permite a un agente llamar a cualquier app de Shopify?

La app necesita una interfaz implementada compatible con el agente e interfaz Shopify de destino. Declarar una extensión o usar un estándar abierto por sí solo no expone sus funciones.

¿Order MCP puede cambiar direcciones o productos?

Order MCP recupera estado de pedidos del agente. Las direcciones y productos requieren un flujo separado de edición. Solicitar eliminar artículos sin preparar es una petición API distinta revisada por comerciante o app.

¿Cómo recibir actualizaciones de pedidos UCP en Shopify?

Organiza el registro de webhooks con tu responsable de partners, procesa las instantáneas entrantes y usa get_order cuando un comprador pida información nueva o una entrega necesite conciliación.

¿El checkout estándar de ChatGPT con Shopify es pago directo UCP?

La tienda agéntica estándar de ChatGPT redirige al comprador al checkout de la tienda online. Otros canales activados e integraciones separadas pueden usar flujos distintos; verifica el que implementas.

¿Qué verificar antes de desplegar una integración UCP?

Comprueba endpoint, versión negociada, capacidades, permisos, autenticación y confirmaciones del comprador. Prueba productos no disponibles, derivación al checkout y actualizaciones de pedidos con el agente elegido antes de publicar.

Recursos

Este artículo forma parte de nuestra serie «Más allá del checkout». La app de edición de pedidos para clientes de Revize ofrece cambios aptos por autoservicio antes de la preparación dentro de la ventana del comerciante. Cambiar productos, añadir artículos, aplicar descuentos y reembolsar en crédito requiere Pro; la edición por el personal está en desarrollo. El portal es independiente de una integración de agente UCP.

Lecturas relacionadas

Estadísticas de edición de pedidos en Shopify · Cómo vender en ChatGPT con tiendas agénticas de Shopify · Guía de endpoints MCP y UCP de Shopify · Guía de Shopify AI Toolkit · Cómo permitir que los clientes editen pedidos de Shopify