Bewährte Verfahren für die IT-Dokumentation: So erstellen Sie eine Wissensdatenbank, die Ihr Team auch wirklich nutzt

Laut dem „Kaseya State of the MSP Report 2026“ stieg der Anteil der MSPs, die Schwierigkeiten bei der Erstellung und Pflege einer einheitlichen Kundendokumentation haben, im Jahresvergleich von 10 % auf 17 %, wodurch die Qualität der Dokumentation zu einem direkten Wettbewerbsvorteil und nicht mehr nur zu einer operativen Annehmlichkeit geworden ist. Laden Sie den vollständigen Bericht herunter.

Eine schlechte IT-Dokumentation ist fast genauso kostspielig wie gar keine IT-Dokumentation. Ein SharePoint-Ordner voller veralteter Netzwerkdiagramme, ein Wiki, das seit zwei Jahren nicht mehr aktualisiert wurde, und Runbooks, die von Ingenieuren verfasst wurden, die das Unternehmen bereits verlassen haben – all das erweckt den Anschein, als sei das Wissen dokumentiert, bietet jedoch keinerlei praktischen Nutzen.

Eine gute IT-Dokumentation ist ein lebendiges Betriebsgut: präzise, leicht auffindbar und wird vom Team täglich genutzt. Sie verkürzt die Zeit bis zur Behebung von Störungen, beschleunigt die Einarbeitung von Technikern, ermöglicht eine einheitliche Servicebereitstellung und beseitigt die kritische Abhängigkeit von einzelnen Wissensträgern – eine Abhängigkeit, die Unternehmen oft erst unter den schlimmsten Umständen erkennen, nämlich wenn diese Personen nicht verfügbar sind. „ IT Glue “ wird weltweit von mehr als 16.000 Unternehmen eingesetzt, um genau dieses Problem zu bewältigen. Kunden berichten von einer durchschnittlichen Verkürzung der Lösungszeit um 87 % nach der Implementierung.

Dokumentation, die sich selbst erstellt

IT GlueDie KI-Engine „Cooper Copilot“ nutzt den „Smart SOP Generator“, „Smart Create“ und „Smart Relate“, um die Dokumentation von einer manuellen Routineaufgabe in einen kontinuierlichen, automatisierten Prozess zu verwandeln und so das Wissen ohne zusätzlichen Dokumentationsaufwand auf dem neuesten Stand zu halten.

Entdecken Sie „ IT Glue “ und „ Kaseya 365 Ops“

Warum die meisten IT-Dokumentationen scheitern

Dokumentation scheitert immer wieder aus denselben wenigen Gründen. Diese zu verstehen, ist die Voraussetzung dafür, etwas zu entwickeln, das tatsächlich funktioniert.

Einmal erstellt, nie gepflegt. Dokumentation, die zum Zeitpunkt der Erstellung korrekt war, wird mit den Veränderungen der Umgebung zunehmend irreführend. Ein Netzwerkdiagramm von vor drei Jahren, ein Runbook, das auf einen Server verweist, der nicht mehr existiert, ein Passwortverzeichnis, das seit der letzten Passwortrotation nie mehr aktualisiert wurde – all dies sind aktive Gefahrenquellen, die Techniker unter Zeitdruck in die Irre führen. Veraltete Dokumentation ist kein Dokumentationsproblem, sondern ein Prozessproblem. Die Informationen veralten, weil das Änderungsmanagement keinen Schritt zur Aktualisierung der Dokumentation vorsieht.

Nicht verfügbar, wenn sie gebraucht wird. Dokumentation, die in der Ordnerstruktur eines gemeinsamen Laufwerks vergraben ist, in einem persönlichen Notizbuch gespeichert wird oder nur im Gedächtnis eines Teammitglieds vorhanden ist, verfehlt ihren Hauptzweck: der richtigen Person im richtigen Moment zur Verfügung zu stehen. Wenn ein Techniker 10 Minuten damit verbringen muss, Dokumentation zu suchen, bevor er mit der Behebung eines Vorfalls beginnen kann, hat die Dokumentation bereits versagt.

