Shopify lanzó Shop MCP el 13 de octubre; así ofrece a los desarrolladores una conexión alojada para buscar productos, usar carritos y pagar. El servicio está en https://mcp.shop.com/. Sus 17 herramientas pueden encontrar productos en Shopify Catalog y abrir el pago con el comercio que vende un artículo. La búsqueda del catálogo no necesita una clave API. El comprador aún debe aprobar una compra real.

Esta guía es para desarrolladores que configuran un asistente compatible con MCP. Los pasos siguen la documentación de Shopify, consultada el 14 de octubre. BIG CHANGE no conectó un agente, creó un carrito ni realizó una compra. Por tanto, la guía describe resultados esperados, no un rendimiento observado.

El gran cambio

  • Qué cambió: Shopify ofrece ahora una conexión MCP alojada que abarca desde la búsqueda en el catálogo hasta el carrito y el pago con un comercio. También documenta cómo completar con Shop Pay para un comprador que inició sesión, tras su confirmación explícita.
  • Quién puede usarlo: Desarrolladores con un cliente MCP compatible con la versión de protocolo 2026-07-28, o código que realice las llamadas HTTP documentadas. Un cliente antiguo que solo usa el protocolo de enlace initialize no puede conectarse directamente.
  • Qué hay que comprobar: El pago corresponde a una transacción con un único comercio. completed junto con un order confirma la compra; un carrito, un enlace de pago o un pago en curso no lo hacen.

Antes de conectarte

Necesitas un cliente MCP compatible con servidores HTTP remotos y el método de conexión documentado por Shopifyo una aplicación que llame al servidor por HTTP. Usa la URL raíz https://mcp.shop.com/; añadir /mcp devuelve un 404. Las herramientas de búsqueda y carrito funcionan sin una cuenta de Shop. Iniciar sesión permite al asistente usar preferencias y direcciones guardadas, buscar pedidos y ofrecer Shop Pay cuando el comercio lo admite. Para un asistente que use su propio código HTTP, Shopify documenta un flujo OAuth para dispositivos que el comprador aprueba en el sitio de Shop.

Antes de buscar, elige una consulta de producto, el país de destino y la moneda. Separa los requisitos expresados por el comprador del contexto de búsqueda: un país o una moneda ayudan a localizar resultados; un precio máximo, una talla o un destino de envío son filtros. La API expresa los precios en unidades menores de la moneda. Tu aplicación debe leer el campo messages antes de afirmar que un resultado cumple un filtro, porque el servicio puede indicar que no aplicó el filtro solicitado. La guía de búsqueda de Shopify explica la diferencia y el límite de 1 a 50 resultados por página.

