Saltar al contenido
Volver al blog
case-study10 min

Caso de Estudio: Cómo un Agente IA Compra un Producto en 8 Pasos — Walkthrough de la Demo Store

Recorre el flujo exacto de 8 pasos que sigue un agente IA para descubrir, comparar y comprar un producto de la demo store de AgenticMCPStores. Sin API key para descubrimiento — pruébalo tú mismo con los ejemplos curl.

Resumen ejecutivo

Caso de estudio end-to-end de un agente IA comprando en la demo store de AgenticMCPStores. Cubre el flujo MCP completo de 8 pasos: búsqueda → detalles → crear carrito → tarifas de envío (con elicitation) → seleccionar envío → aplicar descuento → preview → checkout. Incluye ejemplos curl ejecutables y explica trust scoring, detección de protocolo y elicitation de dirección en Claude.ai.

Publicado

2026-04-06

10 min

Autoría

Equipo de arquitectura de integraciones

Arquitectos de implementación

El equipo de arquitectura de integraciones se centra en patrones prácticos de despliegue para tiendas que adoptan superficies de comercio compatibles con MCP.

Ver perfil

Categoría

case-study

caso-estudiodemo-storeMCPcheckoutagentes-iawalkthroughelicitationejemplos-curl

¿Cómo se ve realmente cuando un agente IA compra algo? No en teoría — en la práctica. En este walkthrough, seguimos a un agente Claude paso a paso por una compra real en la demo store de AgenticMCPStores: 30 productos, 8 categorías, 3 códigos de descuento, múltiples opciones de envío y un flujo de checkout que maneja pago y recopilación de dirección nativamente dentro del chat. Cada comando curl en este post funciona contra el endpoint de demo en vivo ahora mismo.

El endpoint de la demo store es público y tiene límite de 20 peticiones/minuto por IP. No se necesita API key para herramientas de descubrimiento. Para herramientas de checkout, obtén una clave sandbox gratis de 24 horas: POST /api/v1/sandbox/key

Idea clave

La Configuración: 30 Productos, Cero Configuración

La demo store viene con 30 productos seleccionados en 8 categorías: sneakers, chaquetas, accesorios, pantalones, camisetas, calzado, electrónica y smartphones. No son items de relleno — cada producto tiene precios realistas, opciones de variante (talla/color), niveles de stock, valoraciones con conteo de reviews, y metadatos completos incluyendo peso, material y origen. Productos clave que verás en este walkthrough: • Nike Air Max 90 — $130 (antes $160), 4.7★ de 324 reviews, tallas US 8–10 • The North Face Nuptse Jacket — $320 (antes $380), 4.8★ de 512 reviews, plumón de ganso 700-fill • Sony WH-1000XM5 — $349.99, auriculares con cancelación de ruido • Casio G-Shock DW5600E — $54.99, resistencia al agua 200m La demo store tiene un trust score de 0.85 con verificación STANDARD — suficiente para pasar todos los gates de trust y aparecer prominentemente en resultados de búsqueda.

Paso 1: Buscar Productos

El agente empieza buscando en el catálogo. Sin autenticación necesaria. ```bash curl https://www.agenticmcpstores.com/demo-store/mcp \ -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"search_products","arguments":{"query":"running shoes","max_results":5}},"id":1}' ``` La respuesta devuelve productos coincidentes ordenados por relevancia y trust score. Cada resultado incluye: id, título, precio, moneda, valoración, estado de stock y URL de imagen. El agente ahora tiene IDs de producto que puede usar en los pasos siguientes.

Paso 2: Obtener Detalles del Producto

Con un ID de producto de la búsqueda, el agente obtiene detalles completos incluyendo variantes, especificaciones y Schema.org JSON-LD. ```bash curl https://www.agenticmcpstores.com/demo-store/mcp \ -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"get_product_details","arguments":{"product_id":"prod-001"}},"id":2}' ``` La respuesta incluye todo lo que el agente necesita para hacer una recomendación: precio vs precio anterior (para cálculo de descuento), opciones de variante con stock por variante, composición de material, peso y un bloque JSON-LD completo que el agente puede usar para razonamiento semántico.

Paso 3: Crear un Carrito

