De 0 a Agent-Ready: La Guia Completa para Desarrolladores de MCPWebStore

Esta guia te lleva paso a paso por cada etapa de conectar tu tienda e-commerce con agentes IA via AgenticMCPStores. Al final, tendras un endpoint MCP en vivo, un catalogo de productos sincronizado, herramientas listas para agentes (search_products, create_cart, complete_checkout), un trust score visible para agentes, y un dashboard de merchant mostrando sesiones en tiempo real y analiticas. Tiempo requerido: unos 10 minutos para setup basico, unos 30 minutos para configuracion completa. Prerequisitos: una tienda activa en Shopify, WooCommerce u Odoo con al menos un producto publicado.

AgenticMCPStores actua como un puente entre tu plataforma e-commerce existente y los agentes IA. Sincroniza tu catalogo de productos a una base de datos normalizada (cache de 30 minutos), expone herramientas MCP estandarizadas que cualquier agente puede llamar, gestiona rate limiting, autenticacion y trust scoring, y NO procesa pagos — el checkout devuelve una URL a la pagina de pago de tu tienda. Esto significa cero riesgo de fraude desde la plataforma. Los agentes navegan y crean carritos; los clientes completan el pago en tu checkout existente.

Registrate en agenticmcpstores.com/dashboard. La autenticacion usa magic links — introduce tu email, haz clic en el enlace, y estas dentro. Sin contrasenas que gestionar. El tier gratuito (Starter) incluye: 1 conexion de tienda, 100 peticiones/minuto, 8 herramientas MCP (busqueda, categorias, carrito, checkout), trust score basico y soporte comunitario. Esto es suficiente para probar el flujo completo end-to-end antes de actualizar.

Para Shopify: haz clic en Anadir Tienda, introduce tu dominio mitienda.myshopify.com, y autoriza via OAuth. La plataforma sincroniza tu catalogo automaticamente usando paginacion basada en cursor (maneja 10K+ productos). Usa Shopify GraphQL Admin API con tokens OAuth que se auto-refrescan. Para WooCommerce: instala el plugin WordPress de AgenticMCPStores, copia tu Consumer Key y Consumer Secret desde WooCommerce Ajustes REST API. El plugin envia cambios via hooks de WordPress (on_product_save, on_stock_change, on_product_delete). Usa REST API v3 con HTTP Basic Auth. Para Odoo: introduce la URL de tu instancia (SaaS o self-hosted), autenticate con API key (recomendado sobre contrasena), y selecciona categorias de producto. Usa Odoo XML-RPC API. Tras conectar, tu tienda obtiene un slug unico y tu endpoint MCP queda activo.

Tu endpoint esta disponible inmediatamente para herramientas de solo lectura sin autenticacion. 11 herramientas son publicas (sin auth): search_products, get_product_details, browse_categories, get_merchant_profile, search_global_products, get_store_policies, check_availability, compare_products, get_deals, get_reviews, search_knowledge. Las herramientas de checkout (create_cart, preview_checkout, complete_checkout) requieren un Agent API Key o token OAuth Bearer.

Para flujos de checkout, los agentes necesitan autenticarse. Opcion A (recomendado): Agent API Key — genera desde Dashboard, Ajustes de Tienda, API Keys. Pasa via header X-Agent-Api-Key. Las keys se hashean con HMAC-SHA256; la plataforma nunca almacena la clave en texto plano. Opcion B: Token OAuth 2.0 Bearer para integraciones machine-to-machine (M2M) via /api/v1/auth/login. Para integracion con Claude Desktop / Claude.ai, anade una entrada mcpServers con la URL de tu tienda y API key en los headers.

La secuencia completa de checkout del agente: (1) search_products para encontrar productos, (2) get_product_details para confirmar precio y disponibilidad, (3) create_cart para anadir items y obtener un cart_id, (4) preview_checkout para ver el total con envio e impuestos, (5) get_shipping_rates para opciones disponibles, (6) select_shipping_option para que el agente elija metodo, (7) complete_checkout que devuelve una URL de checkout. El usuario humano completa el pago en la pagina de checkout nativa de tu tienda. La plataforma nunca maneja tarjetas de credito. Las sesiones de checkout estan encriptadas (AES-256-GCM) con un TTL de 30 minutos.

Tres mecanismos de descubrimiento: (1) Directorio de Merchants (automatico) — tu tienda se lista en /.well-known/merchant-index.json y /api/v1/stores/directory con slug, categorias, trust score y endpoint MCP. (2) Busqueda Semantica NLWeb — POST /{slug}/ask con consultas en lenguaje natural, usa embeddings pgvector, resultados via SSE. (3) Archivos de Descubrimiento Machine-Readable — /llms.txt, /mcp.json, /.well-known/acp.json, /.well-known/ucp, /.well-known/agent-policy.json, /.well-known/agent-card.json. Estos archivos son como Claude, ChatGPT y otros LLMs aprenden sobre la plataforma.

Tu trust score (0-100) determina el ranking de agentes. 8 componentes: completitud del catalogo (15%), transparencia de politicas (15%), verificacion eIDAS (20%), tiempo de respuesta (10%), uptime (10%), tasa de cumplimiento (15%), resenas de clientes (10%), postura de seguridad (5%). Ganancias rapidas: anadir descripciones completas con Schema.org GTINs (+15 puntos), publicar las tres politicas (+15 puntos), mantener catalogo sincronizado bajo 30 min de antiguedad (+10 puntos). Puntuaciones bajo 40 activan advertencias; bajo 20 puede excluir tu tienda de recomendaciones.

Registra endpoints de webhook via POST /api/v1/webhooks con eventos: order.created, order.status_changed, checkout.abandoned. Verifica payloads usando firma HMAC-SHA256 en header X-Webhook-Signature con crypto.timingSafeEqual para comparacion en tiempo constante.

AgenticMCPStores soporta 8 protocolos: MCP (Starter), ACP (Starter), AP2 (Growth), x402 stablecoin (Pro), UCP (Growth), A2A (Pro), AG-UI (Growth), VIC/MCAP redes de tarjetas (Enterprise). Cada protocolo es auto-detectado. Los agentes envian peticiones en su formato preferido; la plataforma normaliza todo a un AgentPaymentIntent unificado.