Dokumentation

So funktioniert NexTool MCP for GLPI

Von der Registrierung im Portal bis zur ersten Frage an die KI: wie der Dienst Ihren Assistenten mit Ihrem GLPI verbindet, was Sie anfragen können und wie Ihre Daten geschützt bleiben.

Nicht mit Teclib' verbunden. GLPI ist eine eingetragene Marke von Teclib'.

Überblick

NexTool MCP sitzt in der Mitte: Es empfängt die Anfrage des Assistenten, prüft im NexTool-Portal, wer Sie sind, und ruft die API Ihres GLPI mit den von Ihnen hinterlegten Zugangsdaten auf.

Sie unterhalten sich

Sie fragen in natürlicher Sprache. Der Assistent wählt das passende GLPI-Tool (es gibt mehr als 160) und zeigt, was er tun wird.

Der Connector prüft

Bei jeder Anfrage prüft NexTool MCP im Portal, ob der Schlüssel oder die Anmeldung gültig ist, welche Verbindung zu verwenden ist, das Limit des Tarifs und ob die Verbindung schreibgeschützt ist.

GLPI antwortet

Der Aufruf erreicht die GLPI-API als Benutzer des Tokens. Was dieser in GLPI nicht tun darf, kann auch die KI nicht tun.

Die gehostete Version, Schritt für Schritt Offene Beta