Unvollständige Abdeckung. Eine unvollständige Dokumentation, die einige Systeme abdeckt, andere jedoch nicht, die bestimmte Verfahren erfasst, die Routineverfahren jedoch auslässt, und die zwar einige Zugangsdaten auflistet, aber wichtige Konten auslässt, führt zu einer uneinheitlichen Zuverlässigkeit. Wenn Techniker nicht darauf vertrauen können, dass die Dokumentation vollständig ist, hören sie auf, sich darauf zu verlassen. Ein Dokumentationssystem mit Lücken ist oft schlimmer als gar kein System, da es ein falsches Vertrauen schafft.

Getrennt von den Arbeitssystemen. Dokumentationen, die in einem vom Ticketingsystem, RMM und PSA getrennten Tool gespeichert sind, erfordern einen Kontextwechsel, der die Nutzung einschränkt. Dokumentationen, die direkt im Service-Ticket, in der entsprechenden Netzwerktopologie, im Anmeldedatensatz des Geräts oder in der Standardarbeitsanweisung (SOP) für diese Art von Problem sichtbar sind, werden genutzt. Dokumentationen, für die man einen separaten Tab öffnen und danach suchen muss, werden hingegen nicht genutzt.

Was sollte in der IT-Dokumentation enthalten sein?

Der Umfang der IT-Dokumentation in einem gut geführten MSP oder internen IT-Team umfasst sechs Kategorien, die jeweils aufeinander aufbauen.

Bestandsaufnahme der Geräte. Jedes Gerät in der Umgebung: Server, Workstations, Netzwerkgeräte, Drucker, mobile Geräte. Für jedes Gerät: Marke, Modell, Seriennummer, Betriebssystemversion, IP-Adresse, Standort, Eigentümer, Ablauf der Garantie sowie die für den Support relevante installierte Software. Die Gerätedaten bilden die Grundlage, an die sich alles andere anknüpft.

Netzwerkdokumentation. Netzwerktopologiediagramme, die physische und logische Verbindungen, VLAN-Konfigurationen, IP-Adressierungsschemata sowie WAN- und Internetverbindungen darstellen. Für MSPs bedeutet dies eine kundenspezifische Netzwerkdokumentation, die die aktuelle Umgebung widerspiegelt und nicht den Stand zum Zeitpunkt der Kundenaufnahme vor zwei Jahren.

Anmeldedaten und Passwörter. Sicher gespeicherte, zugriffskontrollierte Anmeldedaten für alle Systeme: Administratorpasswörter, API-Schlüssel, Anmeldedaten für Cloud-Dienste und Passwörter für die Geräteverwaltung. Die Dokumentation der Anmeldedaten muss autorisierten Technikern bei Vorfällen auch außerhalb der Geschäftszeiten zugänglich sein und gleichzeitig vor unbefugtem Zugriff geschützt sein. „ IT Glue “ bietet eine verschlüsselte Speicherung von Anmeldedaten mit AES-256-Bit-Verschlüsselung, rollenbasiertem Zugriff, obligatorischer MFA und automatischer Passwortrotation, um zu verhindern, dass Anmeldedaten veralten.

Standardarbeitsanweisungen (SOPs). Schritt-für-Schritt-Anleitungen für gängige Aufgaben: Einarbeitung neuer Benutzer, Gerätebereitstellung, Überprüfung von Backups, Bereitstellung von Sicherheitspatches und Reaktion auf Vorfälle bei häufig auftretenden Problemtypen. SOPs senken die Anforderungen an das Fachwissen für Routineaufgaben und ermöglichen eine einheitliche Ausführung im gesamten Team, unabhängig davon, wer gerade verfügbar ist.

