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

# KI-Agenten mit Lizard verbinden

> Verbinde Claude oder einen eigenen KI-Agenten mit Lizard und frage Betriebsmittel und Prüfungen im Gespräch ab.

# KI-Agenten mit Lizard verbinden

Mit einem KI-Agenten fragst du Lizard in normaler Sprache: *„Was ist an der Halle 3 überfällig?"* oder *„Wann wurde die Leiter mit diesem DynTag zuletzt geprüft?"* Der Agent greift dafür direkt auf deine Daten in Lizard zu, statt dass du dich durch Listen und Filter klickst.

Die Verbindung läuft über **MCP** (Model Context Protocol). Das ist der Standard, über den KI-Anwendungen wie Claude auf andere Programme zugreifen.

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/KaAgTvtLoYM" title="Wie verbinde ich einen KI-Agenten mit Lizard?" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

## Was ein Agent in Lizard kann

<CardGroup cols={2}>
  <Card title="Lesen" icon="eye">
    Immer möglich. Fällige und überfällige Prüfungen, Betriebsmittel suchen, Details und Prüfhistorie eines Geräts, Standorte und Kategorien mit der Zahl ihrer überfälligen Betriebsmittel und die Normen je Prüfkategorie. Erlaubt deine Rolle den Partnerbereich, zusätzlich Zusammenarbeiten und den betreuenden Dienstleister.
  </Card>

  <Card title="Anlegen und ändern" icon="pen-to-square">
    Nur mit Freigabe. Betriebsmittel anlegen und bearbeiten, DynTags verknüpfen, Betriebsmittel einer Zusammenarbeit zuordnen sowie Zusammenarbeiten anlegen und bearbeiten.
  </Card>
</CardGroup>

Was genau hinter den Freigaben steckt und was ein Agent grundsätzlich nicht kann, steht unter [Rechte & Freigaben](/ki-agenten/rechte-und-freigaben).

<Warning>
  **Der Agent sieht nur die Betriebsmittel deiner eigenen Firma.** Betriebsmittel, die eine andere Firma über eine Zusammenarbeit mit dir teilt, sind für ihn nicht sichtbar, auch wenn du sie in Lizard siehst. Als Service-Unternehmen fragst du über den Agenten also nicht die Geräte deiner Kunden ab.
</Warning>

## Voraussetzungen

* **Freischaltung in deiner Lizenz.** Nur dann erscheinen im Benutzermenü (Profilbild oben rechts) die Einträge **KI-Agent verbinden** und **KI-Agenten-Protokoll**. Fehlt die Freischaltung, zeigt das Anmeldefenster beim Verbinden *„KI-Agenten sind für Ihre Lizenz nicht freigeschaltet"*, und es wird kein Zugriff erteilt. Wende dich in dem Fall an deinen Ansprechpartner bei Lizard.
* **Deine eigenen Rechte.** Der Agent handelt in deinem Namen und mit deiner Rolle. Was du in Lizard nicht darfst, darf er auch nicht.

Die Lizenz wird bei jeder einzelnen Anfrage geprüft, nicht nur beim Verbinden. Entfällt die Freischaltung, endet der Zugriff aller verbundenen Agenten sofort. Dasselbe gilt, wenn dein Zugang als externer Mitarbeiter abläuft.

## Claude verbinden

<Steps>
  <Step title="Seite KI-Agent verbinden öffnen">
    Klicke oben rechts auf dein Profilbild und wähle **KI-Agent verbinden**. Unter **Connector-URL** steht die Adresse, über die sich der Agent mit Lizard verbindet. Kopiere sie.
  </Step>

  <Step title="Connector in Claude anlegen">
    Öffne Claude am Rechner unter **Customize → Connectors**, wähle **Add custom connector** und trage die kopierte Adresse ein.
  </Step>

  <Step title="Bei Lizard anmelden und zustimmen">
    Es öffnet sich ein Fenster von Lizard. Melde dich mit deinem Lizard-Zugang an. Das Fenster nennt, welcher Agent sich verbinden möchte, und fasst den Zugriff zusammen.

    Bestätige den Hinweis *„Ich habe verstanden, dass die abgerufenen Daten den Auftragsverarbeitungsvertrag mit Lizard verlassen und ich für die Weitergabe verantwortlich bin."* Ohne diesen Haken lässt sich der Zugriff nicht erlauben. Klicke dann auf **Zugriff erlauben**.
  </Step>

  <Step title="Loslegen">
    Der Connector steht danach auch in der Claude-App auf dem Smartphone zur Verfügung. In Lizard erscheint der Agent in der Tabelle **Verbundene Agenten**.
  </Step>
</Steps>