Für alle offen und während der Beta kostenlos. Fünf Schritte, von der Registrierung bis zur ersten Frage.

  1. 1

    Erstellen Sie Ihr Konto im NexTool-Portal

    Es ist kostenlos und nutzt das Portalkonto, ohne separate Registrierung. Haben Sie bereits ein Konto? Melden Sie sich einfach an.

  2. 2

    Öffnen Sie Mein Konto → NexTool MCP

    Die Seite NexTool MCP des Portals bündelt Ihre GLPI-Verbindungen, die API-Schlüssel, die autorisierten Apps und Ihren Tarif.

  3. 3

    Erstellen Sie die Verbindung zu Ihrem GLPI

    Vergeben Sie einen Namen (z. B. Produktion), geben Sie die HTTPS-Adresse des GLPI ein und wählen Sie die API:

    • REST-API v1 (GLPI 10 und 11): der Benutzer-Token und, falls der API-Client von GLPI es verlangt, der App-Token.
    • API v2 (GLPI 11, OAuth): die Adresse der API v2, die Client-ID und das Secret eines OAuth-Clients von GLPI, dazu Benutzername und Passwort.
    • Beide: Füllen Sie beide mit den Zugangsdaten derselben Person in GLPI aus. Authentifizieren v1 und v2 unterschiedliche Benutzer, blockiert der Test die Verbindung.

    Markieren Sie die Tool-Gruppen, die die KI nutzen darf (Essenziell ist bereits markiert) und aktivieren Sie bei Bedarf den schreibgeschützten Modus.

    Die Zugangsdaten werden im Moment des Speicherns mit einem Schlüssel verschlüsselt, den nur der Connector öffnen kann: Weder das Portal noch das NexTool-Team kann sie lesen.

  4. 4

    Testen Sie die Verbindung

    Beim Speichern testet das Portal sofort und zeigt die GLPI-Version sowie den Benutzer und das Profil, die jede API authentifiziert hat. Bei einem Fehler nennt die Meldung den Grund:

    Was angezeigt wirdWas es bedeutetWas zu tun ist
    GLPI nicht aus dem Internet erreichbarZeigt auf ein privates oder gesperrtes Netzwerk (interne IP, localhost).Veröffentlichen Sie GLPI unter einer öffentlichen HTTPS-Adresse oder nutzen Sie die Open-Source-Version in Ihrem Netzwerk.
    GLPI nicht erreichtDNS-Fehler, Zeitüberschreitung oder abgelehnte Verbindung.Prüfen Sie Adresse, DNS und Firewall.
    Ungültiges ZertifikatDas HTTPS-Zertifikat ist abgelaufen, selbstsigniert oder passt nicht zur Adresse.Installieren Sie ein gültiges Zertifikat (z. B. Let's Encrypt).
    WeiterleitungGLPI leitet auf eine andere Adresse weiter (http auf https, andere Domain, Anmeldeseite).Geben Sie die endgültige Adresse an, wie der Browser sie nach der Weiterleitung anzeigt.
    Antwortet nicht als GLPI-APIDie Adresse antwortet, aber nicht wie die GLPI-API (Proxy, Anmeldeseite, falscher Pfad).Verwenden Sie die GLPI-Wurzel, ohne /front oder /apirest.php am Ende.
    API deaktiviertDie REST-API ist in GLPI ausgeschaltet.Aktivieren Sie unter Konfiguration → Allgemein → API die REST-API und die Anmeldung per Token.
    IP nicht freigegebenDer API-Client von GLPI akzeptiert nur einige IPs, und die des Connectors gehört nicht dazu.Die Portalmeldung zeigt die IP des Connectors: Geben Sie sie im API-Client frei (Konfiguration → Allgemein → API).
    Zugangsdaten abgelehntGLPI hat den App-Token, den Benutzer-Token oder OAuth abgelehnt.Erzeugen Sie den Token neu und prüfen Sie, ob der App-Token zum richtigen API-Client gehört.
    Unterschiedliche Benutzer in den beiden APIsv1 und v2 haben unterschiedliche Personen in GLPI authentifiziert.Verwenden Sie in beiden APIs die Zugangsdaten desselben Benutzers.

    Ein Benutzer mit dem Profil Super-Admin blockiert den Test nicht, aber das Portal zeigt eine deutliche Warnung: Bevorzugen Sie einen dedizierten Benutzer mit minimalem Profil.

  5. 5

    Verbinden Sie Ihren Assistenten

    Jede Verbindung hat ihre eigene Connector-URL, die in der Portalliste mit einer Kopieren-Schaltfläche angezeigt wird:

    https://mcp.nextoolsolutions.com/mcp/principal

    principal ist die Kennung der ersten Verbindung des Kontos; die übrigen verwenden die Kennung, die Sie wählen. Die Adresse ohne Kennung (/mcp) funktioniert ebenfalls und nutzt die erste verifizierte Verbindung.

  1. 1

    Klicken Sie unter Einstellungen → Konnektoren auf Benutzerdefinierten Konnektor hinzufügen.

  2. 2

    Vergeben Sie einen Namen (z. B. GLPI Produktion) und fügen Sie die URL der Verbindung ein:

    https://mcp.nextoolsolutions.com/mcp/principal
  3. 3

    Klicken Sie auf Verbinden: Die Anmeldung des NexTool-Portals öffnet sich. Melden Sie sich mit Ihrem Konto an.

  4. 4

    Prüfen Sie auf dem Autorisierungsbildschirm die App, die Rücksprungadresse und die zu verwendende GLPI-Verbindung und klicken Sie auf Autorisieren.

Ein Connector pro GLPI: Für eine weitere Verbindung fügen Sie einen weiteren Connector mit deren URL hinzu. Um den Zugriff zu beenden, widerrufen Sie ihn unter Mein Konto → NexTool MCP → Autorisierte Apps.

Fertig: Probieren Sie liste meine offenen Tickets auf. Hat das Konto noch keine verifizierte Verbindung, erhält der Assistent nur das Tool nextool_setup, das erklärt, was fehlt.

Verbindungen und mehrere Instanzen

Eine Verbindung ist ein GLPI. Wer mit Produktion und Staging oder mit mehreren Kunden arbeitet, legt für jedes eine Verbindung an.

Eine URL pro Verbindung

Jede Verbindung hat eine Kennung, die die Connector-URL bildet. Sie ändert sich nach der Erstellung nicht, weil dies die Adresse ist, die der Assistent verwendet.

Schreibgeschützt pro Verbindung

In der Liste ein- und ausschaltbar, ohne neuen Test. Ist der Modus aktiv, wird jedes Tool, das erstellt, ändert oder löscht, abgelehnt, bevor es GLPI erreicht. Für die Produktion empfohlen.

Autorisierung pro Connector

Die an einem Connector autorisierte Anmeldung gilt nur für dessen URL: Ein Staging-Connector erreicht die Produktion nicht.

Tool-Gruppen

Jede Verbindung wählt ihre eigenen Gruppen. Weniger Tools machen den Assistenten schneller und treffsicherer.

Kostenlos und Pro

In der gehosteten VersionKostenlosPro
Verbindungen (je ein GLPI)1bis zu 10
Anfragen pro Minute60300
Schreibgeschützt pro VerbindungJaJa
So erhalten Sie esJedes Konto des NexTool-Portals, während der Beta kostenlosNexTool-MCP-Pro-Lizenz Ihrer NexTool-Umgebung

Fällt das Konto zurück auf Kostenlos, werden die Verbindungen über dem Limit (die neuesten) angehalten, ohne dass etwas verloren geht, bis Sie andere löschen oder zu Pro zurückkehren.

Was Sie anfragen können

Sprechen Sie, wie Sie mit einem Kollegen vom Service Desk sprechen würden. Der Assistent wählt das Tool; Sie sehen, welches es ist, und bestätigen bei Tools, die Daten ändern, vorher.

Essenziell

core

Abfragen von Tickets, Problemen, Änderungen, Assets, Wissensdatenbank, Dokumenten und Benutzern, dazu die Ticket-Operationen, die nichts löschen. Standardmäßig markiert.

Beispielanfragen

  • Liste meine offenen Tickets auf.
  • Fasse den Verlauf von Ticket 123 zusammen.
  • Füge zu 123 eine Folgeaktion hinzu, dass das Gerät morgen eintrifft.

Tickets

tickets

Vollständiger Ticket-Lebenszyklus: erstellen, aktualisieren, zuweisen, nachverfolgen, lösen, Aufgaben und Genehmigungen.

Beispielanfragen

  • Erstelle ein Ticket für João: Drucker im 3. Stock ohne Toner.
  • Weise Ticket 456 der Gruppe Infrastruktur zu.
  • Hole die Genehmigung von Maria für Ticket 789 ein.

Probleme und Änderungen

itil

ITIL-Probleme und -Änderungen, mit Zeitleiste, Aufgaben und Lösungen.

Beispielanfragen

  • Welche Änderungen sind für diese Woche geplant?
  • Erstelle ein Problem für die heute gemeldeten VPN-Ausfälle.
  • Zeige die Zeitleiste der Änderung 42.

Assets und Inventar

assets

Computer, Monitore, Drucker und weitere Assets, mit Reservierungen und Standorten.

Beispielanfragen

  • Welche Computer sind dem Benutzer Carlos zugeordnet?
  • Finde das Asset mit der Seriennummer ABC123.
  • Welche Objekte sind für morgen reserviert?

Wissensdatenbank

kb

Suchen und Lesen von Artikeln und Kategorien; Erstellen und Bearbeiten, wenn das Profil es erlaubt.

Beispielanfragen

  • Suche in der Wissensdatenbank nach VPN.
  • Mache aus der Lösung von Ticket 321 einen Artikel.
  • Liste die Kategorien der Wissensdatenbank auf.

Dokumente

documents

Dokumente und ihre Verknüpfungen mit Tickets und Assets. Das Lesen ist bereits in Essenziell enthalten.

Beispielanfragen

  • Welche Anhänge hat Ticket 123?
  • Zeige die mit dem Notebook NB-045 verknüpften Dokumente.

Benutzer und Gruppen

users

Abfrage von Benutzern und Gruppen, um Anforderern und Technikern einen Namen zuzuordnen.

Beispielanfragen

  • Wer ist der Benutzer mit der E-Mail [email protected]?
  • Wer gehört zur Gruppe Service Desk N2?

Suche

search

Die allgemeine GLPI-Suche mit Filtern und Zählungen. Bereits in Essenziell und Tickets enthalten.

Beispielanfragen

  • Wie viele Tickets wurden diesen Monat in der Kategorie Netzwerk erstellt?
  • Liste die Tickets auf, die seit mehr als 7 Tagen offen sind.

Administration

admin

Einheiten, Geschäftsregeln, Vorlagen für Folgeaktionen, Webhooks und das Anlegen von Benutzern und Gruppen. Schalten Sie sie nur bei Bedarf ein.

Beispielanfragen

  • Liste die Regeln zur Ticket-Zuweisung auf.
  • Welche Webhooks sind heute fehlgeschlagen?

API v2 (GLPI 11)

v2

Die Tools der API v2 von GLPI 11, mit OAuth: Ticket-Team, Zeitleiste, Wissensdatenbank, Dokumente und Regeln.

Beispielanfragen

  • Zeige das Team von Ticket 123.
  • Lade das Dokument 55 herunter.

Was „meine Tickets“ sind

Es sind die Tickets des GLPI-Benutzers, dessen Zugangsdaten in der Verbindung hinterlegt sind, als Anforderer, zugewiesener Techniker oder Beobachter. Standardmäßig werden nur die offenen angezeigt, vom neuesten zum ältesten. Sie können nur die von Ihnen erstellten, nur die Ihnen zugewiesenen oder auch geschlossene anfragen. Diese Abfrage nutzt die REST-API v1.

Die KI folgt den GLPI-Berechtigungen

Jede Aktion läuft als Benutzer des Tokens, mit dessen Profil und Einheiten: Was er in GLPI nicht sehen oder ändern darf, darf die KI auch nicht. Die Namen von Status und Priorität erscheinen in der GLPI-Sprache dieses Benutzers.

Der Code jeder Gruppe ist der Name des Presets in der lokalen Version (GLPI_TOOLSETS). Im Portal erscheinen Dokumente und Suche nicht als eigene Gruppen: Ihre Abfragen sind bereits in Essenziell enthalten.

Sicherheit und Datenschutz

Wie der Dienst Ihr GLPI und Ihre Daten schützt.

Annotationen und Bestätigung

Jedes Tool deklariert sich als schreibgeschützt oder destruktiv. KI-Clients nutzen das, um vor Datenänderungen Ihre Bestätigung einzuholen.

Löschungen gesperrt

In der gehosteten Version steht in keinem Tarif ein Lösch-Tool zur Verfügung. Löschen bleibt Ihre Sache, in GLPI.

Verschlüsselte Zugangsdaten

Im Moment des Speicherns versiegelt, mit einem Schlüssel, den nur der Connector öffnen kann. Das Portal speichert den verschlüsselten Umschlag und kann ihn nicht öffnen; die nxm_-Schlüssel werden nur als Hash gespeichert.

Keine Unterhaltung gespeichert

Der Connector speichert weder Fragen, Antworten noch GLPI-Inhalte. Das Audit erfasst nur Metadaten: Konto, Verbindung, Tool und Uhrzeit, niemals die Argumente.

Kein Zugriff auf interne Netzwerke

Der Connector ruft nur öffentliche Adressen auf: Er lehnt private IPs, localhost und interne Cloud-Adressen ab, prüft die IP bei jeder Verbindung und folgt keiner Weiterleitung zu einem anderen Host.

Nutzungslimits

Es gibt ein Anfragenlimit pro Minute je Schlüssel oder Anmeldung (60 bei Kostenlos, 300 bei Pro) und ein weiteres je Ziel-GLPI, damit ein Assistent in einer Schleife Ihr GLPI nicht überlastet.

Dedizierter Benutzer, minimales Profil

Verwenden Sie keinen Super-Admin: Die KI hätte vollen Zugriff. Legen Sie einen Benutzer nur für die KI an, mit dem nötigen Profil und den nötigen Einheiten, und verwenden Sie dessen Token.

Widerrufbarer Zugriff

Widerrufen Sie einen Schlüssel oder eine autorisierte App unter Mein Konto → NexTool MCP: Der Zugriff endet innerhalb einer Minute.

Limits und große Antworten

Ein großes GLPI hat Tausende Tickets. Damit die Antwort in die Unterhaltung passt, liefert der Connector sie in Teilen.

Seitenweise Listen

Standardmäßig 25 Einträge pro Seite, bis zu 100 pro Aufruf.

Größenobergrenze

Jede Antwort bleibt unter 50.000 Zeichen. Eine längere Liste wird am Ende abgeschnitten, und die Antwort weist darauf hin.

Lange Texte gekürzt

In Listen werden Texte über 300 Zeichen abgeschnitten; das Öffnen des Eintrags liefert den vollständigen Text. Der Ticket-Verlauf wird nie gekürzt.

Nächste Seite

Jede Teilantwort sagt, wie Sie den Rest abrufen. Fragen Sie einfach: zeige die nächste Seite oder hole die nächsten 50.

Tipp: Filtern Sie direkt in der Anfrage (Status, Zeitraum, Kategorie, Techniker). Offene Tickets der Kategorie Netzwerk, die diesen Monat erstellt wurden wird schneller beantwortet und verbraucht weniger Kontext als alle Tickets.

Anfragenlimit überschritten? Der Assistent erhält einen Hinweis, einige Sekunden zu warten und es erneut zu versuchen.

Lokale Open-Source-Version

Dieselben Tools, auf Ihrem Rechner oder Server, unter der MIT-Lizenz.

Wann sie sich eignet

  • Ihr GLPI existiert nur im Intranet, ohne Internetzugang.
  • Sie möchten, dass alles in Ihrem Netzwerk bleibt, ohne einen externen Dienst zu durchlaufen.
  • Sie brauchen etwas, das die gehostete Version nicht bietet, etwa die Lösch-Tools (mit obligatorischer schriftlicher Begründung).

Installation

claude mcp add glpi \ -e GLPI_URL=https://glpi.example.com \ -e GLPI_USER_TOKEN=<user-token> \ -e GLPI_APP_TOKEN=<app-token> \ -- npx -y @nextoolsolutions/mcp-glpi

@nextoolsolutions/mcp-glpi ist auf npm und in der offiziellen MCP-Registry als com.nextoolsolutions/glpi veröffentlicht. npx lädt die neueste Version herunter und führt sie aus, ohne Klonen oder Kompilieren. Der Installationsleitfaden enthält die Beispiele für Claude Desktop, Cursor und VS Code.

Wichtigste Variablen

VariableWirkung
GLPI_URLGLPI-Adresse (REST-API v1)
GLPI_USER_TOKENAPI-Token des Benutzers
GLPI_APP_TOKENApp-Token des API-Clients (optional)
GLPI_V2_*API v2 von GLPI 11, mit OAuth (optional)
GLPI_TOOLSETSTool-Presets, durch Kommas getrennt
GLPI_READ_ONLY=trueBlockiert jeden Schreibzugriff, bevor er das GLPI erreicht. Empfohlen für den Einstieg.
GLPI_ALLOW_DELETE=trueSchaltet die standardmäßig deaktivierten Löschwerkzeuge frei. Jedes Löschen erfordert eine schriftliche Begründung.

Um risikofrei zu beginnen, verwenden Sie GLPI_READ_ONLY=true: Jeder Schreibzugriff wird blockiert, bevor er GLPI erreicht.

Fehlerbehebung

Die häufigsten Fälle, vom Symptom zur Lösung. Zu den Fehlern des Verbindungstests siehe die Tabelle in Schritt 4.

SymptomWahrscheinliche UrsacheWas zu tun ist
Der Assistent sagt, es sei kein GLPI verbundenDas Konto hat keine verifizierte Verbindung, oder die Connector-URL verwendet eine Kennung, die nicht existiert.Testen Sie im Portal die Verbindung, bis sie Verifiziert ist, und prüfen Sie die Connector-URL.
Der Autorisierungsbildschirm zeigt keine Schaltfläche AutorisierenDie Verbindung zu dieser URL existiert nicht, ist nicht verifiziert oder überschreitet das Limit des Tarifs.Nutzen Sie den Link auf dem Bildschirm, um die Verbindung zu erstellen oder zu testen, und kehren Sie zurück, um abzuschließen.
Fehler 401 (nicht autorisiert) im ClientFalscher oder widerrufener nxm_-Schlüssel, oder abgelaufene oder widerrufene Anmeldung.Erzeugen Sie einen anderen Schlüssel oder verbinden Sie den Connector neu (in Claude Code /mcp).
Die KI kann nichts ändernSchreibgeschützte Verbindung, nicht markierte Tool-Gruppe oder ein GLPI-Profil ohne das Recht.Schalten Sie den schreibgeschützten Modus aus, markieren Sie die Gruppe oder passen Sie das Profil des Benutzers in GLPI an.
Ein erwartetes Tool fehltSeine Gruppe ist in der Verbindung nicht markiert, oder seine API (v1 oder v2) wurde nicht konfiguriert.Bearbeiten Sie die Verbindung und markieren Sie die Gruppe oder füllen Sie die API aus; die Änderung gilt innerhalb einer Minute.
„Meine Tickets“ ist leer oder gehört einer anderen PersonDie Liste gehört dem Benutzer des Tokens, nicht der Person, die mit der KI spricht.Verwenden Sie den Token Ihres eigenen Benutzers oder fragen Sie die Tickets einer Person über deren Namen an.
Hinweis auf AnfragenlimitDer Assistent hat in einer Minute zu viele Aufrufe gemacht.Warten Sie einige Sekunden und fragen Sie stärker gefilterte Listen an. Bei Pro ist das Limit höher.
Eine Verbindung erscheint als Über dem TariflimitDas Konto ist mit mehr als einer Verbindung auf Kostenlos zurückgefallen.Löschen Sie Verbindungen oder kehren Sie zu Pro zurück; nichts wurde gelöscht.
Ich habe zweimal angefragt und nur ein Eintrag wurde erstelltSchutz vor Duplikaten: Dieselbe Erstellung mit denselben Daten innerhalb von 2 Minuten liefert das erste Ergebnis zurück.Das ist erwartet. Wenn Sie wirklich einen weiteren Eintrag möchten, ändern Sie eine Angabe in der Anfrage.

Häufig gestellte Fragen

Nein. Sie brauchen nur das Konto im NexTool-Portal, die Verbindung zu GLPI und die Connector-URL in Ihrem Assistenten. In Claude Code, Cursor und VS Code genügt die Konfiguration des MCP-Servers.

Ja, im Pro-Tarif: bis zu 10 Verbindungen, eine pro GLPI, jede mit eigener Connector-URL. Bei Kostenlos eine Verbindung.

Die Aufrufe an Ihr GLPI laufen über den Connector, der weder Fragen, Antworten noch GLPI-Inhalte speichert. Das Audit erfasst nur Nutzungsmetadaten, und die Zugangsdaten sind mit einem Schlüssel verschlüsselt, den nur der Connector öffnen kann.

Der Zugriff endet innerhalb einer Minute. Um ihn wieder zu nutzen, erzeugen Sie einen neuen Schlüssel oder autorisieren Sie den Connector erneut.

Ja, über die REST-API v1. Die API v2 und die glpi_v2-Tools setzen GLPI 11 voraus.

v1 ist die klassische REST-API von GLPI 10 und 11, mit Benutzer-Token. v2 ist die neue API von GLPI 11, mit OAuth. Sie können eine oder beide in derselben Verbindung nutzen, immer mit demselben GLPI-Benutzer.

Bereit, Ihr GLPI zu verbinden?

Erstellen Sie Ihr kostenloses Konto und verbinden Sie Ihr GLPI in wenigen Minuten, oder starten Sie mit der Open-Source-Version.

Nicht mit Teclib' verbunden. GLPI ist eine eingetragene Marke von Teclib'.

Brauchen Sie Hilfe?