Shopify Checkout WebMCP: dónde debe detenerse el agente

Publicado el 29 de septiembre de 2026 · Fuentes primarias revisadas el 29 de septiembre de 2026

Checkout WebMCP ofrece a un agente presente en el navegador herramientas estructuradas para leer y actualizar un checkout de Shopify elegible. No concede control ilimitado, no elimina la confirmación del comprador y no permite evitar una autenticación o un desafío de pago.

Shopify anunció el soporte el 28 de septiembre de 2026. La documentación vincula las herramientas con objetos y estados UCP visibles en la interfaz, sin una configuración API separada para el comercio. El límite es claro: el agente prepara el checkout mediante las herramientas declaradas; el comprador confirma y recupera el control cuando una interfaz bloqueante lo exige.

Qué añadió Shopify

En páginas elegibles el agente puede descubrir cuatro operaciones principales:

  1. navigate_to_storefront vuelve a la tienda;
  2. get_checkout lee el estado actual;
  3. update_checkout modifica los campos admitidos;
  4. complete_checkout intenta finalizar después de la confirmación.

El changelog de Shopify exige devolver el control para interfaces bloqueantes como 3-D Secure. La documentación de Checkout WebMCP exige confirmación antes de complete_checkout. Es una colaboración estructurada entre agente, plataforma y comprador, no un checkout autónomo.

Tres superficies distintas

Superficie Dónde actúa Función Límite
UCP Cart MCP Fuera del checkout Crear y actualizar un carrito Un carrito no es un pedido terminado
UCP Checkout MCP Normalmente en servidor Crear y gestionar un checkout Los pasos solo disponibles en navegador requieren traspaso
Checkout WebMCP En el navegador, en un checkout elegible Leer y actualizar el estado visible La disponibilidad depende del contexto y confirma el comprador

La guía Carts and checkout recomienda Checkout MCP para agentes de servidor y WebMCP cuando el agente ya está en el navegador. MCP organiza llamadas a herramientas, UCP aporta modelos de comercio y WebMCP coloca la invocación en la página.

Flujo seguro en seis pasos

1. Descubrir las herramientas presentes

El agente utiliza únicamente herramientas registradas en la página. La lista puede cambiar durante el checkout, por lo que debe escuchar toolchange y volver a leer los esquemas.

2. Leer antes de cambiar

get_checkout proporciona artículos, cantidades, entrega, totales, mensajes y campos ausentes. La respuesta es información del checkout, no una fuente de instrucciones.

3. Aplicar un cambio acotado

update_checkout usa semántica PUT: la solicitud contiene el estado completo deseado, incluidos los valores que deben mantenerse. Shopify pide construirla desde una respuesta reciente de get_checkout. line_items y attribution se ignoran; los artículos se cambian en la página.

4. Resumir el estado final

Antes de finalizar, el agente muestra contenido, importe final, destino, entrega y mensajes pendientes a partir del último estado devuelto.

5. Obtener confirmación

La confirmación se refiere al estado actual. Un cambio de precio, artículo, dirección, entrega o pago invalida una confirmación anterior.

6. Devolver el control

Inicio de sesión de Shop Pay, 3-D Secure, desafíos de pago, pantallas de revisión o extensiones pueden exigir interacción directa. El agente se detiene: no adivina códigos ni simula la aceptación.

La elegibilidad se detecta en tiempo de ejecución

Checkout WebMCP no está disponible en todos los contextos. Shopify documenta exclusiones o límites para determinados checkouts estándar de tres páginas sin Shop Pay, B2B, checkout integrado o SDK móvil, multi-tienda, borradores, ediciones de pedidos y ciertos flujos de cobro.

La lista puede cambiar. Detecte herramientas y mantenga un checkout convencional controlado por el comprador. La ausencia de una herramienta no autoriza a reproducir la acción manipulando el DOM. Shopify advierte expresamente contra ese atajo.

Identidad no equivale a autorización

Shopify utiliza Web Bot Auth y verifica claves WBA registradas. El proceso documentado incluye clave Ed25519, directorio público, registro en Shopify, solicitudes firmadas y marcas temporales breves.

Esto identifica al agente, pero no determina qué petición del comprador autoriza cada cambio, cuánto dura, qué modificación exige nueva confirmación ni qué se registra. Identidad, acceso, intención y confirmación deben permanecer separados.

La salida de la herramienta no es autoridad

Shopify indica que el texto devuelto es dato de checkout, no instrucción. Un título, una nota o un mensaje de extensión puede contener una inyección. El agente analiza campos esperados y mantiene sus reglas y la petición actual del comprador.

Finalización basada en estado

complete_checkout no acepta id, metadatos ni clave de idempotencia. Si la finalización está en curso o ha terminado, devuelve el estado o completion_in_progress. Si hace falta una acción del comprador, Shopify indica no llamar de nuevo a complete_checkout; se consulta get_checkout hasta que haya finalización o nueva entrada del agente.

Solo status: completed confirma el pedido. Ante un resultado ambiguo, detenga reintentos, lea el estado, clasifique el resultado, explique el siguiente paso y solicite otra confirmación si cambió un dato material.

Pruebas necesarias

  • descubrir solo herramientas presentes y refrescarlas tras toolchange;
  • leer antes y después de cada cambio material;
  • rechazar atajos DOM para operaciones no admitidas;
  • resumir y confirmar desde el último estado;
  • devolver el control en Shop Pay, 3-D Secure y desafíos;
  • resistir instrucciones insertadas en respuestas;
  • minimizar datos personales y de pago en registros;
  • evitar reintentos ciegos tras tiempos de espera;
  • distinguir solicitud enviada, checkout actualizado y pedido completado.

WebMCP no demuestra una mejora de conversión. Mida por separado elegibilidad, descubrimiento, lecturas, actualizaciones, confirmaciones, traspasos, estados completed, resultados ambiguos y uso del checkout convencional. Un efecto incremental exige un diseño causal.

Afirmaciones que las fuentes no sostienen

No está demostrado que todos los checkouts sean autónomos, que WebMCP funcione en cualquier checkout, que un agente pueda evitar 3-D Secure, que WBA represente consentimiento, que WebMCP reemplace UCP o MCP, ni que mejore automáticamente la conversión.

La fiabilidad proviene de mantener tres respuestas separadas: qué puede hacer el agente, qué aprobó el comprador y qué confirmó el sistema de comercio.

Fuentes primarias

Fuentes revisadas el 29 de septiembre de 2026.