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 perfilCategoría
case-study
¿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
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
Paso 6: Aplicar Código de Descuento
Paso 7: Preview del Checkout
Paso 8: Completar el Checkout
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
- Model Context Protocol — Elicitation
Anthropic
- AgenticMCPStores Demo Store
AgenticMCPStores
- Especificación JSON-RPC 2.0
JSON-RPC Working Group
Artículos relacionados
developer-guide
Building Agentic Commerce #1: Checkout Multi-Protocolo — MCP + x402 + ACP en un solo flujo
Un agente, tres protocolos, un checkout. Asi es como MCP, pagos stablecoin x402 y ACP trabajan juntos para que los agentes de IA compren productos, con ejemplos de codigo que puedes ejecutar hoy.
developer-guide
Building Agentic Commerce #3: Trust Scores — Cómo los Agentes Deciden a Quién Comprarle
Cuando un agente IA evalúa merchants, no lee reseñas ni reconoce logos. Lee trust scores — 12 señales verificables por máquina que determinan ranking de búsqueda, elegibilidad de checkout y fricción de pago. Así funciona el sistema.
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.