Konfigurationsdatensätze. Dokumentierte Konfigurationen für Server, Firewalls, Switches und kritische Anwendungen, die die Wiederherstellung der korrekten Konfiguration nach einem Ausfall oder einer Änderung ermöglichen und als Grundlage für das Änderungsmanagement dienen. Ein Konfigurationsdatensatz, der seit seiner Bereitstellung nie aktualisiert wurde, stellt bei der Wiederherstellung ein Risiko dar.

Beziehungskarten. Dokumentation, die aufzeigt, in welcher Beziehung Ressourcen, Dienste, Benutzer und Anwendungen zueinander stehen. Ein Serverdatensatz, aus dem hervorgeht, welche Clients von ihm abhängig sind, welche Anwendungen darauf laufen und welche Dienste ihn benötigen, liefert den Kontext, der die Fehlerbehebung beschleunigt und die Abschätzung der Auswirkungen von Änderungen wesentlich genauer macht.

Die Struktur: Verknüpfung von Ressourcen, Mitarbeitern und Prozessen

Der Wert von IT-Dokumentation ist nicht additiv, sondern multiplikativ, wenn Informationen miteinander verknüpft statt isoliert gespeichert werden. Ein Service-Ticket, das den entsprechenden Gerätedatensatz anzeigt, der wiederum mit dem Netzwerkdiagramm verknüpft ist, das wiederum mit dem Runbook für diese Art von Problem verknüpft ist, das die zur Behebung erforderlichen Anmeldedaten enthält – genau das verkürzt die Lösungszeit spürbar.

Stellen Sie sich ein typisches Szenario vor. Es ist Freitag, 23 Uhr, und ein Kunde ruft an, weil sein Dateiserver nicht erreichbar ist. Ein Techniker, der mit der Umgebung dieses Kunden weniger vertraut ist, muss das Problem schnell diagnostizieren. Wenn die Dokumentation vernetzt ist, werden im Ticket die Serverkonfiguration, die Netzwerktopologie mit dem vorgelagerten Switch und dessen Zugangsdaten sowie die zuletzt als funktionsfähig bekannte Konfiguration angezeigt – so kann der Techniker innerhalb weniger Minuten mit der Diagnose beginnen. Ist die Dokumentation hingegen nicht vernetzt, muss der Techniker entweder jemanden anrufen, der sich in der Umgebung auskennt, oder im Blindflug arbeiten.

Der Aufbau dieser vernetzten Struktur erfordert eine Dokumentationsplattform mit relationalen Funktionen und kein einfaches Dateirepository. IT Glue wurde speziell für dieses Modell vernetzter Assets entwickelt: Assets, Standorte, Kontakte, Passwörter und Dokumente sind alle miteinander sowie mit den Organisationen, für die sie bestimmt sind, verknüpft.

Für MSPs muss die relationale Struktur zudem mandantenfähig sein. Die Dokumentation jedes Kunden muss in einer eigenen Organisationshierarchie isoliert sein, dabei aber über alle Kunden hinweg eine einheitliche Struktur aufweisen, damit Techniker sich in jeder Kundenumgebung ohne erneute Einarbeitung zurechtfinden können.

Die Dokumentation auf dem neuesten Stand halten

Dokumentation veraltet in dem Moment, in dem sich die Umgebung ändert – was in jeder aktiven IT-Umgebung ständig geschieht. Die Strategien, mit denen Dokumentation tatsächlich auf dem neuesten Stand gehalten wird, sind struktureller Natur und nicht periodisch.

Automatische Erkennung und Bestandsabgleich. RMM-Plattformen, die Geräte automatisch erkennen und Bestandsdaten mit der Dokumentationsplattform abgleichen, machen den manuellen Aktualisierungszyklus für Bestandsdaten überflüssig. Durch die Integration von „ IT Glue“ mit Datto RMM werden neue Geräte, die vom RMM-Agenten erkannt werden, automatisch in „ IT Glue “ übernommen. Wenn ein neuer Endpunkt in die Umgebung aufgenommen wird, wird die Dokumentation automatisch aktualisiert, ohne dass jemand ein Ticket erstellen muss, um die Daten anzupassen.

