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

# ENLYZE MCP einrichten

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.

{% tabs %}
{% tab title="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.

<figure><img src="/files/2rD5tcIqMeOGFnNVErov" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
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.
{% endhint %}

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

{% hint style="success" %}
Claude Desktop ist jetzt verbunden und lädt die verfügbaren Tools beim nächsten Chat.
{% endhint %}

#### 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`](https://www.npmjs.com/package/mcp-remote) (benötigt Node.js):

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

{% endtab %}

{% tab title="Claude Code" %}

### Schritt 1: ENLYZE MCP hinzufügen

Führe den folgenden Befehl in deinem Terminal aus:

```bash
claude mcp add enlyze --transport=http https://app.enlyze.com/api/mcp
```

### Schritt 2: Claude Code starten und authentifizieren

Öffne Claude Code:

```bash
claude
```

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.

{% hint style="success" %}
Claude Code ist jetzt verbunden. Verwende `/mcp` in deiner nächsten Sitzung, um die ENLYZE-Tools zu sehen.
{% endhint %}
{% endtab %}

{% tab title="Cursor" %}

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

```json
{
  "mcpServers": {
    "enlyze": {
      "url": "https://app.enlyze.com/api/mcp"
    }
  }
}
```

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

{% hint style="success" %}
Cursor ist jetzt verbunden. Die verfügbaren Tools sollten im nächsten Chat-Fenster sichtbar sein.
{% endhint %}
{% endtab %}

{% tab title="VS Code" %}

### 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`:

```json
{
  "servers": {
    "enlyze": {
      "type": "http",
      "url": "https://app.enlyze.com/api/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "enlyze": {
      "type": "http",
      "url": "https://app.enlyze.com/api/mcp"
    }
  }
}
```

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

{% hint style="success" %}
VS Code Copilot ist jetzt mit ENLYZE verbunden.
{% endhint %}
{% endtab %}

{% tab title="Codex" %}

### Schritt 1: Codex CLI installieren

Stelle sicher, dass du die Codex CLI installiert hast. Siehe die [Codex CLI Dokumentation](https://learn.chatgpt.com/docs/codex/cli) für Installationsanweisungen.

### Schritt 2: ENLYZE MCP hinzufügen

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

```bash
codex mcp add enlyze --url https://app.enlyze.com/api/mcp
```

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

```toml
[mcp_servers.enlyze]
url = "https://app.enlyze.com/api/mcp"
```

### Schritt 3: Authentifizierung

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

```bash
codex mcp login enlyze
```

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.

{% hint style="success" %}
Codex ist jetzt verbunden. Die ENLYZE-Tools sind in deiner nächsten Codex-Sitzung verfügbar.
{% endhint %}
{% endtab %}

{% tab title="Andere MCP-Clients" %}
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](https://modelcontextprotocol.io/).

{% hint style="success" %}
Dein MCP-Client ist jetzt mit ENLYZE verbunden.
{% endhint %}
{% endtab %}
{% endtabs %}

## Ü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](https://app.enlyze.com/api/v2/docs).

## Verbindungsprobleme beheben

<details>

<summary><strong>401 Unauthorized: OAuth2-Authentifizierung fehlgeschlagen</strong></summary>

**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

</details>

<details>

<summary><strong>Verbindung verweigert: Server ist nicht erreichbar</strong></summary>

**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](https://github.com/enlyze/enlyze-docs/blob/main/de/support/README.md "mention")

</details>

<details>

<summary><strong>Tools sind nicht sichtbar: MCP-Server wird nicht geladen</strong></summary>

**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

</details>

<details>

<summary><strong>Timeout: Abfrage dauert zu lange</strong></summary>

**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](https://github.com/enlyze/enlyze-docs/blob/main/de/support/README.md "mention")

</details>