Zum Inhalt springen
For the complete documentation index, see llms.txt. This page is also available as Markdown.

ENLYZE MCP einrichten

Verbinde deinen KI-Assistenten mit ENLYZE MCP und frage deine Produktionsdaten ab.

In dieser Anleitung verbindest du deinen KI-Assistenten mit ENLYZE MCP. Wähle deinen Assistenten aus den Tabs unten.

Voraussetzungen

  • ENLYZE-Konto mit aktivem Zugriff auf die ENLYZE Manufacturing Data Platform

  • Einer der unterstützten KI-Assistenten: Microsoft Copilot (mit Copilot Studio), Claude Desktop, Claude Code, Cursor, VS Code, OpenAI Codex oder ein anderer MCP-kompatibler Client

Einrichtung

Wähle deinen KI-Assistenten aus und folge den Anweisungen, um dich mit ENLYZE MCP zu verbinden.

Microsoft Copilot ist nicht zu verwechseln mit dem Co-Pilot der ENLYZE Platform.

Schritt 1: Copilot Studio Lizenz erwerben

Um Microsoft Copilot mit einem externen Dienst wie ENLYZE MCP zu verbinden, ist eine Copilot Studio Lizenz erforderlich. Eine Microsoft 365 Copilot Lizenz reicht dafür nicht aus. Die Copilot Studio Lizenz wird für den Tenant (typischerweise das gesamte Unternehmen) erworben.

Schritt 2: Copilot Studio Nutzerlizenz zuweisen

Die Personen, die den Agenten konfigurieren, benötigen zusätzlich eine Copilot Studio Nutzerlizenz. Diese ist kostenlos und gibt einzelnen Nutzern Zugriff auf Copilot Studio. Sie ist nur für die Konfiguration nötig, nicht für die Nutzung: Alle Nutzer mit einer Microsoft 365 Copilot Lizenz können den fertigen Agenten verwenden.

Schritt 3: Neue Copilot Studio Version aktivieren

Öffne Copilot Studio im Browser. Nur die neue Version von Copilot Studio unterstützt den vollen Funktionsumfang von ENLYZE MCP. Sie ist derzeit noch nicht automatisch aktiv: Schalte sie über den Schalter New experience oben rechts ein. Die Oberfläche sollte danach wie folgt aussehen:

Copilot Studio in der neuen Version
Copilot Studio mit aktivierter neuer Version

Schritt 4: Agenten erstellen

Klicke links in der Seitenleiste auf Agents.

Menüpunkt Agents in der linken Seitenleiste
Der Menüpunkt Agents in der linken Seitenleiste

Klicke dann auf New agent, um mit der Erstellung zu starten:

Agentenübersicht mit der Schaltfläche New agent
Die Agentenübersicht mit der Schaltfläche New agent

Schritt 5: ENLYZE MCP als Tool hinzufügen

Füge im Bereich Tools ein neues Tool hinzu:

Bereich Tools in der Agentenkonfiguration
Der Bereich Tools in der Agentenkonfiguration

Klicke auf Add und wähle Model Context Protocol (MCP) aus:

Auswahl von Model Context Protocol (MCP)
Auswahl von Model Context Protocol (MCP)

Gib anschließend die Serverdetails ein:

Server Name

Beschreibung

Server URL

Ausgefüllte Serverdetails
Vollständig ausgefüllte Serverdetails

Klicke dann auf Add. Der Konnektor wird erstellt.

Schritt 6: Verbindung konfigurieren

Klicke neben Connection auf das Dropdown Not connected:

Dropdown Not connected neben Connection
Das Dropdown Not connected neben Connection

Wähle dann Create new connection:

Option Create new connection im Dropdown
Die Option Create new connection

Klicke anschließend auf Create. Ein Name für die Verbindung ist nicht notwendig:

Dialog zum Erstellen der Verbindung
Verbindung erstellen, der Display name kann leer bleiben

Schritt 7: Authentifizierung

Während des Verbindungsaufbaus wirst du zur Anmeldeseite von ENLYZE weitergeleitet. Wähle dort die passende Organisation aus und erlaube den Zugriff:

ENLYZE Anmeldeseite mit Organisationsauswahl
Organisation auswählen und Zugriff erlauben

Im Anschluss erscheint die Verbindung mit einem grünen Haken:

Verbindung mit grünem Haken
Die Verbindung ist hergestellt

Klicke auf Add. ENLYZE MCP steht dem Agenten nun zur Verfügung und erscheint unter Tools:

ENLYZE MCP in der Tool-Liste des Agenten
ENLYZE MCP in der Tool-Liste des Agenten

Schritt 8: Agenten testen

Wechsle im oberen Bereich in den Reiter Preview:

Reiter Preview in der Agentenansicht
Der Reiter Preview in der Agentenansicht