Ebenso dokumentiert „ Network Glue “, ein Bestandteil von „ Kaseya 365 Ops“, automatisch die Netzwerktopologie einschließlich Switch-Ports, Geräteverbindungen und Netzwerkdiagramme und aktualisiert „ IT Glue “ direkt, ohne dass eine manuelle Erstellung von Diagrammen erforderlich ist. Für MSPs, die Dutzende von Kundenumgebungen verwalten, bedeutet dies den Unterschied zwischen Netzwerkdiagrammen, die stets auf dem neuesten Stand sind, und solchen, die den Zustand des Netzwerks zum Zeitpunkt der Kundenaufnahme widerspiegeln.

Disziplin beim Änderungsmanagement. Jede Änderung an der Umgebung, jede Konfigurationsänderung, jedes neu hinzugefügte Gerät, jede Aktualisierung von Anmeldedaten und jede Bereitstellung einer neuen Anwendung muss als festgelegter Schritt im Änderungsprozess eine entsprechende Aktualisierung der Dokumentation beinhalten. Änderungsmanagement und Pflege der Dokumentation sind keine getrennten Vorgehensweisen. Sie sind ein und dieselbe Vorgehensweise. Die Dokumentationsplattform sorgt nicht für die Einhaltung dieser Vorgabe; dies geschieht durch die Prozessdisziplin.

KI-gestützte Erstellung von Standardarbeitsanweisungen (SOPs). Hier revolutioniert der „Cooper Copilot“ von IT Gluedie Dokumentation. Der „Smart SOP Generator“ erfasst jeden Klick, jeden Tastenanschlag und jede Aktion, während ein Techniker einen Prozess in seinem Browser durchführt, und wandelt diese Aktionen automatisch in eine strukturierte, schrittweise Standardarbeitsanweisung um, die direkt auf IT Glue gespeichert wird. Der Techniker führt die Arbeit einmal aus; die Dokumentation wird automatisch erstellt.

In den ersten sechs Monaten nach der Markteinführung haben die Kunden von „ IT Glue “ mithilfe des „Smart SOP Generator“ mehr als 100.000 SOPs erstellt. Diese Zahl verdeutlicht, was passiert, wenn die Erstellung von Dokumentationen keinen separaten, nachträglichen Aufwand mehr erfordert.

Cooper Copilot umfasst außerdem „Smart Relate“, das anhand der Interaktionen zwischen Assets automatisch Beziehungen zwischen diesen identifiziert und vorschlägt, sowie „Smart Assist“, das veraltete, doppelte oder abgelaufene Dokumente kennzeichnet, sodass Teams die Genauigkeit ohne manuelle Überprüfung gewährleisten können.

Regelmäßige strukturierte Überprüfungen. Die automatisierte Synchronisierung und die KI-gestützte Erstellung decken die fortlaufende Dokumentation ab, die im Rahmen der normalen Arbeit erfolgt. Regelmäßige strukturierte Überprüfungen erfassen die Abweichungen, die die Automatisierung nicht abdeckt: Konfigurationen, die außerhalb des normalen Änderungsmanagements geändert wurden, Ressourcen, die ohne Aktualisierung der Dokumentation außer Betrieb genommen wurden, sowie Verfahren, die sich gegenüber der dokumentierten Version weiterentwickelt haben. Die Zuweisung von Verantwortlichkeiten für Dokumentationskategorien und die Verknüpfung der Überprüfungen mit den Service-Bereitstellungszyklen anstelle von Kalenderterminen sorgt für eine konsistentere Abdeckung.

IT-Dokumentation für MSPs

Für MSPs ist die IT-Dokumentation sowohl eine interne betriebliche Ressource als auch ein direkter Faktor für die Servicequalität und den geschäftlichen Nutzen.

