# MCP

MCP (Model Context Protocol) est un standard ouvert qui permet aux assistants IA de se connecter directement a des outils et sources de donnees externes. Flowlity heberge un serveur MCP pour que vous puissiez interroger vos donnees supply chain, creer des promotions, gerer des vues, et bien plus — le tout depuis une interface de chat.

Pensez-y comme un pont : l'IA devient l'interface, Flowlity reste le moteur.

<figure><img src="/files/kJqTgJqcqrKmONDSsyml" alt="Interface Claude montrant le connecteur Ask Flowlity"><figcaption><p>Claude avec le connecteur MCP Flowlity — posez n'importe quelle question sur vos donnees supply chain.</p></figcaption></figure>

{% hint style="info" %}
MCP est supporte par **Claude**, **ChatGPT** et **GitHub Copilot**. D'autres clients seront ajoutes a mesure que le protocole gagne en adoption.
{% endhint %}

{% embed url="<https://app.arcade.software/share/McpxHRqhSSnSKnhrxSyV>" %}
Decouvrez le serveur MCP Flowlity en action
{% endembed %}

## Ce que vous pouvez faire

### Lire vos donnees

Posez des questions en langage naturel et obtenez de vraies reponses depuis votre compte Flowlity :

* **Niveaux de stock** — "Quel est mon stock pour le site Paris ?"
* **Precision des previsions** — "Quels produits ont la pire precision de prevision ? Montre-moi le top 5."
* **Details produit** — "Parle-moi du produit X — que se passe-t-il avec le stock et la demande ?"
* **KPIs et tendances** — "Montre-moi les tendances KPI des 6 derniers mois."
* **Commandes et alertes** — "Y a-t-il des alertes de commande sur le site Lyon ?"
* **Capacite** — "Liste les unites de capacite et leurs alertes."

### Agir sur vos donnees

Allez au-dela de la lecture seule — le serveur MCP vous permet aussi d'agir :

* **Creer des vues** — Demandez a l'IA de configurer une vue Demande ou Planification avec les colonnes et filtres pertinents, sans ouvrir l'application.
* **Creer des promotions** — "Cree une promotion pour tous les produits Classe A, augmente les previsions de 30%." L'IA trouve les produits et cree l'evenement directement.
* **Modifier les previsions** — Ajustez vos valeurs de prevision par la conversation.
* **Simuler la demande** — Modelisez des scenarios "et si" et visualisez l'impact projete sur les stocks.
* **Importer des donnees** — Chargez des fichiers CSV et declenchez les pipelines de donnees (Flowlity Lite).
* **Appliquer les commandes recommandees** — Acceptez les quantites de commande recommandees par Flowlity.

### Puissance multi-outils

Le plus grand avantage par rapport a une barre laterale IA integree : dans la meme conversation, vous pouvez parler a **Flowlity + votre CRM + votre ERP + vos tableurs** simultanement.

Par exemple : recuperez les opportunites CRM, comparez-les aux previsions Flowlity et identifiez les ecarts — le tout dans un seul chat.

## Configuration

### Prerequis

* Un **compte Flowlity** valide
* Acces a un assistant IA compatible (Claude ou ChatGPT)

### Se connecter via Claude (recommande)