Ahora el agente añade items al carrito. Esto requiere una clave sandbox. ```bash # Primero, obtener clave sandbox de 24 horas curl -X POST https://www.agenticmcpstores.com/api/v1/sandbox/key # Devuelve: {"key":"agnt_sandbox_...","expires_in":86400} # Crear carrito con la clave curl https://www.agenticmcpstores.com/demo-store/mcp \ -X POST \ -H "Content-Type: application/json" \ -H "X-Agent-Api-Key: agnt_sandbox_..." \ -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"create_cart","arguments":{"items":[{"product_id":"prod-001","quantity":1,"variant_id":"v-snk-001a"}]}},"id":3}' ``` La respuesta incluye un `cart_id` (UUID), line items con precios, y un `status: "NOT_READY_FOR_PAYMENT"` — el carrito necesita envío y checkout para completarse.

Paso 4: Obtener Tarifas de Envío (con Elicitation)

Aquí es donde las cosas se ponen interesantes. Cuando el agente llama a `get_shipping_rates` sin dirección de envío, el servidor MCP activa elicitation — una funcionalidad nativa de MCP que recopila input del usuario inline. En Claude.ai, el usuario ve un formulario inline aparecer directamente en el chat: - Dirección (calle y número) - Ciudad - Código de país (ISO-2: US, ES, DE...) - Código postal - Provincia/Estado (opcional) El usuario completa el formulario, Claude pasa los datos de vuelta a la herramienta, y las tarifas de envío se calculan. Sin redirecciones, sin páginas externas — toda la interacción ocurre dentro de la conversación. La demo store devuelve dos opciones: - Standard (5–7 días) — $9.99 - Express (2–3 días) — $24.99

Paso 5: Seleccionar Opción de Envío

El agente selecciona un método de envío pasando el `shipping_handle` de la respuesta de tarifas. ```bash curl https://www.agenticmcpstores.com/demo-store/mcp \ -X POST \ -H "Content-Type: application/json" \ -H "X-Agent-Api-Key: agnt_sandbox_..." \ -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"select_shipping_option","arguments":{"cart_id":"","shipping_handle":"standard"}},"id":5}' ``` El total del carrito se recalcula para incluir los $9.99 de envío.

Paso 6: Aplicar Código de Descuento

Tres códigos de descuento funcionan en la demo store: - WELCOME10 — 10% de descuento en el subtotal - DEMO20 — 20% de descuento en el subtotal - FREESHIP — Envío gratis (elimina el coste de envío) ```bash curl https://www.agenticmcpstores.com/demo-store/mcp \ -X POST \ -H "Content-Type: application/json" \ -H "X-Agent-Api-Key: agnt_sandbox_..." \ -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"apply_discount","arguments":{"cart_id":"","discount_code":"WELCOME10"}},"id":6}' ``` Con WELCOME10 aplicado a un item de $130: subtotal baja a $117, más $9.99 de envío = $126.99 total.

Paso 7: Preview del Checkout

Antes de completar la compra, el agente previsualiza el resumen completo del pedido. ```bash curl https://www.agenticmcpstores.com/demo-store/mcp \ -X POST \ -H "Content-Type: application/json" \ -H "X-Agent-Api-Key: agnt_sandbox_..." \ -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"preview_checkout","arguments":{"cart_id":""}},"id":7}' ``` La respuesta incluye line items, método de envío, detalles de descuento y el total final. El estado pasa a `READY_FOR_PAYMENT`. Esta es la última oportunidad del agente para verificar que todo está correcto antes de completar la compra.

Paso 8: Completar el Checkout

El paso final crea el pedido. Si la información del comprador (nombre, email) no se proporcionó antes, aparece un segundo formulario de elicitation en Claude.ai. ```bash curl https://www.agenticmcpstores.com/demo-store/mcp \ -X POST \ -H "Content-Type: application/json" \ -H "X-Agent-Api-Key: agnt_sandbox_..." \ -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"complete_checkout","arguments":{"checkout_session_id":"","idempotency_key":"unique-key-123","buyer":{"name":"Demo User","email":"demo@example.com"},"payment_method":"MOCK"}},"id":8}' ``` El `idempotency_key` garantiza reintentos seguros — enviar la misma clave dos veces devuelve el mismo resultado sin doble cargo. En modo sandbox, `payment_method: "MOCK"` omite el procesamiento de pago real. La respuesta: `{ "order_id": "...", "status": "COMPLETED", "totals": { ... } }`. Hecho. El agente ha comprado un producto exitosamente.