Operative Effizienz. Eine einheitliche und lückenlose Dokumentation für alle Kunden ermöglicht es jedem Techniker, jede Kundenumgebung zu betreuen, ohne auf institutionelles Wissen oder eine Einweisung durch ein bestimmtes Teammitglied angewiesen zu sein. Dies ist es, was eine skalierbare Dienstleistungserbringung ermöglicht. Ein MSP, bei dem jeder Techniker allein anhand der Dokumentation jeden Kunden betreuen kann, ist grundsätzlich skalierbarer als ein MSP, bei dem Kunden faktisch bestimmten Personen zugeordnet sind.

Geschwindigkeit der Einarbeitung von Technikern. Neue Techniker, die Zugriff auf vollständige Kundendokumentation, Netzwerkdiagramme, Gerätedaten, Standardarbeitsanweisungen (SOPs) und Zugangsdaten haben, sind deutlich schneller einsatzfähig als diejenigen, die auf informellen Wissenstransfer angewiesen sind. Die Qualität der Dokumentation bei der Einarbeitung ist einer der wichtigsten Faktoren dafür, wie schnell neue Mitarbeiter ihre volle Leistungsfähigkeit erreichen.

Kundenbindung. Eine umfassende Dokumentation ermöglicht einen besseren Service: schnellere Lösungszeiten, weniger wiederholte Fragen, proaktiveres Management. Kunden, die durchweg schnellen und kompetenten Support erfahren, ziehen einen Wechsel messbar seltener in Betracht. Die Dokumentation ist selten der Grund, warum ein Kunde bleibt, aber eine mangelhafte Dokumentation ist oft die eigentliche Ursache für Serviceausfälle, die dazu führen, dass Kunden abwandern.

Compliance und Prüfungsbereitschaft. Für MSPs, die Kunden im Rahmen von Compliance-Rahmenwerken wie HIPAA, SOC 2 und „ DSGVO “ betreuen, ist die Dokumentation ebenfalls eine Compliance-Anforderung. „ IT Glue “ ist nach SOC 2 Typ II zertifiziert und bietet den unveränderlichen Prüfpfad, Zugriffskontrollen und die Erstellung von Nachweisen, die compliance-bewusste Kunden und ihre Prüfer benötigen.

Geschäftskontinuität. Eine umfassende Dokumentation schützt den eigenen Betrieb des MSP. Wenn ein erfahrener Techniker kurzfristig das Unternehmen verlässt, führt das Wissen, das er im Kopf hatte, zu einer Lücke, die sich in Serviceausfällen und Kundenbeschwerden niederschlägt. Dank einer lückenlosen Dokumentation ist das institutionelle Wissen im System verankert und nicht an eine bestimmte Person gebunden.

Die Wahl der richtigen Plattform

Für die IT-Dokumentation ist eine speziell dafür entwickelte Plattform erforderlich, kein allgemeines Wiki, keine SharePoint-Struktur und kein freigegebener Ordner. Die Anforderungen, auf die es für MSPs und interne IT-Teams tatsächlich ankommt:

Mandantenfähigkeit. Isolierung pro Mandant bei einheitlicher Struktur und globaler Suche über alle Mandanten hinweg. Ein MSP muss von einer einzigen Benutzeroberfläche aus alle Mandantenumgebungen durchsuchen können, ohne dabei die Grenzen der Mandantendaten zu überschreiten.

Relationale Architektur. Assets, Anmeldedaten, Kontakte und Dokumente sind miteinander verknüpft und werden nicht als einfache Listen gespeichert. Die Möglichkeit, von einem Gerätedatensatz zu dem Netzwerk, in dem es sich befindet, zu den Anmeldedaten für den Zugriff darauf und schließlich zur Standardarbeitsanweisung (SOP) zur Behebung von Problemen mit diesem Gerät zu navigieren – alles auf einer einzigen Plattform.

