# MCP MCP (Model Context Protocol) es un estándar abierto que permite a los asistentes de IA conectarse directamente a herramientas externas y fuentes de datos. Flowlity aloja un servidor MCP para que puedas consultar tus datos de la cadena de suministro, crear promociones, gestionar vistas y mucho más, todo desde una interfaz de chat. Piénsalo como un puente: la IA es la interfaz, Flowlity sigue siendo el motor.
Interfaz de Claude mostrando el conector Ask Flowlity

Claude con el conector MCP de Flowlity — pregunta lo que quieras sobre tus datos de cadena de suministro.

{% hint style="info" %} MCP es compatible con **Claude**, **ChatGPT** y **GitHub Copilot**. Se están añadiendo más clientes a medida que el protocolo gana adopción. {% endhint %} {% embed url="" %} Ve el servidor MCP de Flowlity en acción {% endembed %} ## Qué puedes hacer ### Consultar tus datos Haz preguntas en lenguaje natural y obtén respuestas reales de tu cuenta de Flowlity: * **Niveles de stock** — "¿Cuánto stock tengo para el sitio París?" * **Exactitud del pronóstico** — "¿Qué productos tienen la peor exactitud del pronóstico? Muéstrame los 5 primeros." * **Detalles de producto** — "Dime qué ocurre con el producto X — ¿qué pasa con el stock y la demanda?" * **KPIs y tendencias** — "Muéstrame las tendencias de KPI de los últimos 6 meses." * **Pedidos y alertas** — "¿Hay alertas de pedido en el sitio Lyon?" * **Capacidad** — "Lista las unidades de capacidad y sus alertas." ### Tomar acción Más allá de la consulta, el servidor MCP también te permite actuar sobre tus datos: * **Crear vistas** — Pide a la IA que configure una vista de Demanda o Planificación con columnas y filtros relevantes, sin abrir la aplicación. * **Crear promociones** — "Crea una promoción para todos los productos de Clase A, incrementa el pronóstico un 30 %." La IA encuentra los productos y crea el evento directamente. * **Ajustar pronósticos** — Modifica los valores de tu pronóstico mediante conversación. * **Simular demanda** — Modela escenarios "¿qué pasa si…?" y observa el impacto proyectado en el stock. * **Importar datos** — Sube archivos CSV y activa pipelines de datos (Flowlity Lite). * **Aplicar pedidos recomendados** — Acepta las cantidades de pedido recomendadas por Flowlity. ### Potencia entre herramientas La mayor ventaja frente a una barra lateral de IA integrada: en la misma conversación puedes hablar con **Flowlity + tu CRM + tu ERP + hojas de cálculo** simultáneamente. Por ejemplo: extrae oportunidades del CRM, compáralas con los pronósticos de Flowlity y detecta discrepancias, todo en un solo chat. ## Configuración ### Requisitos previos * Una **cuenta de Flowlity** válida * Acceso a un asistente de IA compatible (Claude o ChatGPT) ### Conectar mediante Claude (recomendado) 1. Ve a [claude.ai](https://claude.ai) y abre **Configuración**. 2. Navega a **Conectores** y haz clic en **Añadir conector personalizado**. 3. Rellena los campos: * **Nombre**: `Flowlity` * **URL del servidor**: proporcionada por tu *Customer Success Manager de Flowlity* * **Client ID**: proporcionado por tu *Customer Success Manager de Flowlity* 4. Guarda la configuración. 5. Serás redirigido para autenticarte — **inicia sesión con el mismo correo de tu cuenta de Flowlity**. 6. Verifica: inicia una nueva conversación y pregunta *"Lista todos mis sitios de Flowlity"*. Si tus sitios aparecen, la conexión funciona. ### Conectar mediante ChatGPT 1. Ve a [chatgpt.com](https://chatgpt.com) y abre **Configuración**. 2. Navega a **Configuración avanzada** y activa el **Modo desarrollador**. 3. Ve a **Apps** y crea una nueva aplicación. 4. Introduce la **URL del servidor** proporcionada por tu *Customer Success Manager* de Flowlity. La autenticación se descubre automáticamente, no se necesita client ID. 5. Autoriza con tu cuenta de Flowlity. 6. Verifica: pregunta *"Lista todos mis sitios de Flowlity"*. ### Conectar mediante Claude Code (CLI) Añade lo siguiente a tu configuración MCP de Claude Code: ```json { "mcpServers": { "flowlity": { "type": "url", "url": "/mcp/" } } } ``` Se te pedirá que te autentiques en el primer uso. ## Herramientas disponibles El servidor MCP expone las siguientes herramientas, organizadas por dominio: | Dominio | Herramientas | Descripción | | ----------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | | **Sitios** | `list_sites`, `get_site_config` | Navega por tus sitios y su configuración | | **Productos** | `list_products`, `get_product_detail`, `get_product_planning` | Busca productos, consulta detalles y accede a series temporales de planificación | | **Pedidos** | `list_orders`, `get_order_alerts` | Revisa líneas de pedido y alertas | | **Demanda** | `get_demand_summary`, `get_forecast_accuracy`, `override_forecast`, `simulate_demand` | Analiza la demanda, comprueba la exactitud, ajusta pronósticos y ejecuta simulaciones | | **Inventario** | `get_stock_levels`, `get_stock_coverage` | Consulta niveles de stock y métricas de cobertura | | **Capacidad** | `list_capacity_units`, `get_capacity_alerts` | Monitoriza unidades de capacidad y alertas | | **Etiquetas** | `list_tags` | Lista etiquetas y categorías de productos | | **Promociones** | `list_promotions`, `get_promotion_detail`, `create_promotion` | Navega, inspecciona y crea eventos de pronóstico | | **KPIs** | `get_site_kpis`, `get_kpi_trends`, `list_product_alerts` | KPIs del Dashboard, análisis de tendencias y alertas de productos | | **Vistas** | `list_views`, `create_view`, `update_view`, `delete_view` | Gestiona vistas guardadas para los módulos de Demanda y Planificación | | **Datos** | `upload_import_file`, `trigger_import_dag`, `get_import_status`, `export_data` | Importa datos CSV, activa pipelines y exporta conjuntos de datos (Flowlity Lite) | | **Pedidos (escritura)** | `apply_recommended_orders` | Acepta las cantidades de pedido recomendadas por Flowlity | {% hint style="info" %} No necesitas memorizar los nombres de las herramientas. Simplemente describe lo que necesitas en lenguaje natural y el asistente de IA seleccionará la herramienta correcta automáticamente. {% endhint %} ## Seguridad y privacidad * **Mismas credenciales, mismos permisos** — El servidor MCP se autentica con tu cuenta de Flowlity. Solo ves los sitios y datos a los que ya tienes acceso. * **OAuth 2.0** — La autenticación utiliza OAuth 2.0 estándar del sector con tokens bearer. * **Sin exposición de datos** — Todas las conexiones a la base de datos pasan por redes privadas. No se expone ninguna IP pública. * **Llamadas a herramientas deterministas** — Cuando la IA llama a una herramienta, ejecuta una consulta real contra la base de datos. Los datos devueltos son siempre reales y precisos; solo la redacción e interpretación de la IA puede variar. ## Ejemplos de prompts Aquí tienes algunos prompts para empezar: | Objetivo | Ejemplo de prompt | | ------------------------ | --------------------------------------------------------------------------------------------------------------------------- | | Resumen general | *"Dame un resumen de mis KPIs para el sitio París"* | | Investigar un producto | *"¿Cuál es la situación de stock del producto ABC-123?"* | | Encontrar problemas | *"¿Qué productos tienen cobertura de stock inferior a 7 días?"* | | Exactitud del pronóstico | *"Muéstrame los 5 productos con peor MAPE"* | | Crear una promoción | *"Crea un incremento del pronóstico del 20 % para todos los productos etiquetados 'Verano' del 1 de julio al 31 de agosto"* | | Simular impacto | *"¿Qué ocurre si la demanda aumenta un 15 % el mes que viene en el sitio Lyon?"* | | Configurar una vista | *"Crea una vista de Planificación con columnas de valor de stock, demanda 30d y MAPE, filtrada a productos MTS"* | | Exportar datos | *"Exporta los últimos 3 meses de datos de demanda del sitio Berlín en CSV"* | ## Preguntas frecuentes
¿Tiene la IA acceso a todos los datos de mi empresa? No. El servidor MCP respeta los mismos permisos de usuario que la aplicación de Flowlity. Solo ves los sitios y productos asignados a tu cuenta.
¿Puede la IA inventar datos? Las llamadas a herramientas son deterministas: ejecutan consultas reales a la base de datos y devuelven datos reales. La IA no puede inventar números. Sin embargo, la interpretación o el resumen de los datos por parte de la IA puede ser impreciso en ocasiones. Verifica siempre las decisiones críticas en la aplicación de Flowlity.
¿Qué asistentes de IA son compatibles? Claude (Anthropic), ChatGPT (OpenAI) y GitHub Copilot son compatibles actualmente con MCP. Se esperan más clientes a medida que el estándar gana adopción.
¿Tiene algún coste usar MCP? Usar el servidor MCP requiere una cuenta de Flowlity. Los costes de uso de IA (tokens, suscripciones) dependen del proveedor de IA que elijas (p. ej., Claude Pro, ChatGPT Plus).
¿Puedo usar MCP con otras herramientas en la misma conversación? Sí — esta es una de las principales ventajas. En una sola conversación puedes conectar Flowlity junto a tu CRM, ERP, hojas de cálculo o cualquier otra herramienta compatible con MCP.
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.flowlity.com/es/mcp.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.