Iru MCP

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.

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.

Informationen zur REST-Nutzung (HTTP-APIs und Bearer-Token außerhalb von MCP) finden Sie in der Iru API-Übersicht.

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 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 in der Iru API-Übersicht. Die Schritte hier entsprechen diesem Artikel; Sie müssen Enable MCP vor Erstellen aktivieren, damit Iru eine MCP-Konfiguration für dieses Token ausstellt.

Zugriff öffnen

Wählen Sie in der Seitenleiste die Schaltfläche Kontomenü und dann Zugriff aus.

Registerkarte API-Token öffnen

Wählen Sie unter Zugriff die Registerkarte API-Token aus.

Neues API-Token erstellen

Wählen Sie Add Token, um ein neues API-Token zu erstellen.

Token-Details konfigurieren

Geben Sie einen Name und eine Beschreibung für Ihr API-Token an.

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.

Token erstellen

Wählen Sie Erstellen aus.

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 in der Iru API-Übersicht und in der Dokumentation zur Iru Endpoint Management API.

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.

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.

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.

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

Nur ein Platzhalterbeispiel:

mcp.json

{
  "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"
      }
    }
  }
}

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.

Next auswählen

Wählen Sie Weiter aus.

Wenn Sie das Token oder die Konfiguration verlieren, widerrufen Sie das Token und erstellen Sie ein neues.

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.

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.

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.

Speichern

Wenn Sie fertig sind, wählen Sie Speichern aus.

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

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.

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 in der Iru API-Übersicht.

Hinweise

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.

Widerruf ist vollständig

Durch das Widerrufen des Tokens wird der darauf basierende API- und MCP-Zugriff beendet.

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.

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.

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

Best Practices

Prinzip der geringsten Rechte anwenden

Erstellen Sie ein Token nur mit den Enterprise API-Bereichen, die Ihre Automatisierung benötigt, und aktivieren Sie dann MCP für dieses Token.

Token nach Team oder Anwendungsfall trennen

Verwenden Sie beispielsweise ein lesendes Token für Berichtsassistenten und ein enger gefasstes operatives Token für Behebungs-Workflows.

Bei Verdacht rotieren

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.

Lokale Konfigurationsdateien schützen

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.

MCP- und API-Geheimnisse schützen

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.

Iru MCP zu Ihrem MCP-Client hinzufügen

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

Claude Desktop
Cursor
OpenAI Codex

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 ab, damit Sie url und headers (X-API-Key, X-MCP-Profile) haben.
Installieren Sie Node.js 20+ von nodejs.org. Das Installationsprogramm enthält npx, das Claude Desktop zum Ausführen der Iru MCP-Verbindung verwendet.

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.

macOS
Windows

Claude Desktop herunterladen und installieren

Laden Sie Claude Desktop für macOS herunter, installieren Sie die App und melden Sie sich an: Download Claude.

Einstellungen von Claude Desktop öffnen

Öffnen Sie Claude Desktop und wählen Sie in der Menüleiste Claude → Settings aus.

Developer-Einstellungen öffnen

Wählen Sie unter Einstellungen Developer aus.

Konfigurationsdatei öffnen

Wählen Sie unter Developer Edit Config aus. Claude Desktop öffnet den Konfigurationsordner im Finder.

claude_desktop_config.json öffnen

Öffnen Sie claude_desktop_config.json aus diesem Ordner in einem Texteditor Ihrer Wahl.

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").

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.

claude_desktop_config.json

{
  "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

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:

claude_desktop_config.json

        "IRU_X_MCP_PROFILE": "YOUR_PROFILE_ID"
      }
    }
  },
  "preferences": {
    "remoteToolsDeviceName": "your-device-name",
    "coworkWebSearchEnabled": true
  }
}

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.

Verbindung überprüfen

Nachdem Claude Desktop wieder geöffnet ist, starten Sie einen neuen Chat und fragen Sie:

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.

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.

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.

Claude Desktop herunterladen und installieren

Laden Sie Claude Desktop für Windows herunter, installieren Sie die App und melden Sie sich an: Download Claude.

Einstellungen von Claude Desktop öffnen

Öffnen Sie Claude Desktop und wählen Sie das Hamburger-Menü, File und dann Einstellungen aus.

Developer-Einstellungen öffnen

Wählen Sie unter Einstellungen Developer aus.

Konfigurationsdatei öffnen

Wählen Sie unter Developer Edit Config aus. Claude Desktop öffnet den Konfigurationsordner im Datei-Explorer.

