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

Claude Desktop

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:

https://app.enlyze.com/api/mcp

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.

Claude Desktop ist jetzt verbunden und lädt die verfügbaren Tools beim nächsten Chat.

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

{
  "mcpServers": {
    "enlyze": {
      "command": "npx",
      "args": ["mcp-remote", "https://app.enlyze.com/api/mcp"]
    }
  }
}

Claude Code

Cursor

VS Code

Codex

Andere MCP-Clients

Überprüfen, ob es funktioniert

Stelle deinem KI-Assistenten eine einfache Frage, um zu prüfen, ob ENLYZE MCP verbunden ist, z.B. "Zeig mir alle Standorte". In Claude Code kannst du zusätzlich /mcp eingeben und bestätigen, dass der enlyze-Server und seine Tools aufgelistet werden. In Claude Desktop findest du die verbundenen Connectors unter Customize → Connectors.

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)

4. Falls der Server offline ist, kontaktiere https://github.com/enlyze/enlyze-docs/blob/main/de/support/README.md

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