Conectá tu asistente de IA (ChatGPT, Claude, Codex, Roo, Cursor) a IntegralShop mediante un servidor MCP de solo lectura. Consultá productos y precios de tu comercio de forma segura, con permisos y auditoría.
MCP (Model Context Protocol) es un estándar abierto que permite a los asistentes de IA acceder a datos de forma controlada. El servidor MCP de IntegralShop expone la información de tu comercio como herramientas que el asistente puede invocar, siempre bajo tu API key y tus permisos.
| Característica | Servidor MCP de IntegralShop |
|---|---|
| Protocolo | MCP sobre HTTP (streamable), JSON-RPC 2.0 |
| Acceso | Solo lectura de productos y precios |
| Autenticación | API key con header Authorization: Bearer |
| Permisos | Scopes configurables por clave |
| Multi-tienda | Consulta por sucursal y lista de precios |
| Auditoría | Cada consulta queda registrada |
| Límite de uso | Rate limit por clave y herramienta |
| Modificación de datos | No permite escribir ni modificar |
El servidor MCP ya está disponible para consultar el catálogo y los precios de tu comercio. El resto del sistema se irá sumando en próximas versiones.
Buscá productos por nombre, código o SKU y obtené su información del catálogo.
Consultá el precio de venta de un producto o listá los precios de una categoría.
Revisá cómo cambió el precio de un producto en un período de tiempo.
Cada consulta puede apuntar a una sucursal y usar su lista de precios.
El asistente nunca puede modificar precios, stock ni ninguna información.
La IA ya puede ayudarte a interpretar precios y productos. Los reportes completos se suman pronto.
El servidor MCP está diseñado para ver todo el sistema a futuro. Hoy arranca con productos y precios, y en próximas versiones sumará el resto de los módulos de tu comercio.
Consultar existencias, mínimos y movimientos de stock en tiempo real.
Preguntar por ventas del día, cierres de caja y formas de pago.
Rentabilidad, rankings y comparativas para decidir con datos.
Consultar saldos, fiados y movimientos de tus clientes.
Historial de compras y comparador de precios de proveedores.
Consultar comprobantes emitidos y su estado de autorización.
Además, la conexión nativa de ChatGPT mediante OAuth está en preparación para una próxima versión.
Creá una API key, copiala y pegala en tu asistente favorito.
Entrá a Ajustes → API Keys y creá una nueva clave para asistentes IA. Elegí los scopes de acceso que querés habilitar.
La key se muestra una sola vez al crearla. Copiala o descargá el archivo JSON de configuración. No se volverá a mostrar.
Pegá la URL del servidor MCP y tu API key en Roo, Claude, Codex o Cursor. El asistente queda listo para consultar tu comercio.
Pedile precios, productos o históricos en lenguaje natural. Cada consulta queda auditada en tu comercio.
Estas son las herramientas que tu asistente puede invocar en la versión 1. Todas aceptan un idTienda opcional para consultar una sucursal específica.
| Herramienta | Qué hace | Parámetros |
|---|---|---|
ping |
Verifica que el servidor esté activo y que la key sea válida para tu tenant. | Sin parámetros |
buscar_producto |
Busca productos por nombre, código o SKU. | query (obligatorio), idTienda?, limit? (máx. 50) |
obtener_precio_producto |
Obtiene el precio de un producto puntual. | skuOCodigo (obligatorio), idTienda? |
listar_precios |
Lista precios por categoría o por fecha de modificación. | categoria?, modificationDate? (yyyy-MM-dd), idTienda?, limit? |
historico_precios |
Muestra el histórico de precios de un producto en un período. | idProducto (obligatorio), fechaDesde?, fechaHasta?, idTienda? |
El costo de los productos solo se expone si tu API key incluye el scope precios:read:con_costo. Sin ese permiso, el costo nunca se devuelve.
Seguridad y permisos pensados para que la IA consulte sin riesgos.
El asistente solo puede consultar. No puede modificar precios, stock ni ninguna información de tu comercio.
Cada API key habilita scopes específicos. El costo solo se expone con precios:read:con_costo.
El comercio se deriva siempre de tu API key, nunca de la solicitud. Solo accede a tus tiendas.
Cada llamada a una herramienta se registra en un log de auditoría en la base de datos de tu comercio.
El uso se limita por clave y por herramienta para proteger tu comercio y el servicio.
Podés revocar o eliminar una API key en cualquier momento desde Ajustes → API Keys.
Ejemplos de prompts listos para usar con tu API key.
El asistente busca el producto y devuelve su precio de venta.
El asistente lista los precios de todos los productos de esa categoría.
El asistente consulta el histórico de precios del producto.
El asistente lista los precios modificados en el período indicado.
Configuración del asistente (mcpServers)
{
"integralshop": {
"type": "http",
"url": "https://mcp.integralshop.com.ar/mcp",
"headers": {
"Authorization": "Bearer [TU_API_KEY]"
},
"alwaysAllow": [
"ping",
"buscar_producto",
"obtener_precio_producto",
"listar_precios",
"historico_precios"
]
}
}Explorá el resto de las funcionalidades y recursos del sistema.
Creá tu API key en Ajustes → API Keys y empezá a consultar productos y precios con tu asistente favorito.