1. Allez sur [claude.ai](https://claude.ai) et ouvrez les **Parametres**.
2. Naviguez vers **Connecteurs**, puis cliquez sur **Ajouter un connecteur personnalise**.
3. Remplissez les champs :
   * **Nom** : `Flowlity`
   * **URL du serveur** : fournie par votre equipe Flowlity
   * **Client ID** : fourni par votre equipe Flowlity
4. Enregistrez la configuration.
5. Vous serez redirige pour vous authentifier — **connectez-vous avec la meme adresse e-mail que votre compte Flowlity**.
6. Verifiez : lancez une nouvelle conversation et demandez *"Liste tous mes sites Flowlity"*. Si vos sites apparaissent, la connexion fonctionne.

### Se connecter via ChatGPT

1. Allez sur [chatgpt.com](https://chatgpt.com) et ouvrez les **Parametres**.
2. Naviguez vers **Parametres avances** et activez le **Mode developpeur**.
3. Allez dans **Apps** et creez une nouvelle application.
4. Entrez l'**URL du serveur** fournie par votre equipe Flowlity. L'authentification est auto-decouverte — pas besoin de Client ID.
5. Autorisez avec votre compte Flowlity.
6. Verifiez : demandez *"Liste tous mes sites Flowlity"*.

### Se connecter via Claude Code (CLI)

Ajoutez la configuration suivante a votre fichier de configuration MCP Claude Code :

```json
{
  "mcpServers": {
    "flowlity": {
      "type": "url",
      "url": "<url-serveur-fournie-par-flowlity>/mcp/"
    }
  }
}
```

Vous serez invite a vous authentifier lors de la premiere utilisation.

## Outils disponibles

Le serveur MCP expose les outils suivants, organises par domaine :

| Domaine                  | Outils                                                                                | Description                                                                                |
| ------------------------ | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| **Sites**                | `list_sites`, `get_site_config`                                                       | Parcourir vos sites et leur configuration                                                  |
| **Produits**             | `list_products`, `get_product_detail`, `get_product_planning`                         | Rechercher des produits, voir les details et acceder aux series temporelles                |
| **Commandes**            | `list_orders`, `get_order_alerts`                                                     | Consulter les lignes de commande et les alertes                                            |
| **Demande**              | `get_demand_summary`, `get_forecast_accuracy`, `override_forecast`, `simulate_demand` | Analyser la demande, verifier la precision, modifier les previsions et simuler             |
| **Inventaire**           | `get_stock_levels`, `get_stock_coverage`                                              | Verifier les niveaux de stock et les metriques de couverture                               |
| **Capacite**             | `list_capacity_units`, `get_capacity_alerts`                                          | Surveiller les unites de capacite et les alertes                                           |
| **Tags**                 | `list_tags`                                                                           | Lister les tags et categories produit                                                      |
| **Promotions**           | `list_promotions`, `get_promotion_detail`, `create_promotion`                         | Parcourir, inspecter et creer des evenements previsionnels                                 |
| **KPIs**                 | `get_site_kpis`, `get_kpi_trends`, `list_product_alerts`                              | KPIs du tableau de bord, analyse de tendances et alertes produit                           |
| **Vues**                 | `list_views`, `create_view`, `update_view`, `delete_view`                             | Gerer les vues sauvegardees pour les modules Demande et Planification                      |
| **Donnees**              | `upload_import_file`, `trigger_import_dag`, `get_import_status`, `export_data`        | Importer des CSV, declencher des pipelines et exporter des jeux de donnees (Flowlity Lite) |
| **Commandes (ecriture)** | `apply_recommended_orders`                                                            | Accepter les quantites de commande recommandees par Flowlity                               |

{% hint style="info" %}
Vous n'avez pas besoin de memoriser les noms des outils. Decrivez simplement ce dont vous avez besoin en langage naturel et l'assistant IA selectionnera automatiquement le bon outil.
{% endhint %}

## Securite et confidentialite

* **Memes identifiants, memes permissions** — Le serveur MCP s'authentifie avec votre compte Flowlity. Vous ne voyez que les sites et donnees auxquels vous avez deja acces.
* **OAuth 2.0** — L'authentification utilise le standard OAuth 2.0 avec des tokens Bearer.
* **Aucune exposition de donnees** — Toutes les connexions base de donnees passent par des reseaux prives. Aucune IP publique n'est exposee.
* **Appels d'outils deterministes** — Quand l'IA appelle un outil, elle execute une vraie requete contre la base de donnees. Les donnees retournees sont toujours reelles et precises — seule la formulation et l'interpretation de l'IA peuvent varier.

## Exemples de prompts

Voici quelques prompts pour commencer :

| Objectif                 | Exemple de prompt                                                                                                |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------- |
| Vue d'ensemble           | *"Donne-moi un resume de mes KPIs pour le site Paris"*                                                           |
| Investiguer un produit   | *"Quelle est la situation du stock pour le produit ABC-123 ?"*                                                   |
| Trouver des problemes    | *"Quels produits ont une couverture de stock inferieure a 7 jours ?"*                                            |
| Precision des previsions | *"Montre-moi les 5 produits avec le pire MAPE"*                                                                  |
| Creer une promotion      | *"Cree une augmentation de 20% des previsions pour tous les produits tagges 'Ete' du 1er juillet au 31 aout"*    |
| Simuler un impact        | *"Que se passe-t-il si la demande augmente de 15% le mois prochain pour le site Lyon ?"*                         |
| Configurer une vue       | *"Cree une vue Planification avec les colonnes valeur stock, demande 30j et MAPE, filtree sur les produits MTS"* |
| Exporter des donnees     | *"Exporte les 3 derniers mois de donnees de demande pour le site Berlin en CSV"*                                 |

## FAQ

<details>

<summary>L'IA a-t-elle acces a toutes les donnees de mon entreprise ?</summary>

Non. Le serveur MCP respecte les memes permissions utilisateur que l'application Flowlity. Vous ne voyez que les sites et produits assignes a votre compte.

</details>

<details>

<summary>L'IA peut-elle inventer des donnees ?</summary>

Les appels d'outils sont deterministes — ils executent de vraies requetes en base de donnees et retournent des donnees reelles. L'IA ne peut pas inventer de chiffres. Cependant, l'interpretation ou le resume des donnees par l'IA peut parfois etre imprecis. Verifiez toujours les decisions critiques dans l'application Flowlity.

</details>

<details>

<summary>Quels assistants IA sont supportes ?</summary>

Claude (Anthropic), ChatGPT (OpenAI) et GitHub Copilot supportent actuellement MCP. D'autres clients sont attendus a mesure que le standard gagne en adoption.

</details>

<details>

<summary>Y a-t-il un cout pour utiliser MCP ?</summary>

L'utilisation du serveur MCP necessite un compte Flowlity. Les couts d'utilisation de l'IA (tokens, abonnements) dependent du fournisseur IA que vous choisissez (ex. Claude Pro, ChatGPT Plus).

</details>

<details>

<summary>Puis-je utiliser MCP avec d'autres outils dans la meme conversation ?</summary>

Oui — c'est l'un des principaux avantages. Dans une seule conversation, vous pouvez connecter Flowlity aux cotes de votre CRM, ERP, tableurs ou tout autre outil compatible MCP.

</details>


---

# 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/fr/mcp.md?ask=<question>
```

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.
