> For the complete documentation index, see [llms.txt](https://docs.flowlity.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flowlity.com/es/mcp.md).

# Coplanner/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.

<figure><img src="/files/uxJTM1GH2uQGCDchZH8k" alt="Interfaz de Claude mostrando el conector Ask Flowlity"><figcaption><p>Claude con el conector MCP de Flowlity — pregunta lo que quieras sobre tus datos de cadena de suministro.</p></figcaption></figure>

{% 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="<https://app.arcade.software/share/McpxHRqhSSnSKnhrxSyV>" %}
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": "<server-url-provided-by-flowlity>/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

<details>

<summary>¿Tiene la IA acceso a todos los datos de mi empresa?</summary>

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.

</details>

<details>

<summary>¿Puede la IA inventar datos?</summary>

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.

</details>

<details>

<summary>¿Qué asistentes de IA son compatibles?</summary>

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.

</details>

<details>

<summary>¿Tiene algún coste usar MCP?</summary>

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).

</details>

<details>

<summary>¿Puedo usar MCP con otras herramientas en la misma conversación?</summary>

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.

</details>