Dort siehst du eine gewohnte Chat-Oberfläche und kannst den Agenten testen. Beispiel-Prompts:

Zeige mir eine Liste der Fertigungsstandorte.

Wie war der OEE-Verlauf der Maschine XYZ über die letzten X Tage? Was sind Auffälligkeiten im Verlauf?

Schritt 9: Agenten veröffentlichen

Mit dem Veröffentlichen wird der Agent produktiv geschaltet und kann auch von Kollegen genutzt werden. Klicke dazu oben rechts auf Publish:

Schaltfläche Publish oben rechts
Die Schaltfläche Publish oben rechts

Damit der Agent für alle Nutzer in Microsoft 365 Copilot verfügbar ist, müssen zusätzlich die Veröffentlichungsdetails angepasst werden:

  1. Klicke auf den Pfeil nach unten neben Publish.

  2. Wähle in der Kanalliste Teams + Microsoft 365 aus.

  3. Aktiviere unter Turn on Microsoft 365 die Option Make agent available in Microsoft 365 Copilot.

  4. Klicke auf Save and publish.

Veröffentlichungsdetails mit dem Kanal Teams + Microsoft 365 und der Option Make agent available in Microsoft 365 Copilot
Der Kanal Teams + Microsoft 365 mit aktivierter Option Make agent available in Microsoft 365 Copilot

Schritt 1: Connector-Einstellungen öffnen

Öffne in Claude Desktop Anpassen → Konnektoren, klicke auf die Schaltfläche + neben Konnektoren und dann auf Benutzerdefinierten Konnektor hinzufügen.

Schritt 2: ENLYZE MCP hinzufügen

Gib einen Namen (z.B. ENLYZE) und die Server-URL ein und klicke auf Add:

URL:

Du musst unter Advanced settings keine OAuth Client ID oder Secret angeben. Claude wickelt den OAuth-Flow für dich ab.

Benutzerdefinierte Connectors erreichen deinen MCP-Server aus der Cloud von Anthropic, nicht von deinem Rechner. Der Server muss daher über das öffentliche Internet erreichbar sein. app.enlyze.com ist es, daher funktioniert das ohne weitere Konfiguration.

Schritt 3: Authentifizierung

Beim ersten Mal, wenn dein KI-Assistent ENLYZE MCP nutzt, wird dir automatisch ein Anmelde-Bildschirm angezeigt. Folge diesen Schritten:

  1. Anmelden: Melde dich mit deinem ENLYZE-Konto an

  2. Genehmigung erteilen: Der Genehmigungsbildschirm fragt, ob dein KI-Assistent auf dein ENLYZE-Konto und dessen Produktionsdaten zugreifen darf

  3. Bestätigen: Klicke Genehmigen oder Akzeptieren, um den Zugriff zu erlauben

Dein Client speichert das OAuth2-Token nach der Genehmigung. Du musst dich nicht erneut anmelden, solange das Token gültig ist. Läuft es ab, wirst du beim nächsten Zugriff erneut zur Anmeldung aufgefordert.

Alternative: lokale Bridge über claude_desktop_config.json

claude_desktop_config.json unterstützt nur lokale (stdio) Server, ein Eintrag mit { "type": "http", "url": … } funktioniert dort also nicht. Wenn du eine Konfiguration über die Datei bevorzugst, überbrücke den entfernten Server mit mcp-remote (benötigt Node.js):

Schritt 1: ENLYZE MCP hinzufügen

Führe den folgenden Befehl in deinem Terminal aus:

Schritt 2: Claude Code starten und authentifizieren

Öffne Claude Code:

Gib in Claude Code den Befehl /mcp ein, um die verfügbaren MCP-Server anzuzeigen. Claude Code leitet dich automatisch zum OAuth2-Consent-Screen weiter:

  1. Anmelden: Melde dich mit deinem ENLYZE-Konto an

  2. Genehmigung erteilen: Überprüfe die Zugriffsanfrage und erlaube deinem KI-Assistenten den Zugriff auf dein ENLYZE-Konto und dessen Produktionsdaten

  3. Bestätigen: Klicke Genehmigen, um die Authentifizierung abzuschließen

Dein Token wird lokal gespeichert. Läuft es ab, wirst du beim nächsten Zugriff erneut zur Anmeldung aufgefordert.

Schritt 1: ENLYZE MCP hinzufügen

Wähle je nach Bedarf eine der folgenden Optionen, um ENLYZE MCP in Cursor hinzuzufügen:

Option A: Workspace-MCP-Server

Ein Workspace-MCP-Server ist nur in dem Projekt verfügbar, in dem er konfiguriert ist. Erstelle dazu im Projektverzeichnis eine Datei .cursor/mcp.json (falls sie noch nicht existiert). Cursor erkennt einen entfernten Server automatisch anhand der url, ein type-Feld ist daher nicht nötig:

Option B: Globaler MCP-Server

Damit ENLYZE MCP in allen Projekten verfügbar ist, öffne die Cursor-Einstellungen mit Cmd+Shift+J / Ctrl+Shift+J und wähle Tools & MCP → Home. Füge dort dieselbe Konfiguration wie in Option A hinzu (Cursor speichert sie in ~/.cursor/mcp.json).

Schritt 2: Cursor neu starten

Beende Cursor und öffne die App erneut, um die MCP-Verbindung zu laden.

Schritt 3: Authentifizierung

Beim ersten Mal, wenn dein KI-Assistent ENLYZE MCP nutzt, wird dir automatisch ein Anmelde-Bildschirm angezeigt. Folge diesen Schritten:

  1. Anmelden: Melde dich mit deinem ENLYZE-Konto an

  2. Genehmigung erteilen: Der Genehmigungsbildschirm fragt, ob dein KI-Assistent auf dein ENLYZE-Konto und dessen Produktionsdaten zugreifen darf

  3. Bestätigen: Klicke Genehmigen oder Akzeptieren, um den Zugriff zu erlauben

Dein Client speichert das OAuth2-Token nach der Genehmigung. Du musst dich nicht erneut anmelden, solange das Token gültig ist. Läuft es ab, wirst du beim nächsten Zugriff erneut zur Anmeldung aufgefordert.

Schritt 1: GitHub Copilot in VS Code aktivieren

Stelle sicher, dass du die GitHub Copilot Extension installiert hast und mit deinem GitHub-Konto angemeldet bist.

Schritt 2: ENLYZE MCP hinzufügen

Je nach VS Code Version und Copilot Agent Support:

Option A: Workspace-weite Konfiguration (.vscode/mcp.json)

Erstelle im Projektverzeichnis eine Datei .vscode/mcp.json:

Option B: Benutzerkonfiguration (mcp.json)

Führe den Befehl MCP: Open User Configuration (Cmd+Shift+P / Ctrl+Shift+P) aus, um deine Benutzer-mcp.json zu öffnen, und füge den Server in derselben Form wie in Option A hinzu:

Schritt 3: VS Code neu starten

Beende VS Code und öffne es erneut. Öffne die Copilot-Chat-Ansicht (Ctrl+Cmd+I unter macOS, Ctrl+Alt+I unter Windows/Linux). Die MCP-Tools sollten verfügbar sein.

Schritt 4: Authentifizierung

Beim ersten Mal, wenn dein KI-Assistent ENLYZE MCP nutzt, wird dir automatisch ein Anmelde-Bildschirm angezeigt. Folge diesen Schritten:

  1. Anmelden: Melde dich mit deinem ENLYZE-Konto an

  2. Genehmigung erteilen: Der Genehmigungsbildschirm fragt, ob dein KI-Assistent auf dein ENLYZE-Konto und dessen Produktionsdaten zugreifen darf

  3. Bestätigen: Klicke Genehmigen oder Akzeptieren, um den Zugriff zu erlauben

Dein Client speichert das OAuth2-Token nach der Genehmigung. Du musst dich nicht erneut anmelden, solange das Token gültig ist. Läuft es ab, wirst du beim nächsten Zugriff erneut zur Anmeldung aufgefordert.

Schritt 1: Codex CLI installieren

Stelle sicher, dass du die Codex CLI installiert hast. Siehe die Codex CLI Dokumentation für Installationsanweisungen.

Schritt 2: ENLYZE MCP hinzufügen

Führe den folgenden Befehl aus, um ENLYZE MCP zu registrieren:

Alternativ kannst du ihn auch direkt in ~/.codex/config.toml hinzufügen:

Schritt 3: Authentifizierung

Führe den Login-Befehl aus, um den OAuth2-Flow abzuschließen:

Dies öffnet ein Browser-Fenster, in dem du dich mit deinem ENLYZE-Konto anmeldest und den Zugriff gewährst. Dein Token wird lokal gespeichert. Läuft es ab, wirst du beim nächsten Zugriff erneut zur Anmeldung aufgefordert.

Jeder MCP-kompatible Client (z.B. benutzerdefinierte Anwendungen, Agentenframeworks) kann über die gleiche HTTP-Schnittstelle auf ENLYZE MCP zugreifen.

Konfiguration

Stelle sicher, dass dein Client-Framework folgende Parameter unterstützt:

  • MCP Server URL: https://app.enlyze.com/api/mcp

  • Transport: http

  • Authentication: OAuth2 (automatisch beim ersten Verbinden)

Authentifizierung