claude_desktop_config.json öffnen

Öffnen Sie claude_desktop_config.json aus diesem Ordner in einem Texteditor Ihrer Wahl.

Iru MCP-Servereintrag hinzufügen

claude_desktop_config.json

{
  "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

In eine vorhandene Datei einfügen

claude_desktop_config.json

        "IRU_X_MCP_PROFILE": "YOUR_PROFILE_ID"
      }
    }
  },
  "preferences": {
    "remoteToolsDeviceName": "your-device-name",
    "coworkWebSearchEnabled": true
  }
}

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.

Verbindung überprüfen

Nachdem Claude Desktop wieder geöffnet ist, starten Sie einen neuen Chat und fragen Sie:

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.

Zugriff bei Aufforderung genehmigen

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.

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.

Werte aus Iru vorbereiten

Schließen Sie in Iru Token und MCP-Konfiguration kopieren ab, damit Sie url und headers (X-API-Key, X-MCP-Profile) haben.

Cursor herunterladen und installieren

Laden Sie Cursor für Ihre Plattform herunter, installieren Sie die App und melden Sie sich an: Download Cursor.

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.

Benutzerdefiniertes MCP hinzufügen

Wählen Sie Add Custom MCP aus.

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:

mcp.json

{
  "mcpServers": {}
}

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

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

mcp.json

{
  "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"
      }
    }
  }
}

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

Cursor neu starten

Beenden Sie Cursor vollständig und öffnen Sie es dann erneut. Cursor lädt MCP beim Start.

Bestätigen

Kehren Sie zu Tools & MCP zurück. Bestätigen Sie, dass iru angezeigt wird und der Schalter aktiviert ist.

Weitere Informationen zur Verwendung von MCP in Cursor finden Sie unter Model Context Protocol (MCP) in Cursor.

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.

Desktop App
IDE extension

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 bei OpenAI Developers.

Werte aus Iru vorbereiten

Schließen Sie in Iru Token und MCP-Konfiguration kopieren ab, damit Sie url und headers (X-API-Key, X-MCP-Profile) haben.

Codex herunterladen und installieren

Laden Sie die Codex Desktop App herunter und installieren Sie sie: Codex.

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 in der Codex-App-Dokumentation.

Einstellungen öffnen

Gehen Sie in Codex zu Einstellungen.

MCP-Server öffnen

Wählen Sie MCP servers aus.

Server hinzufügen

Wählen Sie + Add server aus.

Name

Geben Sie unter Name Iru MCP ein.

Transport

Wählen Sie Streamable HTTP aus.

URL

Geben Sie unter URL den Wert url aus der MCP-Konfiguration ein.

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

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.

Speichern

Wählen Sie Speichern aus.

Codex neu starten

Beenden Sie Codex vollständig und öffnen Sie es dann erneut, damit die MCP-Einstellungen neu geladen werden.

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

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.

Werte aus Iru vorbereiten

Schließen Sie in Iru Token und MCP-Konfiguration kopieren ab, damit Sie url und headers (X-API-Key, X-MCP-Profile) haben.

Visual Studio Code installieren

Installieren Sie bei Bedarf Visual Studio Code. VS Code unterstützt macOS, Windows und Linux.

Codex-Erweiterung installieren

Installieren Sie die Codex-Erweiterung 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.

Codex-Seitenleiste öffnen

Öffnen Sie die Codex-Seitenleiste über das OpenAI-Logo in der Aktivitätsleiste, über Open Codex Sidebar oder indem Sie die sekundäre Seitenleiste einblenden und die Registerkarte Codex auswählen.

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.

Codex-Einstellungen öffnen

Wählen Sie in der Codex-Seitenleiste das Zahnrad-Symbol und dann Codex settings aus.

MCP-Server öffnen

Wählen Sie MCP servers aus.

Server hinzufügen

Wählen Sie + Add server aus.

Name

Geben Sie unter Name Iru MCP ein.

Transport

Wählen Sie Streamable HTTP aus.

URL

Geben Sie unter URL den Wert url aus der MCP-Konfiguration ein.

Header für X-API-Key

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.

Speichern

Wählen Sie Speichern aus.

Erweiterung neu starten

Wenn Codex Restart extension anzeigt, wählen Sie diese Option, damit die MCP-Einstellungen neu geladen werden.

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

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.

Allgemeines zu Iru MCP

Der Assistent meldet, dass das Token ungültig ist oder die Authentifizierung fehlgeschlagen ist

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.

Tools fehlen oder der Assistent meldet eine verweigerte Berechtigung

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.

