> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Iru MCP

> Verbinden Sie Cursor, Claude Desktop, OpenAI Codex oder andere MCP-Clients mit der Enterprise API von Iru, indem Sie MCP-fähige Token erstellen, die auf Ihren Tenant beschränkt sind.

### Einführung

Das **Model Context Protocol (MCP)** ist ein offener Standard für die Verbindung von Clientanwendungen (**Hosts**) mit **MCP-Servern**. Server stellen Tools, Ressourcen und Prompts bereit, damit KI-Assistenten zulässige Aktionen in Ihrer Umgebung nach einem einheitlichen Muster ausführen können, anstatt für jeden Assistenten oder Workflow eine eigene benutzerdefinierte Integration zu erstellen und zu pflegen.

Der **Iru Model Context Protocol (MCP)-Server** stellt die **Enterprise API** von Iru in Form von MCP-Tools für KI-Assistenten bereit. Verbinden Sie Cursor, Claude Desktop, OpenAI Codex oder andere MCP-fähige Clients, um in natürlicher Sprache Geräte, Blueprints und Library Items abzufragen und zulässige Aktionen auszuführen, ohne eine eigene Iru-API-Integration zu entwickeln. Sie können die Tools von Iru auch mit Tools anderer Anbieter kombinieren (z. B. Ticketing, Chat oder IAM), um durchgängige, in natürlicher Sprache orchestrierte Workflows zu erstellen. Wenn Iru weitere Funktionen der Enterprise API hinzufügt, stehen diese über MCP mit demselben Berechtigungsmodell zur Verfügung.

<Note>
  Die Enterprise API (und das darauf basierende MCP) gilt für alle Iru-Bereiche, die diese API bereitstellen, einschließlich Endpoint und anderer Produkte wie Schwachstellenmanagement und Endpoint Detection and Response, abhängig von Ihrem Tenant und Ihren Berechtigungen.
</Note>

Informationen zur REST-Nutzung (HTTP-APIs und Bearer-Token außerhalb von MCP) finden Sie in der [Iru API-Übersicht](/en/endpoint/api/iru-api-overview).

### Bevor Sie beginnen

* Sie benötigen ein Iru-Administratorkonto mit der Berechtigung, **API-Token** unter **Zugriff** zu erstellen und zu verwalten, wie in der [Iru API-Übersicht](/en/endpoint/api/iru-api-overview) beschrieben.
* Sie benötigen einen **unterstützten MCP-Client** (z. B. Claude Desktop, Cursor oder Codex).

### API-Token mit MCP erstellen