Sichere Verwaltung von Anmeldedaten. Verschlüsselte Speicherung mit rollenbasiertem Zugriff, Protokollierung von Zugriffen und automatischer Passwortrotation. Ein in die Dokumentationsplattform integrierter Passwort-Tresor – im Gegensatz zu einem separaten Tool, für das ein eigener Zugriff erforderlich ist – macht den Unterschied zwischen Anmeldedaten, die tatsächlich genutzt werden, und solchen, die zugunsten von Haftnotizen umgangen werden.

RMM- und PSA-Integration. Die Dokumentation ist in den Service-Tickets einsehbar und mit den RMM-Gerätedatensätzen verknüpft. Das Seitenpanel „ IT Glue “ in den PSA- und BMS-Oberflächen von „ Autotask “ zeigt relevante Dokumentation direkt im Ticket an, ohne dass der Techniker den Kontext wechseln muss. Dieser Zugriff direkt im Arbeitsablauf ist der entscheidende Faktor für die tägliche Nutzung.

KI-gestützte Pflege. Die Plattformen, die langlebige Dokumentationssysteme hervorbringen, sind diejenigen, bei denen die Erstellung und Pflege als Nebenprodukt der normalen Arbeit erfolgen und nicht als separater Arbeitsschritt, der für „später“ eingeplant wird. Der „Smart SOP Generator“ und „Smart Relate“ von Cooper Copilot sind die Umsetzungen dieses Prinzips auf IT Glue.

IT Glue, das als Teil von „ Kaseya 365 Ops“ zusammen mit „ Autotask PSA“, „BMS“, „ Network Glue “, „ myITprocess “ und „ MyGlue “ verfügbar ist, ist die Dokumentationsplattform, die speziell für MSPs und IT-Teams entwickelt wurde und genau auf dieses Modell mit verknüpften Assets und Integration als oberster Priorität ausgerichtet ist. Entdecken Sie „ IT Glue “ und „ Kaseya 365 Ops“.

Die wichtigsten Erkenntnisse

• Eine gute IT-Dokumentation ist ein lebendiges Betriebsgut: präzise, aktuell, vernetzt und täglich im Einsatz. Eine Dokumentation, die einmal erstellt und dann nicht mehr gepflegt wird, ist kein Sicherheitsnetz, sondern eine aktive Quelle für Fehlinformationen im Falle von Vorfällen.
• Eine vollständige Dokumentation umfasst Anlagen, Netzwerktopologie, Zugangsdaten, Standardarbeitsanweisungen, Konfigurationen und Beziehungsdiagramme, wobei jedes Element mit den anderen verknüpft ist. Eine flache, in Silos gegliederte Dokumentation verpasst den zusätzlichen Mehrwert, den eine vernetzte Struktur bietet.
• Um die Dokumentation auf dem neuesten Stand zu halten, sind eine automatisierte Synchronisierung der Erfassung, die KI-gestützte Erstellung von Standardarbeitsanweisungen (SOPs), ein konsequentes Änderungsmanagement sowie regelmäßige strukturierte Überprüfungen erforderlich. Regelmäßige Dokumentations-Sprints sind kein nachhaltiges Modell für die Pflege der Dokumentation.
• Der „Smart SOP Generator“ von IT Glue erfasst die Dokumentation während der Arbeit der Techniker und wandelt jeden Arbeitsablauf automatisch in eine strukturierte Standardarbeitsanweisung (SOP) um. Die Kunden von haben in den ersten sechs Monaten nach der Markteinführung mehr als 100.000 SOPs erstellt.
• Für MSPs bildet die Dokumentation die betriebliche Infrastruktur, die eine konsistente Servicebereitstellung in großem Maßstab, eine schnelle Einarbeitung von Technikern, die Einhaltung gesetzlicher Vorschriften sowie den Schutz vor Wissensverlust beim Ausscheiden von Teammitgliedern ermöglicht.