Un recorrido documentado de la búsqueda al pedido

  1. Conectar y comprobar la búsqueda. Configura el cliente con https://mcp.shop.com/ y carga la Shop skill si el cliente puede usarla. Shopify sugiere comprobar la conexión solicitando tres lámparas de escritorio sin crear un carrito. Una búsqueda funcional devuelve productos con vendedor, precio en una moneda indicada y enlace del comercio. Los desarrolladores que usan HTTP pueden seguir la guía rápida JSON-RPC de Shopify, que incluye los encabezados de protocolo necesarios y la solicitud search_catalog. Esta comprobación es de solo lectura y no requiere iniciar sesión.
  2. Elegir el artículo exacto. Ejecuta search_catalog con la consulta y los requisitos del comprador. La búsqueda devuelve una variante destacada; usa get_product si el comprador quiere otra talla o color. Compara product.selected y el variant.options devuelto con cada talla, color y demás opciones especificadas antes de mostrarlo o comprarlo. Shopify advierte que la selección puede flexibilizarse sin avisar. Cuando el comprador elija un producto o cambie una opción, vuelve a llamar a get_product para comprobar la disponibilidad y el precio actuales. Conserva exactamente el ID de esa variante y el dominio del vendedor. No supongas que el comercio respetará un precio mostrado antes. Muestra cada aviso junto al producto al que se refiere. Estas comprobaciones están documentadas en Buscar productos.
  3. Crear un carrito cuando se solicite. Con la instrucción del comprador de reunir artículos, llama a create_cart para el comercio y la variante seleccionados. Un carrito guarda artículos, pero no hace un pedido. Mantén en carritos separados los artículos de distintos vendedores: Shopify indica que cada carrito y pago pertenecen a un único comercio. El resultado debe incluir el ID del carrito y sus líneas. Si el comprador solo quiere explorar, detente tras la búsqueda; la guía de carritos de Shopify dice que el interés en un producto por sí solo no autoriza a crear un carrito.
  4. Abrir y revisar el pago. Cuando el comprador pida el precio total o esté listo para comprar, llama a create_checkout con el ID del carrito o con el ID exacto de la variante y el dominio del vendedor devueltos por la búsqueda. El documento de pago debe devolver un ID, estado, artículos, moneda, totales, métodos de pago, messages, política del comercio links y un continue_url para la página del comercio. Muestra al comprador los totales actuales con sus etiquetas, incluidos envío e impuestos, cada aviso y cada enlace a políticas antes de continuar. Mantén las aclaraciones junto al artículo o campo al que correspondan. Entrega al comprador el continue_url sin modificar, incluidos sus parámetros de consulta, junto a los artículos que cubre, aunque el agente pueda completar el pago. El pago puede quedar como incomplete si necesita una dirección, o como requires_escalation si el comprador debe terminar en la página del comercio. Shopify indica que el pago caduca por defecto tras seis horas.
  5. Deja el pago en manos del comprador. Si el comprador inicia sesión, el pago puede ofrecer direcciones guardadas y Shop Pay. Antes de llamar a complete_checkout, lee el pago más reciente, confirma que está ready_for_complete, muestra el comercio, los artículos, las cantidades, el total y los métodos disponibles, y permite que el comprador elija el método de pago. No lo elijas por él. Mantén a disposición del comprador el continue_url del comercio sin modificar incluso si el agente puede completar el pago; si no hay un instrumento de pago disponible, el comprador debe usar ese enlace. Las instrucciones de pago de Shopify dicen que se envíe complete_checkout una sola vez después de la aprobación y luego se revise el estado devuelto. Un distinto para tiendas fuera de Shopify hace que el comprador apruebe el pago en Shop y proporciona una tarjeta para el pago propio de esa tienda; no es el flujo de pago del comercio Shopify descrito en los pasos 3 y 4.
  6. Verificar el resultado. Solo status: completed con un order confirma que el comercio creó un pedido. Si el pago sigue procesándose, usa get_checkout para volver a leer el estado. Shopify dice que al lanzamiento no hay webhooks, por lo que una integración debe consultar get_checkout para ver actualizaciones. Si una llamada de finalización agota el tiempo o la respuesta no es clara, no la envíes de nuevo ni abras otro pago. Lee el pago existente; si no muestra ambos estados, completed y order, dile al comprador que la compra no está confirmada y entrégale continue_url.

Límites y recuperación

Shopify dice que la búsqueda funciona sin credenciales. Su nota de lanzamiento dirige a los desarrolladores que necesitan límites de solicitudes mayores a una clave API del Shopify Dev Dashboard, pero no publica el precio ni una tabla de límites para esa clave. El precio de los artículos del comercio, el envío y los impuestos proceden del pago actual; el comprador debe revisarlos antes de pagar. El agente también puede tener costes propios de alojamiento o modelo si su desarrollador usa uno. El anuncio no cuantifica esos costes.

Una lectura fallida se puede repetir tras cualquier demora retry_after indicada. Para crear o actualizar carritos y pagos, la guía de errores de Shopify recomienda usar una clave de idempotencia y leer el recurso existente antes de repetir una escritura cuyo resultado sea incierto. Si una creación se envía sin clave y falla antes de devolver un ID, el resultado es desconocido; no adivines creando otra. complete_checkout es más estricto: nunca la repitas después de una respuesta incierta. La página del comercio sigue siendo la vía del comprador cuando requires_escalation o la falta de datos de pago impide que el agente termine.

Trata los ID de pago, enlaces de pago, tokens de acceso e instrumentos de pago como información sensible. Shopify indica que el ID de pago y continue_url contienen claves de acceso; no los incluyas en registros ni analíticas y comparte el enlace solo con el comprador. La referencia de autenticación dice que un token de Shop solo debe enviarse en el encabezado de autorización a https://mcp.shop.com/. Un instrumento de pago puede contener credenciales; no lo imprimas ni registres.

BIG CHANGE ya había cubierto las herramientas de pago de agentes de navegador de Shopify. Esta versión MCP alojada describe un flujo distinto que comienza con el descubrimiento del catálogo. La nota de lanzamiento y los manuales de Shopify indican qué pueden llamar los desarrolladores y qué respuestas deben inspeccionar; no demuestran aumentos de conversión, fiabilidad con carga ni una compra realizada por BIG CHANGE.

Fuentes y lecturas adicionales