Beim ersten Mal, wenn dein Client ENLYZE MCP verbindet, wird dir automatisch ein Anmelde-Bildschirm angezeigt. Folge diesen Schritten:

  1. Anmelden: Melde dich mit deinem ENLYZE-Konto an

  2. Genehmigung erteilen: Der Genehmigungsbildschirm fragt, ob dein KI-Assistent auf dein ENLYZE-Konto und dessen Produktionsdaten zugreifen darf

  3. Bestätigen: Klicke Genehmigen oder Akzeptieren, um den Zugriff zu erlauben

Dein Client speichert das OAuth2-Token nach der Genehmigung. Du musst dich nicht erneut anmelden, solange das Token gültig ist. Läuft es ab, wirst du beim nächsten Zugriff erneut zur Anmeldung aufgefordert.

Dokumentation zur MCP Specification findest du unter Model Context Protocol.

Verbindung überprüfen

Stelle deinem KI-Assistenten eine einfache Frage, um zu bestätigen, dass ENLYZE MCP verbunden ist, zum Beispiel "Zeig mir alle Standorte". In Claude Code kannst du auch /mcp eingeben und prüfen, dass der enlyze-Server und seine Tools erscheinen. In Claude Desktop findest du verbundene Konnektoren unter Anpassen → Konnektoren.

Verfügbare Tools

ENLYZE MCP gibt deinem KI-Assistenten Zugriff auf alles, was in der ENLYZE-Plattform verfügbar ist: Maschinen, Standorte, Variablen, Zeitreihen, OEE, Stillstände, Aufträge, Produkte, Datenquellen und mehr. Die vollständige Liste der verfügbaren Operationen und Parameter findest du in der ENLYZE API-Referenz.

Verbindungsprobleme beheben

401 Unauthorized: OAuth2-Authentifizierung fehlgeschlagen

Symptom: Der Client zeigt Fehler wie "Unauthorized" oder "Authentication failed"

Ursachen:

  • OAuth2-Token ist abgelaufen

  • Genehmigung wurde nicht erteilt oder widerrufen

  • Du bist nicht angemeldet

Lösung:

  1. Versuche, ENLYZE MCP erneut zu verwenden. Du solltest zum Anmelde-Bildschirm weitergeleitet werden

  2. Stelle sicher, dass du dich mit dem richtigen ENLYZE-Konto anmeldest

  3. Genehmige den Zugriff auf dem Consent-Screen

  4. Falls der Fehler weiterhin auftritt, starte deinen KI-Assistenten neu und versuche erneut

Verbindung verweigert: Server ist nicht erreichbar

Symptom: Der Client zeigt "Connection refused" oder "Network error"

Ursachen:

  • Keine Internetverbindung

  • Die URL https://app.enlyze.com/api/mcp ist falsch eingegeben

  • Der ENLYZE-Server ist temporär nicht erreichbar

Lösung:

  1. Überprüfe deine Internetverbindung

  2. Stelle sicher, dass die URL exakt https://app.enlyze.com/api/mcp (mit https:// und ohne Slash am Ende) ist

  3. Versuche, die URL in deinem Browser zu öffnen. Du solltest eine HTTP 401 oder 405 Antwort erhalten (das ist normal, zeigt aber, dass der Server erreichbar ist)

Tools sind nicht sichtbar: MCP-Server wird nicht geladen

Symptom: Der Client zeigt keine verfügbaren Tools oder die ENLYZE-Tools tauchen nicht auf

Ursachen:

  • Der Client wurde nicht neu gestartet nach der Konfiguration

  • Die Konfigurationsdatei hat Syntax-Fehler (ungültiges JSON)

  • Der Client unterstützt MCP nicht (ältere Version)

Lösung:

  1. Beende deinen KI-Assistenten komplett (nicht nur minimieren) und öffne ihn erneut

  2. Überprüfe die Konfigurationsdatei auf JSON-Fehler. Nutze einen Online-JSON-Validator

  3. Stelle sicher, dass der Server-Eintrag mit den Anweisungen im Tab für deinen Client übereinstimmt

  4. Falls der Client MCP nicht unterstützt, upgrade auf die neueste Version oder nutze einen anderen Client

Timeout: Abfrage dauert zu lange

Symptom: Der Chat friert ein oder zeigt "Request timeout"

Ursachen:

  • Die Abfrage ist zu komplex oder umfasst zu viele Daten

  • Das Netzwerk ist langsam

  • Der Server ist überlastet

Lösung:

  1. Versuche eine einfachere Abfrage zuerst, z.B. "Zeig mir alle Standorte"

  2. Begrenze Datenbereiche mit Datumswerten, z.B. "Zeig mir Daten von heute"

  3. Überprüfe deine Netzwerkverbindung

  4. Falls Timeouts regelmäßig auftreten, kontaktiere https://github.com/enlyze/enlyze-docs/blob/main/de/support/README.md

Zuletzt aktualisiert