<Check>
  Welche Freigaben ein Agent hat, siehst du in der Tabelle **Verbundene Agenten** in den Spalten **Kontaktdaten** und **Anlegen**. Beide schaltest du dort je Agent um, siehe [Freigaben erteilen und entziehen](/ki-agenten/rechte-und-freigaben#freigaben-erteilen-und-entziehen).
</Check>

<Note>
  Hast du Zugang zu mehreren Firmen, verbinde den Agenten in der Firma, deren Daten er sehen soll. Die Seite **KI-Agent verbinden** zeigt immer nur die Agenten der Firma, in der du gerade arbeitest.
</Note>

## Eigenen Agenten mit einem Token verbinden

Für einen eigenen Agenten, der auf einem Server läuft, zum Beispiel eine Automatisierung in n8n, LangChain oder ein eigenes Skript, gibt es keine Anmeldung im Browser. Er verbindet sich stattdessen mit einem Token.

<Steps>
  <Step title="Token erstellen">
    Klicke auf der Seite **KI-Agent verbinden** auf **Token für eigenen Agenten erstellen** und gib einen **Namen** ein, an dem du den Agenten später wiedererkennst.
  </Step>

  <Step title="Hinweis bestätigen und Freigaben wählen">
    Bestätige denselben Hinweis wie beim Verbinden von Claude. Darunter kannst du dem Agenten gleich zusätzliche Freigaben geben: Kontaktdaten lesen und Betriebsmittel anlegen. Beide sind standardmäßig aus. Setzt du den Haken für das Anlegen, ändert sich der Text oben im Dialog. Was die Freigabe genau umfasst, steht unter [Rechte & Freigaben](/ki-agenten/rechte-und-freigaben).
  </Step>

  <Step title="Token sofort sichern">
    Nach **Erstellen** zeigt Lizard den Token **ein einziges Mal** an. Der Token ist alles nach dem Doppelpunkt in der Meldung. Kopiere ihn sofort an einen sicheren Ort.
  </Step>

  <Step title="Agent einrichten">
    Dein Agent schickt den Token bei jeder Anfrage an die Connector-URL als Bearer-Token mit.
  </Step>
</Steps>

<Warning>
  Der Token gilt sofort und ohne weitere Rückfrage. Behandle ihn wie ein Passwort. Ein eigener Token ist 90 Tage gültig, danach erstellst du einen neuen.
</Warning>

## Verbundene Agenten verwalten

Die Tabelle **Verbundene Agenten** auf der Seite **KI-Agent verbinden** zeigt alle Agenten, die mit deinem Zugang verbunden sind:

| Spalte                            | Bedeutung                                                                                                                                                                                                                                                                                     |
| :-------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**                          | Bei einem eigenen Token der Name, den du vergeben hast. Bei einem über die Anmeldung verbundenen Agenten der Name, mit dem sich die Anwendung meldet, zum Beispiel Claude.                                                                                                                    |
| **Verbunden am** / **Gültig bis** | Bei einem eigenen Token: wann er erstellt wurde und wann er abläuft. Ein abgelaufener Token bleibt in der Liste stehen, bis du ihn widerrufst. Bei einem über die Anmeldung verbundenen Agenten beziehen sich beide Werte nur auf den aktuellen Abschnitt der Verbindung, nicht auf ihr Ende. |
| **Kontaktdaten**                  | *Freigegeben* oder *Gesperrt*.                                                                                                                                                                                                                                                                |
| **Anlegen**                       | *Freigegeben* oder *Gesperrt*.                                                                                                                                                                                                                                                                |

Über die Aktionen in jeder Zeile erteilst oder nimmst du Freigaben zurück und widerrufst den Zugriff.

<Note>
  Wurde eine Verbindung erneuert oder widerrufen, während die Seite offen war, führt Lizard eine Aktion in ihrer alten Zeile nicht aus. Das gilt auch für **Zugriff widerrufen**. Stattdessen erscheint die Meldung *„Dieser Eintrag ist nicht mehr aktuell"*, und die Tabelle zeigt den aktuellen Stand. Führe die Aktion dort noch einmal aus. Eine KI-Anwendung wie Claude erneuert ihre Anmeldung von sich aus im Hintergrund, das kann also auch ohne dein Zutun passieren.
</Note>

### Zugriff widerrufen

Mit **Zugriff widerrufen** verliert der Agent sofort den Zugriff auf deine Daten. Er verschwindet danach aus der Tabelle. Willst du ihn später wieder nutzen, verbindest du ihn neu.

<Note>
  Daten, die der Agent bereits abgerufen hat, holt ein Widerruf nicht zurück. Was er abgerufen hat, siehst du auch nach dem Widerruf im [KI-Agenten-Protokoll](/ki-agenten/protokoll).
</Note>

## Was dabei Lizard verlässt

Der Agent liest nicht nur Gerätedaten. In den Antworten steht auch, wer eine Prüfung durchgeführt hat, also Namen von Personen. Sobald der Agent Daten abruft, gehen sie an die KI-Anwendung, die du einsetzt, und an den Anbieter des Sprachmodells dahinter. Deshalb bestätigst du beim Verbinden den oben genannten Hinweis.

Kontaktdaten der Ansprechpartner deiner Dienstleister gibt Lizard nur heraus, wenn du sie für den jeweiligen Agenten ausdrücklich freigibst.

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Rechte & Freigaben" icon="key" href="/ki-agenten/rechte-und-freigaben">
    Was ein Agent lesen und ändern darf und wann er dich vorher fragen muss.
  </Card>

  <Card title="KI-Agenten-Protokoll" icon="clipboard-list" href="/ki-agenten/protokoll">
    Nachsehen, was deine Agenten abgerufen und geändert haben.
  </Card>
</CardGroup>