Die Konfiguration sieht in Iru korrekt aus, aber der Client schlägt weiterhin fehl

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 für Host-Protokolle, JSON-Validierung und Tests mit MCP Inspector.

Claude Desktop

Remote-Connector- oder Netzwerkfehler (benutzerdefinierte MCP-URL)

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 und Anthropic IP addresses.

Eintrag iru prüfen oder Host-Fehler lesen

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

Das Iru MCP kann mit mcp-remote@latest keine Verbindung herstellen

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.

stdio-Bridge (npx / mcp-remote) oder Einrichtung der Konfigurationsdatei

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.

Cursor

MCP wird nicht geladen oder iru bleibt nach dem Bearbeiten der Einstellungen deaktiviert

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

OpenAI Codex

Add a project to use Codex (IDE-Erweiterung)

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.

Codex: config.toml direkt bearbeiten

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 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 oder Codex 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:

config.toml

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

MCP-Server stellt keine Verbindung her oder Tools bleiben offline

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.

Iru API-Übersicht

REST-APIs, Token, Berechtigungen und Activity für die Enterprise API, die MCP als Tools bereitstellt.

Iru Endpoint API in Postman einrichten

Importieren Sie die veröffentlichte Sammlung und senden Sie authentifizierte Anfragen außerhalb von MCP.

Referenz zur Iru Endpoint Management API

Durchsuchen Sie Endpunkte, Parameter sowie Anfrage- und Antwortbeispiele für die zugrunde liegende API.

Drittanbieter-Apps mit der Iru Endpoint API integrieren

Verbinden Sie Produkte von Drittanbietern und ordnen Sie die API-Berechtigungen zu, die jede Integration benötigt.

Erste Schritte

Geräte

Agent

Blueprints

Registrierung

Library

Bereitstellungsleitfäden

Einstellungen

Integrationen

Endpoint Detection & Response

Schwachstellenmanagement

Einführung

Bevor Sie beginnen

API-Token mit MCP erstellen

Token und MCP-Konfiguration kopieren

API-Berechtigungen konfigurieren

API-Token widerrufen

Hinweise

Best Practices

Prinzip der geringsten Rechte anwenden

Token nach Team oder Anwendungsfall trennen

Bei Verdacht rotieren

Lokale Konfigurationsdateien schützen

MCP- und API-Geheimnisse schützen

Iru MCP zu Ihrem MCP-Client hinzufügen

Iru MCP zu Claude Desktop hinzufügen

Voraussetzungen

Iru MCP zu Cursor hinzufügen

Iru MCP zu OpenAI Codex hinzufügen

Codex Desktop App

Codex-IDE-Erweiterung

Fehlerbehebung

Verwandte Artikel

Iru API-Übersicht

Iru Endpoint API in Postman einrichten

Referenz zur Iru Endpoint Management API

Drittanbieter-Apps mit der Iru Endpoint API integrieren

​Einführung

​Bevor Sie beginnen

​API-Token mit MCP erstellen

​Token und MCP-Konfiguration kopieren

​API-Berechtigungen konfigurieren

​API-Token widerrufen

​Hinweise

​Best Practices

Prinzip der geringsten Rechte anwenden

Token nach Team oder Anwendungsfall trennen

Bei Verdacht rotieren

Lokale Konfigurationsdateien schützen

MCP- und API-Geheimnisse schützen

​Iru MCP zu Ihrem MCP-Client hinzufügen

​Iru MCP zu Claude Desktop hinzufügen

​Voraussetzungen

​Iru MCP zu Cursor hinzufügen

​Iru MCP zu OpenAI Codex hinzufügen

​Codex Desktop App

​Codex-IDE-Erweiterung

​Fehlerbehebung

​Verwandte Artikel

Iru API-Übersicht

Iru Endpoint API in Postman einrichten

Referenz zur Iru Endpoint Management API

Drittanbieter-Apps mit der Iru Endpoint API integrieren

Einführung

Bevor Sie beginnen

API-Token mit MCP erstellen

Token und MCP-Konfiguration kopieren

API-Berechtigungen konfigurieren

API-Token widerrufen

Hinweise

Best Practices

Iru MCP zu Ihrem MCP-Client hinzufügen

Iru MCP zu Claude Desktop hinzufügen

Voraussetzungen

Iru MCP zu Cursor hinzufügen

Iru MCP zu OpenAI Codex hinzufügen

Codex Desktop App

Codex-IDE-Erweiterung

Fehlerbehebung

Verwandte Artikel