Conectá una IA a tu POS con el servidor MCP de IntegralShop

Tiempo estimado: 15 minutos. Dificultad: media. Solo se configura una vez por asistente.

1. Qué es MCP y por qué importa a tu comercio

MCP (Model Context Protocol) es un estándar abierto que permite que un asistente de IA se conecte a tus datos y los consulte de forma segura. En lugar de que la IA "invente" un precio, se conecta a tu sistema y lee el valor real.

IntegralShop expone un servidor MCP que funciona como un puente: vos creás una API key de solo lectura, la pegás en tu asistente y desde ahí podés hacer preguntas sobre tus productos y precios en lenguaje natural.

2. Qué puede consultar la IA hoy

• Buscar un producto por nombre o código.
• Consultar el precio actual de un producto.
• Listar los precios de una categoría.
• Ver el histórico de precios de un producto.
• Consultar varias tiendas, usando la lista de precios de cada una.

Hoy el servidor se enfoca en productos y precios. Está diseñado para crecer y, más adelante, acceder a todo el sistema.

3. Requisitos previos

• Una cuenta activa de IntegralShop.
• Un asistente compatible: Roo, Claude, Codex o Cursor.
• Acceso al módulo de Ajustes para crear la API key.

4. Paso a paso: creá tu API key

1. Entrá a Ajustes y abrí la pestaña API Keys.
2. Elegí Nueva API Key.
3. La clave se muestra una sola vez: copiala y guardala en un lugar seguro.
4. Copiá el bloque de configuración mcpServers (con la URL completa) o descargá el archivo .json.

5. Paso a paso: conectá tu asistente

Pegá el bloque de configuración en tu asistente. El servidor queda disponible en la URL pública y se autentica con tu API key:

{
  "mcpServers": {
    "integralShop": {
      "url": "https://mcp.integralshop.com.ar/mcp",
      "headers": {
        "Authorization": "Bearer pos__"
      }
    }
  }
}

Una vez conectado, ya podés hacer preguntas sobre tu comercio.

6. Ejemplos de prompts

• "¿Cuánto cuesta la coca cola 1.5 litros en mi tienda?"
• "Listame los precios de la categoría Lácteos."
• "¿Cómo cambió el precio del producto X en el último mes?"

7. Seguridad y permisos

• Solo lectura: la IA no puede modificar tus datos.
• Por tienda: cada consulta usa la tienda a la que tenés acceso.
• Auditado: cada consulta queda registrada.
• Permisos: el costo de un producto solo se muestra si tu key tiene el permiso correspondiente.

8. Qué viene después

Hoy el servidor consulta productos y precios. Está pensado para ampliarse y, más adelante, acceder a todo el sistema: stock, ventas y caja, reportes y KPIs, clientes, proveedores y facturación ARCA. La conexión con ChatGPT vía OAuth está en preparación.

Conocé más en la página del servidor MCP para asistentes IA.