Die vollständige Anleitung zur Benutzeroberfläche (Screenshots, **Copy Token**, **Weiter**, **Konfigurieren** / **Skip**, Berechtigungsraster) finden Sie unter **[API-Token generieren](/en/endpoint/api/iru-api-overview#generate-an-api-token)** in der [Iru API-Übersicht](/en/endpoint/api/iru-api-overview). Die Schritte hier entsprechen diesem Artikel; Sie müssen **Enable MCP** vor **Erstellen** aktivieren, damit Iru eine MCP-Konfiguration für dieses Token ausstellt.

<Steps>
  <Step title="Zugriff öffnen">
    Wählen Sie in der Seitenleiste die [**Schaltfläche Kontomenü**](/de/iru/platform-overview/account-menu) und dann **Zugriff** aus.
  </Step>

  <Step title="Registerkarte API-Token öffnen">
    Wählen Sie unter **Zugriff** die Registerkarte **API-Token** aus.
  </Step>

  <Step title="Neues API-Token erstellen">
    Wählen Sie **Add Token**, um ein neues API-Token zu erstellen.
  </Step>

  <Step title="Token-Details konfigurieren">
    Geben Sie einen **Name** und eine **Beschreibung** für Ihr API-Token an.
  </Step>

  <Step title="MCP aktivieren">
    Aktivieren Sie **Enable MCP**, bevor Sie **Erstellen** auswählen. Für MCP ist dieser Schritt erforderlich; wenn **Enable MCP** deaktiviert ist, erhalten Sie ein Enterprise API-Token ohne MCP-Zugriff oder MCP-Konfiguration.
  </Step>

  <Step title="Token erstellen">
    Wählen Sie **Erstellen** aus.
  </Step>
</Steps>

<Note>
  **API-Ratenbegrenzungen:** Die Iru Endpoint Management API erzwingt **10.000 Anfragen pro Stunde pro Kunde**. MCP-Aufrufe authentifizieren sich mit dem Wert **`X-API-Key`** unter **`headers`** in der **MCP-Konfiguration** für dieses Token und werden auf **dasselbe stündliche Tenant-Limit** angerechnet wie die direkte REST-Nutzung und andere Integrationen. **Alle API-Token in Ihrem Tenant teilen sich dieses Limit.** Hintergrundinformationen und Fehlerbehebung finden Sie unter [Hinweise](/en/endpoint/api/iru-api-overview#considerations) in der Iru API-Übersicht und in der [Dokumentation zur Iru Endpoint Management API](https://api-docs.kandji.io/).
</Note>

### Token und MCP-Konfiguration kopieren

Nachdem Sie das Token erstellt haben, zeigt Iru einmalig einen Erfolgsbildschirm an: **Ihr Token wurde erfolgreich erstellt!** Kopieren Sie, was Sie benötigen, bewahren Sie es sicher auf und denken Sie daran, dass Sie es nicht noch einmal sehen werden. Führen Sie die folgenden Schritte der Reihe nach aus; **MCP-Konfiguration** bezeichnet das JSON aus **Copy MCP-Konfiguration** in Schritt 2.

<Steps>
  <Step title="API-Token kopieren (optional für API-Nutzung ohne MCP)">
    Für REST oder benutzerdefinierte Skripte verwenden Sie **Kopieren** neben dem **API token** auf dem Erfolgsbildschirm. Dieser Wert wird für MCP nicht verwendet.
  </Step>

  <Step title="MCP-Konfiguration kopieren">
    Prüfen Sie unter **MCP-Konfiguration** das JSON und verwenden Sie dann **Copy MCP-Konfiguration**. Das Snippet von Iru basiert auf **`url`**, **`type`** und **`headers`**:

    * **URL**: das Feld **`url`** (der MCP-Endpunkt, den Iru Ihnen bereitstellt).
    * **X-API-Key**: der Eintrag **`X-API-Key`** in **`headers`**. Kopieren Sie ihn genau so, wie Iru ihn anzeigt, einschließlich des bereits im Snippet enthaltenen Präfixes **`sk_live:`**; MCP-Clients senden ihn bei jeder Anfrage als HTTP-Header **`X-API-Key`**.
    * **X-MCP-Profile**: der Eintrag **`X-MCP-Profile`** in **`headers`**, der als HTTP-Header **`X-MCP-Profile`** gesendet wird.

    <Note>
      **Copy MCP-Konfiguration** liefert das JSON für MCP. Verwenden Sie die Werte aus **`headers`** genau so, wie Iru sie anzeigt. Der Wert **`X-API-Key`** enthält das bereits im Snippet vorhandene Präfix **`sk_live:`**.
    </Note>

    Nur ein Platzhalterbeispiel:

    ```json mcp.json lines theme={null}
    {
      "mcpServers": {
        "iru": {
          "url": "https://YOUR_TENANT.connect.iru.com/mcp-server/connector/kandji/tools",
          "type": "http",
          "headers": {
            "X-API-Key": "sk_live:YOUR_API_KEY",
            "X-MCP-Profile": "YOUR_PROFILE_ID"
          }
        }
      }
    }
    ```
  </Step>

  <Step title="Bestätigungskontrollkästchen aktivieren">
    Aktivieren Sie das Bestätigungskontrollkästchen: **I have copied the token and MCP-Konfiguration and understand that I will not be able to see these details again.**
  </Step>

  <Step title="Next auswählen">
    Wählen Sie **Weiter** aus.
  </Step>
</Steps>

<Note>
  Wenn Sie das Token oder die Konfiguration verlieren, **widerrufen** Sie das Token und **erstellen Sie ein neues**.
</Note>

### API-Berechtigungen konfigurieren

Nachdem Sie **Weiter** ausgewählt haben, wird der Bildschirm **Manage API Permissions** angezeigt. Diese Berechtigungen steuern, auf welche Endpunkte der Enterprise API das MCP zugreifen kann.

<Steps>
  <Step title="Jetzt konfigurieren oder überspringen">
    Wählen Sie eine der folgenden Optionen:

    * **Konfigurieren**, um die Berechtigungen jetzt festzulegen (empfohlen).
    * **Skip**, um die Berechtigungen später festzulegen.
  </Step>

  <Step title="Endpunkte auswählen (wenn Sie Configure gewählt haben)">
    Wenn Sie **Konfigurieren** gewählt haben, legen Sie in der Berechtigungsliste fest, was dieses Token tun darf:

    * Erweitern Sie eine Kategorie (z. B. **Blueprints**), um einzelne Endpunkte anzuzeigen.
    * Aktivieren Sie die Kontrollkästchen für die Endpunkte, die Sie zulassen möchten.
  </Step>

  <Step title="Speichern">
    Wenn Sie fertig sind, wählen Sie **Speichern** aus.
  </Step>

  <Step title="Überprüfen">
    Überprüfen Sie, ob das Token **MCP enabled: Yes** anzeigt, wenn Sie MCP bei der Erstellung aktiviert haben, und ob die ausgewählten Berechtigungen aktiviert sind.
  </Step>

  <Step title="Berechtigungen später konfigurieren (wenn Sie übersprungen haben)">
    Wenn Sie die Einrichtung der Berechtigungen übersprungen haben, können Sie die Berechtigungen später konfigurieren, indem Sie das Token öffnen, **Bearbeiten** wählen, die Berechtigungen auswählen und **Speichern** wählen.
  </Step>
</Steps>

### API-Token widerrufen

Widerrufen Sie das Token unter **Zugriff** wie jedes andere API-Token. Die Schritte und Hinweise zu **Aktivität** finden Sie unter **[Token widerrufen](/en/endpoint/api/iru-api-overview#revoke-a-token)** in der [Iru API-Übersicht](/en/endpoint/api/iru-api-overview).

### Hinweise

<AccordionGroup>
  <Accordion title="Einmalige Anzeige der Geheimnisse">
    Das REST-API-Token aus **Kopieren** und das JSON der **MCP-Konfiguration** werden bei der Erstellung jeweils nur einmal auf dem Erfolgsbildschirm angezeigt.
  </Accordion>

  <Accordion title="Widerruf ist vollständig">
    Durch das Widerrufen des Tokens wird der darauf basierende API- und MCP-Zugriff beendet.
  </Accordion>

  <Accordion title="Destruktive Aktionen">
    Bei destruktiven Vorgängen (z. B. Löschen, Entfernen, Sperren) sollte Ihr Assistent die Auswirkungen zusammenfassen und vor der Ausführung Ihre ausdrückliche Zustimmung einholen, es sei denn, Sie haben diese Aktion für das MCP in eine Zulassungsliste aufgenommen. Befolgen Sie die Change-Management-Regeln Ihrer Organisation.
  </Accordion>

  <Accordion title="Paginierung">
    Umfangreiche Listenantworten werden paginiert. Bitten Sie den Assistenten, Filter zu verfeinern, zur nächsten Seite zu wechseln oder einen Export durchzuführen, wenn Sie den vollständigen Datensatz benötigen, ohne jede Zeile in den Chat zu laden.
  </Accordion>

  <Accordion title="Clientspezifische Konfiguration">
    Die **MCP-Konfiguration** ist JSON mit **`url`**, **`type`** und **`headers`**. **`headers`** enthält **`X-API-Key`** und **`X-MCP-Profile`**, die Iru gemeinsam bei jeder MCP-Anfrage erwartet. Richten Sie Ihren Client auf **`url`** aus und leiten Sie diese beiden Header-Werte unverändert weiter. Der Wert **`X-API-Key`** enthält das bereits im Snippet vorhandene Präfix **`sk_live:`**.
  </Accordion>
</AccordionGroup>

### Best Practices

<CardGroup cols={2}>
  <Card title="Prinzip der geringsten Rechte anwenden" icon="shield-halved">
    Erstellen Sie ein Token nur mit den Enterprise API-Bereichen, die Ihre Automatisierung benötigt, und aktivieren Sie dann MCP für dieses Token.
  </Card>

  <Card title="Token nach Team oder Anwendungsfall trennen" icon="layer-group">
    Verwenden Sie beispielsweise ein lesendes Token für Berichtsassistenten und ein enger gefasstes operatives Token für Behebungs-Workflows.
  </Card>

  <Card title="Bei Verdacht rotieren" icon="arrows-rotate">
    Wenn die **MCP-Konfiguration** offengelegt wurde, widerrufen Sie das Token in Iru und stellen Sie ein neues aus; aktualisieren Sie jeden MCP-Client, der noch die alten Werte für **`url`** oder **`headers`** hat.
  </Card>

  <Card title="Lokale Konfigurationsdateien schützen" icon="terminal">
    **`claude_desktop_config.json`** enthält Ihre **`url`** und Header-Werte. Committen Sie die Datei nicht in die Versionskontrolle und teilen Sie sie nicht in Chatprotokollen.
  </Card>

  <Card title="MCP- und API-Geheimnisse schützen" icon="lock">
    Behandeln Sie die **MCP-Konfiguration** und jedes REST-Token, das Sie für die Nutzung ohne MCP mit **Kopieren** kopieren, als Geheimnisse. Speichern Sie sie in einem Passwort-Manager oder einem sicheren Tresor, nicht in Chatprotokollen oder Screenshots.
  </Card>
</CardGroup>

### Iru MCP zu Ihrem MCP-Client hinzufügen

Wählen Sie einen Client und folgen Sie dann den Schritten für diesen Host.

<Tabs>
  <Tab title="Claude Desktop" icon="desktop" iconType="solid">
    ### Iru MCP zu Claude Desktop hinzufügen

    **Claude Desktop** ist die Desktop-App von Anthropic zum Chatten mit Claude. Registrieren Sie Iru, indem Sie **`claude_desktop_config.json`** mit den Werten für **`url`** und **`headers`** aus Ihrer **MCP-Konfiguration** bearbeiten.

    ### Voraussetzungen

    * Schließen Sie in Iru [Token und MCP-Konfiguration kopieren](#copy-your-token-and-mcp-configuration) ab, damit Sie **`url`** und **`headers`** (**`X-API-Key`**, **`X-MCP-Profile`**) haben.
    * Installieren Sie **Node.js 20+** von [nodejs.org](https://nodejs.org/). Das Installationsprogramm enthält **`npx`**, das Claude Desktop zum Ausführen der Iru MCP-Verbindung verwendet.

    <Note>
      Verwenden Sie **`mcp-remote@latest`** in **`args`**, damit Claude Desktop das aktuelle **mcp-remote**-Paket ausführt. Wenn die MCP-Verbindung mit **`latest`** fehlschlägt, legen Sie vorübergehend eine frühere Version fest (z. B. **`mcp-remote@0.1.13`**). Wenn dieser Fehler auftritt, liegt das Problem bei **mcp-remote**, nicht bei Iru.
    </Note>

    <Tabs>
      <Tab title="macOS" icon="apple" iconType="brands">
        <Steps>
          <Step title="Claude Desktop herunterladen und installieren">
            Laden Sie Claude Desktop für macOS herunter, installieren Sie die App und melden Sie sich an: [Download Claude](https://claude.com/download).
          </Step>

          <Step title="Einstellungen von Claude Desktop öffnen">
            Öffnen Sie Claude Desktop und wählen Sie in der Menüleiste **Claude → Settings** aus.
          </Step>

          <Step title="Developer-Einstellungen öffnen">
            Wählen Sie unter **Einstellungen** **Developer** aus.
          </Step>

          <Step title="Konfigurationsdatei öffnen">
            Wählen Sie unter **Developer** **Edit Config** aus. Claude Desktop öffnet den Konfigurationsordner im **Finder**.
          </Step>

          <Step title="claude_desktop_config.json öffnen">
            Öffnen Sie **`claude_desktop_config.json`** aus diesem Ordner in einem Texteditor Ihrer Wahl.

            <Note>
              Eine neue Datei zeigt möglicherweise **`{}`** an. Eine vorhandene Datei kann bereits **`mcpServers`**, **`preferences`** oder andere Einstellungen enthalten. Fügen Sie in diesem Fall nur den Block **`"iru"`** innerhalb von **`mcpServers`** hinzu und lassen Sie den Rest unverändert. Fügen Sie nach der schließenden **`}`** von **`mcpServers`** ein Komma vor dem nächsten Abschnitt der obersten Ebene ein (z. B. **`"preferences"`**).
            </Note>
          </Step>

          <Step title="Iru MCP-Servereintrag hinzufügen">
            Fügen Sie Folgendes in **`claude_desktop_config.json`** ein. In den drei hervorgehobenen Zeilen tragen Sie Ihre Werte aus der **MCP-Konfiguration** ein. Tragen Sie Ihren **`X-API-Key`** und Ihr **`X-MCP-Profile`** unter **`env`** ein; beim Start von Claude Desktop verwendet **`mcp-remote`** diese Werte für die Platzhalter **`${IRU_X_API_KEY}`** und **`${IRU_X_MCP_PROFILE}`** in **`args`**.

            ```json claude_desktop_config.json lines highlight={8,15,16} theme={null}
            {
              "mcpServers": {
                "iru": {
                  "command": "npx",
                  "args": [
                    "-y",
                    "mcp-remote@latest",
                    "https://YOUR_TENANT.connect.iru.com/mcp-server/connector/kandji/tools",
                    "--header",
                    "X-API-Key:${IRU_X_API_KEY}",
                    "--header",
                    "X-MCP-Profile:${IRU_X_MCP_PROFILE}"
                  ],
                  "env": {
                    "IRU_X_API_KEY": "sk_live:YOUR_API_KEY",
                    "IRU_X_MCP_PROFILE": "YOUR_PROFILE_ID"
                  }
                }
              }
            }
            ```

            Ersetzen Sie die hervorgehobenen Platzhalter:

            * **`https://YOUR_TENANT.connect.iru.com/mcp-server/connector/kandji/tools`** durch **`url`** aus der **MCP-Konfiguration**
            * **`sk_live:YOUR_API_KEY`** durch **`X-API-Key`** aus der **MCP-Konfiguration**
            * **`YOUR_PROFILE_ID`** durch **`X-MCP-Profile`** aus der **MCP-Konfiguration**
          </Step>

          <Step title="In eine vorhandene Datei einfügen">
            Überspringen Sie diesen Schritt, wenn Sie mit einer leeren Datei begonnen haben. Wenn **`preferences`** oder andere Einstellungen bereits unterhalb von **`mcpServers`** stehen, sollte Ihre Datei die Abschnitte wie folgt verbinden. Die hervorgehobene Zeile ist das Komma zwischen **`mcpServers`** und dem nächsten Schlüssel der obersten Ebene:

            ```json claude_desktop_config.json lines highlight={4} theme={null}
                    "IRU_X_MCP_PROFILE": "YOUR_PROFILE_ID"
                  }
                }
              },
              "preferences": {
                "remoteToolsDeviceName": "your-device-name",
                "coworkWebSearchEnabled": true
              }
            }
            ```
          </Step>

          <Step title="Datei speichern und Claude Desktop neu starten">
            Speichern Sie **`claude_desktop_config.json`** und beenden Sie Claude Desktop vollständig. Das Schließen des Fensters reicht nicht aus; wählen Sie in der Menüleiste **Claude → Quit Claude** und starten Sie Claude Desktop dann neu.

            Claude Desktop lädt die MCP-Konfiguration beim Start.
          </Step>

          <Step title="Verbindung überprüfen">
            Nachdem Claude Desktop wieder geöffnet ist, starten Sie einen **neuen Chat** und fragen Sie:

            ```text theme={null}
            List my Iru devices
            ```

            Wenn die Verbindung funktioniert, ruft Claude den Iru MCP-Server auf und gibt eine Liste Ihrer registrierten Geräte zurück. Wenn ein Fehler angezeigt wird, lesen Sie unten [Fehlerbehebung](#troubleshooting).
          </Step>

          <Step title="Zugriff bei Aufforderung genehmigen">
            Claude fragt vor jeder Nutzung eines Iru MCP-Tools nach. Wählen Sie **Allow once** nur für diesen Durchlauf oder **Always allow**, wenn Sie bei ähnlichen Aktionen weniger Abfragen wünschen. Genehmigen Sie, wenn Sie Lesevorgänge oder zulässige Änderungen in Iru wünschen; lehnen Sie ab, wenn das Tool nicht ausgeführt werden soll.
          </Step>

          <Step title="Wenn weiterhin etwas fehlschlägt">
            Öffnen Sie in Claude Desktop **Settings → Developer**, um den Eintrag **`iru`**, den Ausführungsstatus des Servers und alle vom Host gemeldeten Fehler zu prüfen. Siehe unten [Fehlerbehebung](#troubleshooting).
          </Step>
        </Steps>
      </Tab>

      <Tab title="Windows" icon="microsoft" iconType="brands">
        <Steps>
          <Step title="Claude Desktop herunterladen und installieren">
            Laden Sie Claude Desktop für Windows herunter, installieren Sie die App und melden Sie sich an: [Download Claude](https://claude.com/download).
          </Step>

          <Step title="Einstellungen von Claude Desktop öffnen">
            Öffnen Sie Claude Desktop und wählen Sie das Hamburger-Menü, **File** und dann **Einstellungen** aus.
          </Step>

          <Step title="Developer-Einstellungen öffnen">
            Wählen Sie unter **Einstellungen** **Developer** aus.
          </Step>

          <Step title="Konfigurationsdatei öffnen">
            Wählen Sie unter **Developer** **Edit Config** aus. Claude Desktop öffnet den Konfigurationsordner im **Datei-Explorer**.
          </Step>

          <Step title="claude_desktop_config.json öffnen">
            Öffnen Sie **`claude_desktop_config.json`** aus diesem Ordner in einem Texteditor Ihrer Wahl.

            <Note>
              Eine neue Datei zeigt möglicherweise **`{}`** an. Eine vorhandene Datei kann bereits **`mcpServers`**, **`preferences`** oder andere Einstellungen enthalten. Fügen Sie in diesem Fall nur den Block **`"iru"`** innerhalb von **`mcpServers`** hinzu und lassen Sie den Rest unverändert. Fügen Sie nach der schließenden **`}`** von **`mcpServers`** ein Komma vor dem nächsten Abschnitt der obersten Ebene ein (z. B. **`"preferences"`**).
            </Note>
          </Step>

          <Step title="Iru MCP-Servereintrag hinzufügen">
            Fügen Sie Folgendes in **`claude_desktop_config.json`** ein. In den drei hervorgehobenen Zeilen tragen Sie Ihre Werte aus der **MCP-Konfiguration** ein. Tragen Sie Ihren **`X-API-Key`** und Ihr **`X-MCP-Profile`** unter **`env`** ein; beim Start von Claude Desktop verwendet **`mcp-remote`** diese Werte für die Platzhalter **`${IRU_X_API_KEY}`** und **`${IRU_X_MCP_PROFILE}`** in **`args`**.

            ```json claude_desktop_config.json lines highlight={8,15,16} theme={null}
            {
              "mcpServers": {
                "iru": {
                  "command": "C:\\Program Files\\nodejs\\npx.cmd",
                  "args": [
                    "-y",
                    "mcp-remote@latest",
                    "https://YOUR_TENANT.connect.iru.com/mcp-server/connector/kandji/tools",
                    "--header",
                    "X-API-Key:${IRU_X_API_KEY}",
                    "--header",
                    "X-MCP-Profile:${IRU_X_MCP_PROFILE}"
                  ],
                  "env": {
                    "IRU_X_API_KEY": "sk_live:YOUR_API_KEY",
                    "IRU_X_MCP_PROFILE": "YOUR_PROFILE_ID"
                  }
                }
              }
            }
            ```

            Ersetzen Sie die hervorgehobenen Platzhalter:

            * **`https://YOUR_TENANT.connect.iru.com/mcp-server/connector/kandji/tools`** durch **`url`** aus der **MCP-Konfiguration**
            * **`sk_live:YOUR_API_KEY`** durch **`X-API-Key`** aus der **MCP-Konfiguration**
            * **`YOUR_PROFILE_ID`** durch **`X-MCP-Profile`** aus der **MCP-Konfiguration**
          </Step>

          <Step title="In eine vorhandene Datei einfügen">
            Überspringen Sie diesen Schritt, wenn Sie mit einer leeren Datei begonnen haben. Wenn **`preferences`** oder andere Einstellungen bereits unterhalb von **`mcpServers`** stehen, sollte Ihre Datei die Abschnitte wie folgt verbinden. Die hervorgehobene Zeile ist das Komma zwischen **`mcpServers`** und dem nächsten Schlüssel der obersten Ebene:

            ```json claude_desktop_config.json lines highlight={4} theme={null}
                    "IRU_X_MCP_PROFILE": "YOUR_PROFILE_ID"
                  }
                }
              },
              "preferences": {
                "remoteToolsDeviceName": "your-device-name",
                "coworkWebSearchEnabled": true
              }
            }
            ```
          </Step>

          <Step title="Datei speichern und Claude Desktop neu starten">
            Speichern Sie **`claude_desktop_config.json`** und beenden Sie Claude Desktop vollständig. Das Schließen des Fensters reicht nicht aus; klicken Sie mit der rechten Maustaste auf das **Claude**-Symbol in der Taskleiste, wählen Sie **Quit** und starten Sie Claude Desktop dann neu.

            Claude Desktop lädt die MCP-Konfiguration beim Start.
          </Step>

          <Step title="Verbindung überprüfen">
            Nachdem Claude Desktop wieder geöffnet ist, starten Sie einen **neuen Chat** und fragen Sie:

            ```text theme={null}
            List my Iru devices
            ```

            Wenn die Verbindung funktioniert, ruft Claude den Iru MCP-Server auf und gibt eine Liste Ihrer registrierten Geräte zurück. Wenn ein Fehler angezeigt wird, lesen Sie unten [Fehlerbehebung](#troubleshooting).
          </Step>

          <Step title="Zugriff bei Aufforderung genehmigen">
            Claude fragt vor jeder Nutzung eines Iru MCP-Tools nach. Wählen Sie **Allow once** nur für diesen Durchlauf oder **Always allow**, wenn Sie bei ähnlichen Aktionen weniger Abfragen wünschen. Genehmigen Sie, wenn Sie Lesevorgänge oder zulässige Änderungen in Iru wünschen; lehnen Sie ab, wenn das Tool nicht ausgeführt werden soll.
          </Step>

          <Step title="Wenn weiterhin etwas fehlschlägt">
            Öffnen Sie in Claude Desktop **Settings → Developer**, um den Eintrag **`iru`**, den Ausführungsstatus des Servers und alle vom Host gemeldeten Fehler zu prüfen. Wenn der MCP-Server läuft, schreibt Claude möglicherweise auch **`logs\mcp-server-iru.log`** neben **`claude_desktop_config.json`** in den App-Datenordner von Claude Desktop für Ihre Installation. Siehe unten [Fehlerbehebung](#troubleshooting).
          </Step>
        </Steps>
      </Tab>
    </Tabs>
  </Tab>

  <Tab title="Cursor" icon="i-cursor" iconType="solid">
    ### Iru MCP zu Cursor hinzufügen

    **Cursor** ist ein KI-nativer Code-Editor zum Schreiben und Bearbeiten von Software mit integrierter Unterstützung. Die Cursor-Desktop-App ist für **macOS**, **Windows** und **Linux** verfügbar. Fügen Sie Iru unter **Tools & MCP** hinzu, damit Sie die Tools Ihres Tenants im Editor verwenden können.

    <Steps>
      <Step title="Werte aus Iru vorbereiten">
        Schließen Sie in Iru [Token und MCP-Konfiguration kopieren](#copy-your-token-and-mcp-configuration) ab, damit Sie **`url`** und **`headers`** (**`X-API-Key`**, **`X-MCP-Profile`**) haben.
      </Step>

      <Step title="Cursor herunterladen und installieren">
        Laden Sie Cursor für Ihre Plattform herunter, installieren Sie die App und melden Sie sich an: [Download Cursor](https://cursor.com/download).
      </Step>

      <Step title="MCP-Einstellungen öffnen">
        Öffnen Sie die Cursor-**MCP Settings**:

        * **macOS:** **Cursor → Settings → Cursor Settings**, dann **Tools & MCP**.
        * **Windows/Linux:** **File → Preferences → Cursor Settings**, dann **Tools & MCP**.
      </Step>

      <Step title="Benutzerdefiniertes MCP hinzufügen">
        Wählen Sie **Add Custom MCP** aus.
      </Step>

      <Step title="MCP-Konfiguration einfügen">
        Die Datei **`mcp.json`** wird im Editor geöffnet. Wie Sie einfügen, hängt davon ab, ob bereits andere MCP-Server definiert sind. Cursor beginnt mit einem Platzhalter wie diesem:

        ```json mcp.json lines theme={null}
        {
          "mcpServers": {}
        }
        ```

        <AccordionGroup>
          <Accordion title="Neue Einrichtung">
            Ersetzen Sie den **gesamten** Inhalt von **`mcp.json`** durch die vollständige **MCP-Konfiguration**, die Sie beim Erstellen des Tokens unter [MCP-Konfiguration kopieren](#copy-your-token-and-mcp-configuration) kopiert haben. Markieren Sie alles in der Datei (einschließlich des Platzhalters von Cursor), fügen Sie ein und belassen Sie **nur** das JSON von Iru in **`mcp.json`**. Entfernen Sie nicht das Präfix **`sk_live:`** aus **`X-API-Key`** in **`headers`**.
          </Accordion>

          <Accordion title="Vorhandene MCP-Server">
            Wenn **`mcpServers`** bereits andere Server enthält, die Sie behalten möchten, ersetzen Sie **nicht** die gesamte Datei **`mcp.json`**. Fügen Sie nur den Block **`iru`** aus der **MCP-Konfiguration** hinzu. Kopieren Sie von **`"iru": {`** bis zur schließenden **`}`** dieses Servers (die zweite **`}`** nach **`headers`**). Fügen Sie nach der schließenden **`}`** des Servereintrags, der unmittelbar vor **`iru`** steht, ein Komma ein. Behalten Sie **`X-API-Key`** genau so bei, wie Iru ihn anzeigt, einschließlich des bereits im Snippet enthaltenen Präfixes **`sk_live:`**.

            Beispiel, wenn bereits ein anderer Server konfiguriert ist (die hervorgehobenen Zeilen zeigen das nachgestellte Komma und den Block **`iru`**, den Sie kopieren und in die Datei **`mcp.json`** einfügen):

            ```json mcp.json lines highlight={10,11-18} theme={null}
            {
              "mcpServers": {
                "previous-mcp-server": {
                  "url": "https://example.com/mcp",
                  "type": "http",
                  "headers": {
                    "X-API-Key": "sk_live:YOUR_OTHER_KEY",
                    "X-MCP-Profile": "YOUR_OTHER_PROFILE"
                  }
                },
                "iru": {
                  "url": "https://YOUR_TENANT.connect.iru.com/mcp-server/connector/kandji/tools",
                  "type": "http",
                  "headers": {
                    "X-API-Key": "sk_live:YOUR_API_KEY",
                    "X-MCP-Profile": "YOUR_PROFILE_ID"
                  }
                }
              }
            }
            ```
          </Accordion>
        </AccordionGroup>
      </Step>

      <Step title="Konfiguration speichern">
        Cursor speichert **`mcp.json`** nach dem Einfügen nicht automatisch. Speichern Sie die Datei manuell, bevor Sie beenden oder neu starten:

        * **macOS:** **Command+S**
        * **Windows/Linux:** **Ctrl+S** oder **File → Save**
      </Step>

      <Step title="Cursor neu starten">
        **Beenden Sie Cursor vollständig** und öffnen Sie es dann erneut. Cursor lädt MCP beim Start.
      </Step>

      <Step title="Bestätigen">
        Kehren Sie zu **Tools & MCP** zurück. Bestätigen Sie, dass **`iru`** angezeigt wird und der Schalter **aktiviert** ist.
      </Step>
    </Steps>

    Weitere Informationen zur Verwendung von MCP in Cursor finden Sie unter [Model Context Protocol (MCP) in Cursor](https://cursor.com/docs/mcp).
  </Tab>

  <Tab title="OpenAI Codex" icon="openai" iconType="brands">
    ### Iru MCP zu OpenAI Codex hinzufügen

    **OpenAI Codex** ist der Coding-Agent von OpenAI zum Erstellen und Ändern von Software mit KI. Verwenden Sie die **Codex Desktop App** oder die **Codex**-Erweiterung in VS Code, um Iru als MCP-Server zu registrieren und per Chat mit Ihrem Tenant zu arbeiten.

    <Tabs>
      <Tab title="Desktop App" icon="window-maximize" iconType="solid">
        #### Codex Desktop App

        Die Codex Desktop App ist für **macOS** und **Windows** verfügbar. Informationen zur Plattformunterstützung, zu Installationsoptionen (einschließlich Builds für Intel-Macs) und zu weiteren App-Anforderungen finden Sie in der [Codex-App-Dokumentation](https://developers.openai.com/codex/app) bei OpenAI Developers.

        <Steps>
          <Step title="Werte aus Iru vorbereiten">
            Schließen Sie in Iru [Token und MCP-Konfiguration kopieren](#copy-your-token-and-mcp-configuration) ab, damit Sie **`url`** und **`headers`** (**`X-API-Key`**, **`X-MCP-Profile`**) haben.
          </Step>

          <Step title="Codex herunterladen und installieren">
            Laden Sie die Codex Desktop App herunter und installieren Sie sie: [Codex](https://chatgpt.com/codex/).
          </Step>

          <Step title="Bei Codex anmelden">
            Öffnen Sie Codex und melden Sie sich mit Ihrem ChatGPT-Konto oder einem OpenAI-API-Schlüssel an. Codex ist in berechtigten ChatGPT-Plänen enthalten. Siehe [Open Codex and sign in](https://developers.openai.com/codex/app) in der Codex-App-Dokumentation.
          </Step>

          <Step title="Einstellungen öffnen">
            Gehen Sie in Codex zu **Einstellungen**.
          </Step>

          <Step title="MCP-Server öffnen">
            Wählen Sie **MCP servers** aus.
          </Step>

          <Step title="Server hinzufügen">
            Wählen Sie **+ Add server** aus.
          </Step>

          <Step title="Name">
            Geben Sie unter **Name** **Iru MCP** ein.
          </Step>

          <Step title="Transport">
            Wählen Sie **Streamable HTTP** aus.
          </Step>

          <Step title="URL">
            Geben Sie unter **URL** den Wert **`url`** aus der **MCP-Konfiguration** ein.
          </Step>

          <Step title="Header für X-API-Key">
            Setzen Sie unter **Headers** **Key** auf **`X-API-Key`** und **Wert** auf den Eintrag **`X-API-Key`** aus **`headers`** in der **MCP-Konfiguration**, genau so kopiert, wie Iru ihn anzeigt, einschließlich des bereits im Snippet enthaltenen Präfixes **`sk_live:`**.
          </Step>

          <Step title="Header für X-MCP-Profile">
            Wählen Sie **+ Add header**. Setzen Sie **Key** auf **`X-MCP-Profile`** und **Wert** auf den Eintrag **`X-MCP-Profile`** aus **`headers`** in der **MCP-Konfiguration**.
          </Step>

          <Step title="Speichern">
            Wählen Sie **Speichern** aus.
          </Step>

          <Step title="Codex neu starten">
            Beenden Sie Codex vollständig und öffnen Sie es dann erneut, damit die MCP-Einstellungen neu geladen werden.
          </Step>

          <Step title="Iru im Chat ausprobieren">
            Starten Sie einen **neuen Chat** und stellen Sie Codex eine Frage zu einem Bereich der Enterprise API, für den Ihr Token berechtigt ist (z. B. Geräte oder Blueprints).
          </Step>
        </Steps>
      </Tab>

      <Tab title="IDE extension" icon="puzzle-piece" iconType="solid">
        #### Codex-IDE-Erweiterung

        Die **Codex-IDE-Erweiterung** führt den Coding-Agent von OpenAI in Ihrem Editor aus. Fügen Sie Iru über die MCP-Einstellungen der Erweiterung hinzu.

        <Steps>
          <Step title="Werte aus Iru vorbereiten">
            Schließen Sie in Iru [Token und MCP-Konfiguration kopieren](#copy-your-token-and-mcp-configuration) ab, damit Sie **`url`** und **`headers`** (**`X-API-Key`**, **`X-MCP-Profile`**) haben.
          </Step>

          <Step title="Visual Studio Code installieren">
            Installieren Sie bei Bedarf [Visual Studio Code](https://code.visualstudio.com/). VS Code unterstützt **macOS**, **Windows** und **Linux**.
          </Step>

          <Step title="Codex-Erweiterung installieren">
            Installieren Sie die [Codex-Erweiterung](https://marketplace.visualstudio.com/items?itemName=openai.chatgpt) aus dem Visual Studio Marketplace. Die Erweiterung funktioniert auch in anderen VS Code-kompatiblen Editoren (z. B. Cursor); Menüs und Plattformunterstützung können abweichen. Installationsoptionen finden Sie in der Dokumentation zur [Codex-IDE-Erweiterung](https://developers.openai.com/codex/ide).
          </Step>

          <Step title="Codex-Seitenleiste öffnen">
            Öffnen Sie die Codex-Seitenleiste über das <Icon icon="openai" iconType="brands" size={14} style={{ display: 'inline-flex', verticalAlign: 'middle' }} /> OpenAI-Logo in der Aktivitätsleiste, über **Open Codex Sidebar** oder indem Sie die sekundäre Seitenleiste einblenden und die Registerkarte **Codex** auswählen.
          </Step>

          <Step title="Anmelden und Einrichtung abschließen">
            Wählen Sie **Sign in with ChatGPT** und authentifizieren Sie sich. Codex ist in berechtigten ChatGPT-Plänen enthalten. Folgen Sie allen Aufforderungen, um die Einrichtung abzuschließen.
          </Step>

          <Step title="Codex-Einstellungen öffnen">
            Wählen Sie in der Codex-Seitenleiste das **Zahnrad**-Symbol und dann **Codex settings** aus.
          </Step>

          <Step title="MCP-Server öffnen">
            Wählen Sie **MCP servers** aus.
          </Step>

          <Step title="Server hinzufügen">
            Wählen Sie **+ Add server** aus.
          </Step>

          <Step title="Name">
            Geben Sie unter **Name** **Iru MCP** ein.
          </Step>

          <Step title="Transport">
            Wählen Sie **Streamable HTTP** aus.
          </Step>

          <Step title="URL">
            Geben Sie unter **URL** den Wert **`url`** aus der **MCP-Konfiguration** ein.
          </Step>

          <Step title="Header für X-API-Key">
            Setzen Sie unter **Headers** **Key** auf **`X-API-Key`** und **Wert** auf den Eintrag **`X-API-Key`** aus **`headers`** in der **MCP-Konfiguration**, genau so kopiert, wie Iru ihn anzeigt, einschließlich des bereits im Snippet enthaltenen Präfixes **`sk_live:`**.
          </Step>

          <Step title="Header für X-MCP-Profile">
            Wählen Sie **+ Add header**. Setzen Sie **Key** auf **`X-MCP-Profile`** und **Wert** auf den Eintrag **`X-MCP-Profile`** aus **`headers`** in der **MCP-Konfiguration**.
          </Step>

          <Step title="Speichern">
            Wählen Sie **Speichern** aus.
          </Step>

          <Step title="Erweiterung neu starten">
            Wenn Codex **Restart extension** anzeigt, wählen Sie diese Option, damit die MCP-Einstellungen neu geladen werden.
          </Step>

          <Step title="Iru im Chat ausprobieren">
            Starten Sie in der **Codex**-Seitenleiste eine Unterhaltung und fragen Sie nach einem Bereich der Enterprise API, für den Ihr Token berechtigt ist (z. B. Geräte oder Blueprints).
          </Step>
        </Steps>
      </Tab>
    </Tabs>
  </Tab>
</Tabs>

### Fehlerbehebung

Allgemeine Hilfe zu MCP (Speicherorte von Protokollen, Konfigurationsprüfungen, MCP Inspector und Client-Debugging über die Iru-spezifischen Hinweise unten hinaus) finden Sie im [Model Context Protocol debugging guide](https://modelcontextprotocol.io/docs/tools/debugging).

<AccordionGroup>
  <Accordion title="Allgemeines zu Iru MCP" icon="layer-group">
    <AccordionGroup>
      <Accordion title="Der Assistent meldet, dass das Token ungültig ist oder die Authentifizierung fehlgeschlagen ist" icon="key">
        Prüfen Sie **`url`** und **`headers`** (**`X-API-Key`**, **`X-MCP-Profile`**) in der **MCP-Konfiguration** erneut. Entfernen Sie überflüssige Leerzeichen. **`X-API-Key`** muss dem vollständigen Wert aus Iru entsprechen, einschließlich des bereits im Snippet enthaltenen Präfixes **`sk_live:`**. Wenn das zugrunde liegende Token rotiert oder widerrufen wurde, erstellen Sie ein neues und aktualisieren Sie jeden Client.
      </Accordion>

      <Accordion title="Tools fehlen oder der Assistent meldet eine verweigerte Berechtigung" icon="shield-halved">
        Die Enterprise API-Bereiche des Tokens können diese Vorgänge blockieren. Bearbeiten Sie die API-Berechtigungen des Tokens unter **Zugriff** oder erstellen Sie ein neues Token mit den benötigten Bereichen.
      </Accordion>

      <Accordion title="Die Konfiguration sieht in Iru korrekt aus, aber der Client schlägt weiterhin fehl" icon="arrow-rotate-right">
        Bestätigen Sie, dass die **MCP-Konfiguration** im Client mit **`url`** und **`headers`** aus Iru übereinstimmt, und beenden Sie dann die Host-App vollständig und starten Sie sie neu, damit die MCP-Einstellungen neu geladen werden. Wenn das Problem weiterhin besteht, verwenden Sie den [Model Context Protocol debugging guide](https://modelcontextprotocol.io/docs/tools/debugging) für Host-Protokolle, JSON-Validierung und Tests mit MCP Inspector.
      </Accordion>
    </AccordionGroup>
  </Accordion>

  <Accordion title="Claude Desktop" icon="desktop" iconType="solid">
    <AccordionGroup>
      <Accordion title="Remote-Connector- oder Netzwerkfehler (benutzerdefinierte MCP-URL)" icon="globe">
        Benutzerdefinierte Connectors erreichen Ihren MCP-Server über die Infrastruktur von Anthropic. Bestätigen Sie, dass **`url`** in der **MCP-Konfiguration** korrekt ist, dass der Dienst im öffentlichen Internet erreichbar ist und dass eine Unternehmens-Firewall die IP-Bereiche von Anthropic zulässt. Siehe [Erste Schritte with custom connectors using remote MCP](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) und [Anthropic IP addresses](https://platform.claude.com/docs/en/api/ip-addresses).
      </Accordion>

      <Accordion title="Eintrag iru prüfen oder Host-Fehler lesen" icon="wrench">
        Öffnen Sie in Claude Desktop **Einstellungen** und dann **Developer**. Dort können Sie die Serverkonfiguration **`iru`** prüfen, sehen, ob der Server läuft, und alle vom Host gemeldeten Fehler lesen. Informationen zu Protokollpfaden von Claude, DevTools und zugehörigen Schritten finden Sie unter **Debugging in Claude Desktop** im [Model Context Protocol debugging guide](https://modelcontextprotocol.io/docs/tools/debugging).
      </Accordion>

      <Accordion title="Das Iru MCP kann mit mcp-remote@latest keine Verbindung herstellen" icon="code-branch">
        Verwenden Sie **`mcp-remote@latest`** in **`args`**, damit Sie beim aktuellen **mcp-remote**-Paket bleiben. Wenn die Verbindung fehlschlägt, ändern Sie diesen Wert vorübergehend auf eine frühere Version (z. B. **`mcp-remote@0.1.13`**), speichern Sie **`claude_desktop_config.json`** und beenden Sie Claude Desktop vollständig, bevor Sie es erneut öffnen. Kehren Sie zu **`mcp-remote@latest`** zurück, sobald es möglich ist. Wenn dieser Fehler auftritt, liegt das Problem bei **mcp-remote**, nicht bei Iru.
      </Accordion>

      <Accordion title="stdio-Bridge (npx / mcp-remote) oder Einrichtung der Konfigurationsdatei" icon="terminal">
        Bestätigen Sie, dass **Node.js 20+** installiert ist, öffnen Sie dann **`claude_desktop_config.json`** und bestätigen Sie, dass die MCP-URL des Eintrags **`iru`** in **`args`** und die Werte in **`env`** weiterhin mit **`url`**, **`X-API-Key`** und **`X-MCP-Profile`** aus der **MCP-Konfiguration** übereinstimmen (**`IRU_X_API_KEY`** muss das Präfix **`sk_live:`** enthalten). Die Zeilen mit **`--header`** sollten weiterhin **`${IRU_X_API_KEY}`** und **`${IRU_X_MCP_PROFILE}`** verwenden, nicht Ihren eigentlichen Schlüssel oder Ihr Profil. Unter macOS sollte **`command`** **`npx`** lauten; verwenden Sie unter Windows den vollständigen Pfad **`C:\Program Files\nodejs\npx.cmd`**. Speichern Sie die Datei und **beenden Sie** Claude Desktop **vollständig** (**Claude → Quit Claude** unter macOS, **Quit** in der Taskleiste unter Windows), bevor Sie es erneut öffnen. Prüfen Sie unter Windows **`logs\mcp-server-iru.log`** neben **`claude_desktop_config.json`**, wenn **`iru`** weiterhin fehlschlägt. Siehe [Iru MCP zu Claude Desktop hinzufügen](#claude-desktop).
      </Accordion>
    </AccordionGroup>
  </Accordion>

  <Accordion title="Cursor" icon="i-cursor" iconType="solid">
    <AccordionGroup>
      <Accordion title="MCP wird nicht geladen oder iru bleibt nach dem Bearbeiten der Einstellungen deaktiviert" icon="arrow-rotate-right">
        **Beenden Sie Cursor vollständig** und öffnen Sie es dann erneut; Cursor lädt MCP beim Start. Wenn **`mcp.json`** weiterhin nicht geladen wird, prüfen Sie, ob das JSON gültig ist. Bestätigen Sie bei einer neuen Einrichtung, dass Sie die **gesamte** Datei durch die **MCP-Konfiguration** ersetzt haben; wenn Sie sie mit vorhandenen Servern zusammengeführt haben, prüfen Sie, ob der Block **`iru`** und die Kommas korrekt sind. Prüfen Sie, ob **`url`**, **`X-API-Key`** und **`X-MCP-Profile`** mit der **MCP-Konfiguration** übereinstimmen (siehe [Iru MCP zu Cursor hinzufügen](#cursor)). **`X-API-Key`** muss das bereits im Snippet enthaltene Präfix **`sk_live:`** enthalten. Bei tiefergehenden Host-Problemen lesen Sie den [Model Context Protocol debugging guide](https://modelcontextprotocol.io/docs/tools/debugging).
      </Accordion>
    </AccordionGroup>
  </Accordion>

  <Accordion title="OpenAI Codex" icon="openai" iconType="brands">
    <AccordionGroup>
      <Accordion title="Add a project to use Codex (IDE-Erweiterung)" icon="folder-open">
        Wenn Codex beim Chatten **Add a project to use Codex** anzeigt, öffnen oder erstellen Sie zuerst einen Projektordner im Editor und kehren Sie dann zur **Codex**-Seitenleiste zurück.
      </Accordion>

      <Accordion title="Codex: config.toml direkt bearbeiten" icon="file-code">
        Wenn Sie MCP-Einstellungen in der Benutzeroberfläche nicht speichern oder ändern können, bearbeiten Sie **`~/.codex/config.toml`** direkt. Laut [Model Context Protocol in Codex](https://developers.openai.com/codex/mcp) teilen sich die CLI, die **Codex-IDE-Erweiterung** und die **Codex Desktop App** diese Datei. Die Einrichtungsabläufe in der Benutzeroberfläche finden Sie unter [Codex-IDE-Erweiterung](#ide-extension) oder [Codex Desktop App](#desktop-app).

        Öffnen Sie **`~/.codex/config.toml`** in einem Texteditor. **`~`** ist Ihr Benutzerordner (z. B. **`/Users/your-user-name/.codex/config.toml`** unter macOS).

        Legen Sie **`url`** und **`http_headers`** aus der **MCP-Konfiguration** fest, genau so kopiert, wie Iru sie anzeigt. Der Wert **`X-API-Key`** in **`http_headers`** enthält das bereits im Snippet vorhandene Präfix **`sk_live:`**. Verwenden Sie **Iru MCP** als Servernamen. In **`config.toml`** muss der Tabellenname nach **`mcp_servers.`** dem Namen entsprechen, unter dem Codex diesen Server gespeichert hat (häufig von **Iru MCP** abgeleitet, z. B. **`iru_mcp`**).

        Beispiel für **Iru MCP**:

        ```toml config.toml lines theme={null}
        [mcp_servers.iru_mcp]
        enabled = true
        url = "https://YOUR_TENANT.connect.iru.com/mcp-server/connector/kandji/tools"
        http_headers = { "X-API-Key" = "sk_live:YOUR_API_KEY", "X-MCP-Profile" = "YOUR_PROFILE_ID" }
        ```

        Speichern Sie die Datei und **beenden Sie** Codex dann **vollständig** oder starten Sie Ihren Editor neu, damit die MCP-Einstellungen neu geladen werden.
      </Accordion>

      <Accordion title="MCP-Server stellt keine Verbindung her oder Tools bleiben offline" icon="arrow-rotate-right">
        Bestätigen Sie, dass **Iru MCP** in den MCP-Einstellungen von Codex aktiviert ist und **`url`** und **`headers`** mit der **MCP-Konfiguration** übereinstimmen (**`X-API-Key`** muss das bereits im Snippet enthaltene Präfix **`sk_live:`** enthalten). **Beenden Sie** dann die Host-App **vollständig** und öffnen Sie sie erneut, damit Codex MCP neu lädt. Bei der **Codex-IDE-Erweiterung** bedeutet dies, den Editor zu beenden; bei der **Codex Desktop App** beenden Sie Codex vollständig. Für Debugging auf Transportebene lesen Sie den [Model Context Protocol debugging guide](https://modelcontextprotocol.io/docs/tools/debugging).
      </Accordion>
    </AccordionGroup>
  </Accordion>
</AccordionGroup>

### Verwandte Artikel

<CardGroup cols={2}>
  <Card title="Iru API-Übersicht" icon="file-lines" href="/en/endpoint/api/iru-api-overview">
    REST-APIs, Token, Berechtigungen und Activity für die Enterprise API, die MCP als Tools bereitstellt.
  </Card>

  <Card title="Iru Endpoint API in Postman einrichten" icon="flask" href="/en/endpoint/api/how-to-set-up-the-iru-endpoint-api-in-postman">
    Importieren Sie die veröffentlichte Sammlung und senden Sie authentifizierte Anfragen außerhalb von MCP.
  </Card>

  <Card title="Referenz zur Iru Endpoint Management API" icon="book" href="https://api-docs.kandji.io">
    Durchsuchen Sie Endpunkte, Parameter sowie Anfrage- und Antwortbeispiele für die zugrunde liegende API.
  </Card>

  <Card title="Drittanbieter-Apps mit der Iru Endpoint API integrieren" icon="plug" href="/de/endpoint/integrations/overview/integrating-third-party-apps-using-the-iru-endpoint-api">
    Verbinden Sie Produkte von Drittanbietern und ordnen Sie die API-Berechtigungen zu, die jede Integration benötigt.
  </Card>
</CardGroup>