# MCP

MCP (Model Context Protocol) ist ein offener Standard, mit dem KI-Assistenten direkt eine Verbindung zu externen Tools und Datenquellen herstellen können. Flowlity betreibt einen MCP-Server, über den Sie Ihre Lieferkettendaten abfragen, Aktionen erstellen, Ansichten verwalten und vieles mehr können – alles über eine Chat-Oberfläche.

Stellen Sie sich das als Brücke vor: Die KI wird zur Schnittstelle, Flowlity bleibt die Engine.

<figure><img src="/files/MtN8vgi3ma8NIV2xSO0H" alt="Claude-Oberfläche mit dem Ask Flowlity-Konnektor"><figcaption><p>Claude mit dem Flowlity MCP-Konnektor – stellen Sie jede Frage zu Ihren Lieferkettendaten.</p></figcaption></figure>

{% hint style="info" %}
MCP wird von **Claude**, **ChatGPT** und **GitHub Copilot** unterstützt. Weitere Clients werden hinzugefügt, je mehr das Protokoll verbreitet wird.
{% endhint %}

{% embed url="<https://app.arcade.software/share/McpxHRqhSSnSKnhrxSyV>" %}
Den Flowlity MCP-Server in Aktion sehen
{% endembed %}

## Was Sie tun können

### Ihre Daten lesen

Stellen Sie Fragen in natürlicher Sprache und erhalten Sie echte Antworten aus Ihrem Flowlity-Konto:

* **Bestandsniveaus** – „Wie viel Bestand habe ich für Standort Paris?"
* **Prognosegenauigkeit** – „Welche Produkte haben die schlechteste Prognosegenauigkeit? Zeige mir die Top 5."
* **Produktdetails** – „Erzähle mir von Produkt X – was passiert mit Bestand und Bedarf?"
* **KPIs und Trends** – „Zeige mir die KPI-Trends der letzten 6 Monate."
* **Aufträge und Warnungen** – „Gibt es Auftragswarnungen für Standort Lyon?"
* **Kapazität** – „Liste Kapazitätseinheiten und ihre Warnungen auf."

### Handeln

Gehen Sie über die reine Leseansicht hinaus – der MCP-Server ermöglicht es Ihnen auch, auf Ihre Daten einzuwirken:

* **Ansichten erstellen** – Bitten Sie die KI, eine Bedarfs- oder Planungsansicht mit relevanten Spalten und Filtern einzurichten, ohne die App zu öffnen.
* **Aktionen erstellen** – „Erstelle eine Aktion für alle Klasse-A-Produkte, erhöhe die Prognose um 30 %." Die KI findet die Produkte und erstellt das Ereignis direkt.
* **Prognosen überschreiben** – Passen Sie Ihre Prognosewerte per Konversation an.
* **Bedarf simulieren** – Modellieren Sie „Was-wäre-wenn"-Szenarien und sehen Sie die prognostizierten Bestandsauswirkungen.
* **Daten importieren** – Laden Sie CSV-Dateien hoch und starten Sie Datenpipelines (Flowlity Lite).
* **Empfohlene Aufträge anwenden** – Akzeptieren Sie Flowlitys empfohlene Auftragsmengen.

### Übergreifende Tool-Stärke

Der größte Vorteil gegenüber einer eingebetteten KI-Seitenleiste: In derselben Konversation können Sie gleichzeitig mit **Flowlity + Ihrem CRM + Ihrem ERP + Tabellenkalkulationen** sprechen.

Zum Beispiel: CRM-Opportunities abrufen, sie mit Flowlity-Prognosen abgleichen und Diskrepanzen aufzeigen – alles in einem Chat.

## Einrichtung

### Voraussetzungen

* Ein gültiges **Flowlity-Konto**
* Zugang zu einem unterstützten KI-Assistenten (Claude oder ChatGPT)

### Verbindung über Claude (empfohlen)

