Skip to content
Centro de ayuda

Preguntas Frecuentes

Respuestas a las preguntas más frecuentes sobre AgenticMCPStores: plataforma, integración para comercios, API para desarrolladores y capacidades para agentes IA.

General

¿Qué es AgenticMCPStores?

AgenticMCPStores es una capa de confianza y ejecución multi-comercio para el comercio agéntico. Conecta tiendas Shopify y WooCommerce con asistentes de IA como ChatGPT y Claude mediante el MCP (Model Context Protocol), permitiendo descubrimiento de productos, navegación por catálogo e inicio de checkout sin modificar las operaciones principales.

¿AgenticMCPStores es gratuito?

Sí. El acceso beta actual es completamente gratuito. Conecta una tienda, expón tu catálogo a agentes de IA y valida el tráfico antes de escalar. Los planes de pago se introducirán cuando se ganen su lugar — menor comisión, mayor visibilidad, mejor medición.

¿Qué asistentes de IA funcionan con AgenticMCPStores?

Cualquier asistente de IA que admita MCP (Model Context Protocol) — incluidos Claude, plugins de ChatGPT y agentes LLM personalizados — puede conectarse a AgenticMCPStores. Los agentes construidos con el SDK WebMCP también pueden interactuar desde el navegador.

¿Cuánto tarda el proceso de incorporación?

Menos de 5 minutos. Selecciona tu plataforma (Shopify o WooCommerce), introduce la URL de tu tienda y las credenciales de API, configura las capacidades del agente y tu tienda estará activa en la red de comercio agéntico.

Para Comercios

¿Necesito modificar mi tienda Shopify o WooCommerce?

No. La integración usa la API existente de tu tienda. Leemos tu catálogo, precios, stock, política de devoluciones y reglas de envío — sin cambios de código en tu tienda.

¿A qué datos accede AgenticMCPStores?

Accedemos a datos del catálogo (productos, precios, stock), políticas de la tienda (devoluciones, envío) y estado de pedidos tras el checkout. Nunca almacenamos datos personales de clientes. Tus claves API están cifradas con AES-256.

¿Puedo controlar qué pueden hacer los agentes de IA en mi tienda?

Sí. Tú fijas las reglas: a qué categorías pueden acceder los agentes, valores máximos de pedido y si determinadas acciones requieren confirmación humana. Los agentes no pueden superar los permisos que configures.

¿Cómo afecta el Trust Score a mi tienda?

El Trust Score (0,0–1,0) determina la visibilidad de tu tienda en los resultados de búsqueda de los agentes. Las tiendas con puntuación ≥ 0,5 aparecen en el nivel principal. Las puntuaciones entre 0,3–0,5 se desempriorizan. Las tiendas por debajo de 0,3 o suspendidas quedan ocultas. Mejora tu puntuación manteniendo los datos del catálogo actualizados, precios precisos y altas tasas de cumplimiento.

Para Desarrolladores

¿Qué autenticación usa la Agent API?

La Agent API usa claves con el prefijo agnt_. Crea claves mediante POST /api/v1/agent-keys con tu JWT. Las claves admiten permisos con ámbito: agent:read (navegación de catálogo), agent:cart (creación de carrito), agent:checkout (inicio de checkout). Incluye la clave en el header X-Agent-Api-Key.

¿Cuál es el formato del endpoint MCP?

Cada tienda tiene un endpoint MCP único en /mcp/{store-slug}. El servidor MCP global en /mcp sirve a todas las tiendas conectadas y acepta consultas de búsqueda en todo el catálogo. Soporta tanto el transporte streamable-http como el fallback SSE en /mcp/sse.

¿Cómo verifico los payloads de los webhooks?

Todos los POST de webhook incluyen un header X-Webhook-Signature con una firma HMAC-SHA256. Calcula el HMAC-SHA256 del cuerpo raw de la petición usando tu secreto de webhook y compáralo con el valor del header. Rechaza las peticiones cuyas firmas no coincidan.

¿Hay una especificación OpenAPI?

Sí. La especificación OpenAPI 3.0 completa está disponible en /api/openapi.json. Impórtala en Postman, Insomnia o cualquier herramienta compatible con OpenAPI. Hay una Swagger UI interactiva disponible en /api/docs.

Para Agentes IA

¿Cómo descubre AgenticMCPStores un agente de IA?

AgenticMCPStores expone múltiples capas de descubrimiento: /.well-known/merchant-index.json (registro completo de comercios — slug, categorías, trust_score, mcp_endpoint, frescura; ISR 5 min, sin autenticación), /.well-known/agent-commerce.json (contrato canónico con endpoints, autenticación, límites de tasa, framework de confianza y directorio de comercios), /mcp.json (manifiesto MCP con todas las herramientas), /.well-known/ai-plugin.json (compatible con ChatGPT/OpenAI) y etiquetas <link rel='mcp'> en la cabecera de cada página para agentes basados en navegador.

¿Qué acciones requieren confirmación humana?

La creación de carrito y el inicio de checkout siempre requieren confirmación humana explícita. Las operaciones de solo lectura (búsqueda, detalle de producto, disponibilidad, perfil de comercio) nunca requieren confirmación. El umbral de confirmación también es configurable por comercio — por defecto, cualquier pedido superior a 100 $ activa un paso de confirmación adicional.

¿Cuál es la fórmula de ranking para agentes?

relevanceScore = (text_relevance × 0,55) + (store_trust_score × 0,25) + (freshness × 0,10) + (in_stock × 0,10). Las tiendas con trustScore < 0,5 siempre se colocan después de todas las tiendas del nivel activo independientemente de su relevanceScore calculado — es un ordenamiento en dos niveles fijo, no un desempate.

¿AgenticMCPStores procesa pagos?

No. AgenticMCPStores no es un procesador de pagos ni un merchant of record. La herramienta de checkout devuelve una URL que redirige al checkout nativo del comercio (Shopify Payments, WooCommerce, etc.). Los pagos se realizan en la plataforma del comercio, no en la nuestra.

¿Listo para empezar?

Únete a la beta gratis y conecta tu tienda a agentes de IA en minutos.

Crear cuenta gratis
Preguntas Frecuentes (FAQ) | AgenticMCPStores