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 % an, wodurch die Qualität der Dokumentation zu einem direkten Wettbewerbsvorteil und nicht mehr nur zu einer operativen Annehmlichkeit wurde . 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 längst ausgeschiedenen Technikern verfasst wurden – all das erweckt den Anschein, als sei das Wissen dokumentiert, bietet aber 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, die Unternehmen erst unter den denkbar ungünstigsten Umständen bemerken – nämlich dann, wenn diese Personen nicht verfügbar sind. IT Glue 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.

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. Eine Dokumentation, die zum Zeitpunkt ihrer Erstellung korrekt war, wird mit den Veränderungen in 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. Wenn Dokumentation in der Ordnerstruktur eines gemeinsamen Laufwerks vergraben ist, in einem privaten Notizbuch gespeichert wird oder nur im Gedächtnis eines Teammitglieds vorhanden ist, verfehlt sie ihren eigentlichen Zweck: nämlich 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 lückenhafte Dokumentation, die manche Systeme erfasst, andere jedoch nicht, die bestimmte Abläufe festhält, die Routinemaßnahmen jedoch auslässt, und die zwar einige Zugangsdaten auflistet, aber wichtige Konten außer Acht lässt, führt zu einer unzuverlässigen Dokumentation. Wenn Techniker nicht darauf vertrauen können, dass die Dokumentation vollständig ist, hören sie auf, sich darauf zu verlassen. Ein lückenhaftes Dokumentationssystem ist oft schlimmer als gar kein System, da es ein falsches Gefühl der Sicherheit vermittelt.

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 Anlagen. Jedes Gerät in der Umgebung: Server, Workstations, Netzwerkgeräte, Drucker, mobile Geräte. Für jede Anlage: Marke, Modell, Seriennummer, Betriebssystemversion, IP-Adresse, Standort, Eigentümer, Ablauf der Garantie sowie die für den Support relevante installierte Software. Die Anlagendaten bilden die Grundlage, auf die sich alles andere stützt.

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, gleichzeitig aber vor unbefugtem Zugriff geschützt sein. IT Glue 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. 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 Problemen. Standardarbeitsanweisungen 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. Eine Dokumentation, die aufzeigt, wie Ressourcen, Dienste, Benutzer und Anwendungen miteinander in Verbindung 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: Vermögenswerte, Menschen und Prozesse miteinander verbinden

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 Lösung 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, zeigt das Ticket die Serverkonfiguration an, die mit der Netzwerktopologie verknüpft ist, welche den vorgelagerten Switch und dessen Anmeldedaten anzeigt, die wiederum mit der zuletzt bekannten funktionierenden Konfiguration verknüpft sind, kann der Techniker innerhalb von Minuten mit der Diagnose beginnen. Wenn die Dokumentation flach strukturiert ist, muss der Techniker entweder jemanden anrufen, der die Umgebung kennt, oder blind arbeiten.

Der Aufbau dieser vernetzten Struktur erfordert eine Dokumentationsplattform mit relationalen Funktionen und kein einfaches Datei-Repository. IT Glue speziell für dieses Modell vernetzter Assets entwickelt: Assets, Standorte, Kontakte, Passwörter und Dokumente sind alle miteinander und mit den Organisationen, denen sie dienen, 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 strukturell einheitlich bleiben, damit Techniker sich in jeder Kundenumgebung ohne Umgewöhnung 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, die die Dokumentation tatsächlich auf dem neuesten Stand halten, sind struktureller Natur und nicht periodisch.

Automatische Erkennung und Bestandsabgleich. RMM-Plattformen, die Geräte automatisch erkennen und Bestandsdaten mit der Dokumentationsplattform abgleichen, machen manuelle Aktualisierungen der Bestandsdaten überflüssig. Durch die Integration IT Gluemit 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.

Ebenso dokumentiert Network Glue, ein Bestandteil von Kaseya 365 , automatisch die Netzwerktopologie einschließlich Switch-Ports, Geräteverbindungen und Netzwerkdiagramme und aktualisiert IT Glue direkt, IT Glue eine manuelle Erstellung von Diagrammen erforderlich ist. Für MSPs, die Dutzende von Kundenumgebungen verwalten, ist dies der Unterschied zwischen Netzwerkdiagrammen, die stets auf dem neuesten Stand sind, und solchen, die das Netzwerk so abbilden, wie es zum Zeitpunkt der Kundenaufnahme bestand.

Disziplin im Änderungsmanagement. Jede Änderung an der Umgebung, jede Konfigurationsänderung, jedes 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 Dokumentationspflege sind keine getrennten Vorgehensweisen. Sie sind ein und dieselbe Vorgehensweise. Die Dokumentationsplattform sorgt nicht dafür; dies geschieht durch die Prozessdisziplin.

KI-gestützte Erstellung von Standardarbeitsanweisungen (SOPs). Hier revolutioniert der „Cooper Copilot“ 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 in 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 erstellten IT Glue mithilfe des Smart SOP Generators mehr als 100.000 SOPs. 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 Lücken, die die Automatisierung nicht abdeckt: Konfigurationen, die außerhalb des regulären Ä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 Service-Bereitstellungszyklen anstelle von Kalenderterminen sorgen für eine konsistentere Abdeckung.

IT-Dokumentation für MSPs

Für MSPs ist die IT-Dokumentation sowohl ein internes Betriebsmittel 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.

Schnelle Einarbeitung von Technikern. Neue Techniker, die Zugang zu vollständigen Kundendokumentationen, Netzwerkdiagrammen, Gerätedaten, Standardarbeitsanweisungen 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 ihn zum Wechsel bewegen.

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 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 leitender 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. Mit einer vollständigen Dokumentation befindet sich das institutionelle Wissen im System und nicht in der Person.

Die Wahl der richtigen Plattform

IT-Dokumentation benötigt eine speziell dafür entwickelte Plattform, kein allgemeines Wiki, keine SharePoint-Struktur und keinen gemeinsamen Ordner. Die Anforderungen, die für MSPs und interne IT-Teams tatsächlich von Bedeutung sind:

Mandantenfähigkeit. Isolierung pro Kunde bei einheitlicher Struktur und globaler Suche über alle Kunden hinweg. Ein MSP muss von einer einzigen Oberfläche aus alle Kundenumgebungen durchsuchen können, ohne dabei die Grenzen der Kundendaten 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 zu den Standardarbeitsanweisungen (SOP) zur Fehlerbehebung zu navigieren – alles auf einer einzigen Plattform.

Sichere Verwaltung von Anmeldedaten. Verschlüsselte Speicherung mit rollenbasiertem Zugriff, Protokollierung und automatischer Passwortrotation. Ein in die Dokumentationsplattform integrierter Passwort-Tresor – statt eines separaten Tools, das einen eigenen Zugang erfordert – macht den Unterschied zwischen Anmeldedaten, die tatsächlich genutzt werden, und solchen, die zugunsten von Haftnotizen links liegen gelassen werden.

Integration von RMM und PSA. Dokumentation, die in Service-Tickets angezeigt wird und mit den RMM-Gerätedatensätzen verknüpft ist. Das IT Glue in Autotask und BMS 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 nachhaltige 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 in IT Glue.

IT Glue, das als Teil von Kaseya 365 neben Autotask , 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 diesem Modell der vernetzten Ressourcen und der integrierten Arbeitsweise basiert. Entdecken Sie IT Glue Kaseya 365 .