Lo que el Agente Ve Tras Bambalinas

Durante todo este flujo, varios sistemas invisibles están trabajando: • Trust scoring: El trust score de 0.85 de la demo store asegura que pase el filtro de elegibilidad duro (≥ 0.3) y tenga buen ranking en resultados de búsqueda (30% peso en trust). • Detección de protocolo: Cada petición es analizada por el middleware protocol-detector. La demo store soporta ACP (Stripe), AP2 (Google), x402 (stablecoin) y UCP — el método de pago del agente determina qué adapter de protocolo maneja el settlement. • Motor de políticas KYAI: Cada intención de checkout pasa por 5 reglas de política. La verificación STANDARD y trust score de 0.85 de la demo store significan que todas las reglas devuelven ALLOW — sin fricción ni bloqueo. • Rate limiting: El endpoint demo tiene límite de 20 peticiones/minuto por IP. Las claves sandbox obtienen 50 peticiones de checkout/hora. Las claves de producción tienen límites más altos según el tier. • Limpieza de sesiones: Las sesiones de carrito expiran tras 30 minutos de inactividad. Cada petición crea una instancia MCP fresca — sin conexiones persistentes.

Pruébalo Tú Mismo

La forma más rápida de experimentar este flujo: 1. En Claude.ai: Añade la URL del servidor MCP `https://www.agenticmcpstores.com/demo-store/mcp` a tu configuración de Claude Desktop y pide a Claude 'busca zapatillas de running en la demo store' 2. Vía curl: Copia cualquiera de los comandos anteriores y ejecútalos en tu terminal. Las herramientas de descubrimiento funcionan inmediatamente sin configuración. 3. En el playground: Visita agenticmcpstores.com/en/demo-store y usa el playground interactivo MCP para ejecutar herramientas visualmente con un panel de traza de sesión. 4. Vía NLWeb: Prueba búsqueda en lenguaje natural en `POST /demo-store/ask` con `{ "query": "chaqueta impermeable barata", "mode": "list" }` para búsqueda semántica vectorial.

Preguntas frecuentes

¿Necesito una API key para buscar productos en la demo store?

No. Las herramientas de descubrimiento (search_products, get_product_details, browse_categories, get_merchant_profile) funcionan sin autenticación en el endpoint demo. Solo necesitas clave sandbox para herramientas de checkout (create_cart en adelante). Obtén una gratis: POST /api/v1/sandbox/key.

¿Qué pasa si llamo a complete_checkout dos veces con la misma idempotency key?

La segunda llamada devuelve el mismo resultado que la primera sin crear un pedido o cargo duplicado. Esto es por diseño — las idempotency keys aseguran reintentos seguros en caso de fallos de red. Siempre pasa un idempotency_key para complete_checkout.

¿Cómo funciona la elicitation de dirección fuera de Claude.ai?

La elicitation es una funcionalidad del SDK MCP (v1.28.0+). En Claude.ai se renderiza como formulario inline. En otros clientes MCP, el comportamiento depende de la implementación del cliente. También puedes omitir la elicitation pasando shipping_address directamente en los argumentos de get_shipping_rates.

¿Los códigos de descuento son reales?

En modo sandbox, sí — WELCOME10 (10% descuento), DEMO20 (20% descuento) y FREESHIP (envío gratis) funcionan y ajustan correctamente el total del carrito. En producción, los merchants configuran sus propios códigos de descuento.

¿Puedo probar checkout PayPal o x402 en la demo store?

La demo store soporta múltiples protocolos de pago. Pasa payment_method: 'ACP' para Stripe (modo test), 'MOCK' para pago simulado, o 'PAYPAL' para sandbox PayPal (requiere redirect de aprobación del comprador). Los pagos x402 stablecoin funcionan en sandbox con transacciones blockchain simuladas.

Fuentes y referencias

Artículos relacionados

integration-guide

Odoo + MCP en 15 Minutos: Conecta tu ERP a Agentes IA

Conecta tu instancia Odoo 16, 17 o 18 a agentes IA en menos de 15 minutos. Un conector JSON-RPC, cero cambios en Odoo. Tus productos, niveles de stock y listas de precios se vuelven descubribles y comprables por Claude, GPT y otros agentes IA vía MCP.

Flujo de Compra de Agente IA: Walkthrough Completo de la Demo Store | AgenticMCPStores | AgenticMCPStores