1. Gehen Sie zu [claude.ai](https://claude.ai) und öffnen Sie **Einstellungen**.
2. Navigieren Sie zu **Connectors**, dann klicken Sie auf **Add custom connector**.
3. Füllen Sie die Felder aus:
   * **Name**: `Flowlity`
   * **Server URL**: von Ihrem *Flowlity Customer Success Manager* bereitgestellt
   * **Client ID**: von Ihrem *Flowlity Customer Success Manager* bereitgestellt
4. Speichern Sie die Konfiguration.
5. Sie werden zur Authentifizierung weitergeleitet – **melden Sie sich mit derselben E-Mail-Adresse wie Ihr Flowlity-Konto an**.
6. Überprüfung: Starten Sie eine neue Konversation und fragen Sie *„List all my Flowlity sites"*. Wenn Ihre Standorte erscheinen, funktioniert die Verbindung.

### Verbindung über ChatGPT

1. Gehen Sie zu [chatgpt.com](https://chatgpt.com) und öffnen Sie **Einstellungen**.
2. Navigieren Sie zu **Erweiterte Einstellungen** und aktivieren Sie den **Entwicklermodus**.
3. Gehen Sie zu **Apps** und erstellen Sie eine neue App.
4. Geben Sie die **Server URL** ein, die von Ihrem Flowlity *Customer Success Manager* bereitgestellt wurde. Die Authentifizierung wird automatisch erkannt – keine Client-ID erforderlich.
5. Autorisieren Sie mit Ihrem Flowlity-Konto.
6. Überprüfung: Fragen Sie *„List all my Flowlity sites"*.

### Verbindung über Claude Code (CLI)

Fügen Sie Folgendes zu Ihrer Claude Code MCP-Konfiguration hinzu:

```json
{
  "mcpServers": {
    "flowlity": {
      "type": "url",
      "url": "<server-url-provided-by-flowlity>/mcp/"
    }
  }
}
```

Bei der ersten Verwendung werden Sie zur Authentifizierung aufgefordert.

## Verfügbare Tools

Der MCP-Server stellt die folgenden Tools bereit, geordnet nach Domäne:

| Domäne                   | Tools                                                                                 | Beschreibung                                                                          |
| ------------------------ | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| **Standorte**            | `list_sites`, `get_site_config`                                                       | Ihre Standorte und deren Konfiguration durchsuchen                                    |
| **Produkte**             | `list_products`, `get_product_detail`, `get_product_planning`                         | Produkte suchen, Details anzeigen und auf Planungszeitreihen zugreifen                |
| **Aufträge**             | `list_orders`, `get_order_alerts`                                                     | Auftragspositionen und Warnungen prüfen                                               |
| **Bedarf**               | `get_demand_summary`, `get_forecast_accuracy`, `override_forecast`, `simulate_demand` | Bedarf analysieren, Genauigkeit prüfen, Prognosen überschreiben, Simulationen starten |
| **Bestand**              | `get_stock_levels`, `get_stock_coverage`                                              | Bestandsniveaus und Deckungskennzahlen prüfen                                         |
| **Kapazität**            | `list_capacity_units`, `get_capacity_alerts`                                          | Kapazitätseinheiten und Warnungen überwachen                                          |
| **Tags**                 | `list_tags`                                                                           | Produkt-Tags und Kategorien auflisten                                                 |
| **Aktionen**             | `list_promotions`, `get_promotion_detail`, `create_promotion`                         | Prognoseereignisse durchsuchen, prüfen und erstellen                                  |
| **KPIs**                 | `get_site_kpis`, `get_kpi_trends`, `list_product_alerts`                              | Dashboard-KPIs, Trendanalyse und Produktwarnungen                                     |
| **Ansichten**            | `list_views`, `create_view`, `update_view`, `delete_view`                             | Gespeicherte Ansichten für Bedarfs- und Planungsmodule verwalten                      |
| **Daten**                | `upload_import_file`, `trigger_import_dag`, `get_import_status`, `export_data`        | CSV-Daten importieren, Pipelines starten und Datensätze exportieren (Flowlity Lite)   |
| **Aufträge (Schreiben)** | `apply_recommended_orders`                                                            | Flowlitys empfohlene Auftragsmengen akzeptieren                                       |

{% hint style="info" %}
Sie müssen sich keine Tool-Namen merken. Beschreiben Sie einfach in natürlicher Sprache, was Sie brauchen, und der KI-Assistent wählt automatisch das richtige Tool aus.
{% endhint %}

## Sicherheit und Datenschutz

* **Gleiche Anmeldedaten, gleiche Berechtigungen** – Der MCP-Server authentifiziert sich mit Ihrem Flowlity-Konto. Sie sehen nur die Standorte und Daten, auf die Sie bereits Zugriff haben.
* **OAuth 2.0** – Die Authentifizierung verwendet den Industriestandard OAuth 2.0 mit Bearer-Tokens.
* **Keine Datenexposition** – Alle Datenbankverbindungen laufen über private Netzwerke. Es wird keine öffentliche IP exponiert.
* **Deterministische Tool-Aufrufe** – Wenn die KI ein Tool aufruft, wird eine echte Datenbankabfrage ausgeführt. Die zurückgegebenen Daten sind stets real und korrekt – nur die Formulierung und Interpretation durch die KI kann gelegentlich variieren.

## Beispiel-Eingabeaufforderungen

Hier sind einige Eingabeaufforderungen für den Einstieg:

| Ziel                    | Beispiel-Eingabeaufforderung                                                                                  |
| ----------------------- | ------------------------------------------------------------------------------------------------------------- |
| Überblick               | *„Gib mir eine Zusammenfassung meiner KPIs für Standort Paris"*                                               |
| Produkt untersuchen     | *„Wie ist die Bestandssituation für Produkt ABC-123?"*                                                        |
| Probleme finden         | *„Welche Produkte haben eine Bestandsreichweite von weniger als 7 Tagen?"*                                    |
| Prognosegenauigkeit     | *„Zeige mir die 5 Produkte mit dem schlechtesten MAPE"*                                                       |
| Aktion erstellen        | *„Erstelle eine 20%ige Prognoseerhöhung für alle Produkte mit dem Tag 'Sommer' vom 1. Juli bis 31. August"*   |
| Auswirkungen simulieren | *„Was passiert, wenn der Bedarf nächsten Monat für Standort Lyon um 15 % steigt?"*                            |
| Ansicht einrichten      | *„Erstelle eine Planungsansicht mit Bestandswert-, Bedarf-30T- und MAPE-Spalten, gefiltert auf MTS-Produkte"* |
| Daten exportieren       | *„Exportiere die letzten 3 Monate Bedarfsdaten für Standort Berlin als CSV"*                                  |

## FAQ

<details>

<summary>Hat die KI Zugriff auf alle meine Unternehmensdaten?</summary>

Nein. Der MCP-Server respektiert dieselben Benutzerberechtigungen wie die Flowlity-App. Sie sehen nur die Standorte und Produkte, die Ihrem Konto zugewiesen sind.

</details>

<details>

<summary>Kann die KI Daten halluzinieren?</summary>

Tool-Aufrufe sind deterministisch – sie führen echte Datenbankabfragen aus und geben tatsächliche Daten zurück. Die KI kann keine Zahlen erfinden. Allerdings kann die Interpretation oder Zusammenfassung der Daten durch die KI gelegentlich ungenau sein. Überprüfen Sie kritische Entscheidungen stets in der Flowlity-App.

</details>

<details>

<summary>Welche KI-Assistenten werden unterstützt?</summary>

Claude (Anthropic), ChatGPT (OpenAI) und GitHub Copilot unterstützen derzeit MCP. Weitere Clients werden erwartet, wenn der Standard weiter verbreitet wird.

</details>

<details>

<summary>Entstehen Kosten für die Nutzung von MCP?</summary>

Die Nutzung des MCP-Servers erfordert ein Flowlity-Konto. Die KI-Nutzungskosten (Token, Abonnements) hängen vom gewählten KI-Anbieter ab (z. B. Claude Pro, ChatGPT Plus).

</details>

<details>

<summary>Kann ich MCP mit anderen Tools in derselben Konversation verwenden?</summary>

Ja – das ist einer der wichtigsten Vorteile. In einer einzigen Konversation können Sie Flowlity zusammen mit Ihrem CRM, ERP, Tabellenkalkulationen oder jedem anderen MCP-kompatiblen Tool verbinden.

</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/de/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.
