Der Model Context Protocol (MCP)-Server in Document360 stellt die Inhalte Ihrer Wissensdatenbank über eine strukturierte Schnittstelle zur Interaktion mit der Dokumentation zur Verfügung. Anstatt auf die Dokumentation als gerenderte Webseiten zuzugreifen, ermöglicht MCP KI-Assistenten (ChatGPT, Claude), direkt mit den zugrundeliegenden Inhalten zu interagieren. Mit aktiviertem MCP wird Ihre Wissensdatenbank durch definierte KI-Assistenten zugänglich, die spezifische Operationen wie Suchen, Abrufen, Erstellen, Aktualisierungen, Veröffentlichen und Verwaltung von Inhaltsworkflows ausführen – alles innerhalb Ihrer bestehenden Projektregeln.
Was ist MCP?
Der MCP ist ein offener Standard, der es KI-Assistenten ermöglicht, sich sicher mit externen Systemen zu verbinden und auf strukturierte Daten zuzugreifen. Anstatt für jeden KI-Assistenten und jede Plattform separate Integrationen zu bauen, bietet MCP eine gemeinsame Schnittstelle, die standardisiert, wie KI-Assistenten mit externen Plattformen kommunizieren.
Ein MCP-Server fungiert als Brücke zwischen einem KI-Assistenten und Ihrem System. Er bietet spezifische Funktionen wie das Durchsuchen von Inhalten, das Abrufen von Dokumenten oder das Durchführen strukturierter Updates über ein definiertes Protokoll. Der KI-Assistent sendet eine strukturierte Anfrage an den MCP-Server, und der Server antwortet mit strukturierten Daten, die der Assistent nutzen kann. Man kann sich MCP als universellen Connector für KI-Integrationen vorstellen. Anstatt für jedes Tool individuelle Verbindungen herzustellen, ermöglicht MCP eine einheitliche, standardisierte Möglichkeit für KI-Assistenten, mit echten, aktuellen Systemen zu interagieren.
Durch die Nutzung von MCP sind KI-Assistenten nicht darauf beschränkt, Antworten allein aus Trainingsdaten zu generieren. Sie können Live-Inhalte abrufen, auf strukturierte Dokumentationen zugreifen und definierte Aktionen über den MCP-Server ausführen, wodurch ihre Ausgaben relevanter und kontextbewusster werden.
Die Herausforderung, der Organisationen mit KI-Assistenten gegenüberstehen,
Viele Organisationen setzen KI-Assistenten ein, wie zum Beispiel:
- ChatGPT
- Claude
- GitHub Copilot
- Interne KI-Agenten
Diese Assistenten haben jedoch oft keinen direkten Zugang zu strukturiertem Geschäftswissen.
Infolgedessen gilt:
- KI-Tools können nicht einfach auf Wissensbasen zugriffen
- Dokumentation ist nicht in KI-Workflows integriert
- Entwickler und Support-Teams Dokumentation manuell kopieren und einfügen
- Die Einhaltung einer konsistenten Dokumentation wird schwierig
Organisationen benötigen eine strukturierte Möglichkeit, KI-Assistenten mit ihren Dokumentationssystemen zu verbinden. Document360 MCP löst dieses Problem.
Warum MCP in Document360
-
Die Dokumentation in Document360 ist über Projektversionen, mehrere Sprachen, Kategorienhierarchien und rollenbasierte Sichtbarkeitseinstellungen hinweg strukturiert. Diese Struktur definiert, wie Inhalte innerhalb Ihrer Wissensdatenbank organisiert, abgerufen und verwaltet werden.
-
Wenn Dokumentation nur über gerenderte Webseiten konsumiert wird, wird ein Großteil dieser Struktur visuell erlebt. Versionskontext, Sprachauswahl und hierarchische Beziehungen sind vorhanden, aber nicht immer explizit, wenn sie programmatisch abgerufen werden.
-
Die Verfügbarkeit von MCP hängt von Ihrer Projektkonfiguration und Ihrem Plan ab. Der MCP Server führt eine standardisierte Möglichkeit ein, mit der KI-Assistenten durch definierte Funktionen wie Suchen, Abrufen, Aktualisierung und Veröffentlichung von Inhalten sowie das Management von Arbeitsabläufen mit Ihrer Dokumentation interagieren können. Anstatt sich ausschließlich auf gerenderte Ausgaben zu verlassen, können KI-Assistenten strukturiert und kontrolliert mit Ihrer Wissensdatenbank interagieren.
Zum Beispiel:
- Suchoperationen können standardmäßig über Projektversionen hinweg erfolgen oder bei Bedarf eine bestimmte Version anvisieren.
- Abgerufene Inhalte respektieren deine konfigurierten Sichtbarkeits- und Berechtigungsregeln.
- Schreibvorgänge folgen dem bestehenden Versionsverhalten und erhalten die Inhaltsstruktur.
- Workflow-Operationen respektieren die konfigurierten Überprüfungsphasen und rollenbasierten Berechtigungen Ihres Projekts.
- Die Veröffentlichungsoperationen folgen denselben Regeln wie das Portal; Inhalte dürfen nur von Nutzern mit den entsprechenden Berechtigungen veröffentlicht oder unveröffentlicht werden.
-
Gleichzeitig arbeitet MCP vollständig innerhalb Ihrer bestehenden Konfiguration. Die Verfügbarkeit von Inhalten spiegelt die Einstellungen Ihrer Projektversion, Ihre Sprachkonfiguration, das Berechtigungsmodell und die Sichtbarkeitsregeln wider. Unveröffentlichte oder eingeschränkte Inhalte bleiben diesen Regeln unterworfen.
Wenn Schreib-, Workflow- oder Veröffentlichungsoperationen stattfinden, bleibt das bestehende Versionsverhalten erhalten. MCP überschreibt keine Dokumentationsworkflows, Veröffentlichungsregeln oder Governance-Kontrollen. Es bietet lediglich einen strukturierten Zugriff auf Ihre Wissensdatenbank und erhält dabei die Integrität Ihres Dokumentationssystems.
Bevor du anfängst
Bevor Sie MCP aktivieren, stellen Sie Folgendes sicher:
- Du hast eine Rolle als Projektleiter oder Administrator . Nur diese Rollen können MCP für ein Projekt aktivieren oder deaktivieren.
- Sie verwenden einen unterstützten KI-Assistenten (ChatGPT, Claude, GitHub Copilot, Cursor IDE oder jede Plattform, die MCP oder benutzerdefinierte Connectoren unterstützt).
Um MCP zu aktivieren und Ihren KI-Assistenten zu verbinden, siehe Connect MCP mit einem benutzerdefinierten Connector.
Authentifizierung und Zugriffskontrolle
MCP verwendet OAuth zur Authentifizierung. Wenn man einen KI-Assistenten über MCP mit Document360 verbindet, ist die Verbindung mit dem Benutzerkonto verknüpft, das den OAuth-Flow abschließt.
Alle MCP-Interaktionen folgen dem rollenbasierten Zugriffskontrollmodell (RBAC) von Document360. Das bedeutet:
- Der KI-Assistent kann nur auf Inhalte zugreifen, die dem authentifizierten Nutzer basierend auf seinen zugewiesenen Rollen und Berechtigungen erlaubt sind.
- Eingeschränkte oder unveröffentlichte Inhalte bleiben durch Ihre bestehenden Sichtbarkeitsregeln geregelt.
- Schreiboperationen (Erstellung oder Aktualisierung von Artikeln und Kategorien) sind nur möglich, wenn der authentifizierte Benutzer die entsprechenden Berechtigungen besitzt.
- Veröffentlichen, Entveröffentlichen und Workflow-Operationen folgen demselben Berechtigungsmodell wie das Portal. Nur Benutzer mit den entsprechenden Berechtigungen können diese Aktionen ausführen.
Das Aktivieren von MCP gewährt externen Tools keinen uneingeschränkten Zugriff auf Ihre Wissensdatenbank.
Document360 MCP-Tools
Der MCP Server bietet eine Liste von Werkzeugen , die definieren, wie Dokumentation durchsucht, abgerufen und verwaltet werden kann.
Jedes Tool stellt eine spezifische und gezielte Aktion gegen Ihre Wissensdatenbank dar. Anstatt Rohinhalte oder offene Endpunkte bereitzustellen, strukturiert MCP Interaktionen durch klar definierte Operationen. Dies stellt sicher, dass der Dokumentationszugriff vorhersehbar, versionsbewusst und mit Ihrer Projektkonfiguration abgestimmt bleibt.
Diese Werkzeuge unterstützen gemeinsam strukturierte Entdeckung, kontextbezogene Abrufe, kontrollierte Inhaltsupdates, Workflow-Management und Veröffentlichungsoperationen.
Such- und Abrufwerkzeuge
| Werkzeug | Beschreibung |
|---|---|
document360-mcp-search |
Führt eine semantische Suche in deinem Wissensdatenbankprojekt durch. Stimmt nach Bedeutung überein, nicht nach genauer Formulierung. Durchsucht standardmäßig alle Projektversionen oder bei Bedarf eine bestimmte Version. |
document360-mcp-find-text |
Findet ein exaktes, groß- und kleinschreibungssensitives Wort oder eine Phrase überall in Ihrer Dokumentation und gibt jede Artikel- und Seitenkategorie zurück, die sie enthalten, mit ihren öffentlichen URLs. |
document360-mcp-list-documents |
Listet Artikel und Seitenkategorien mithilfe von Filtern wie Version, Sprache, Kategorie, Status, Tags, Labels oder Aktualisierungsdatum auf. |
document360-mcp-get-article |
Ruft den vollständigen Artikelinhalt mithilfe einer Artikel-ID oder URL ab. Unterstützt mehrere Sprachen und ermöglicht das Abrufen veröffentlichter oder Entwurfsversionen. |
document360-mcp-get-categories |
Ruft die vollständige Kategorienstruktur für eine ausgewählte Projektversion ab, einschließlich Kindkategorien und zugehöriger Artikel. |
document360-mcp-get-category |
Ruft detaillierte Informationen für eine bestimmte Kategorie ab, einschließlich ihres Inhalts, Unterkategorien und zugehörigen Artikels. |
document360-mcp-get-project-versions |
Listet alle verfügbaren Projektversionen zusammen mit ihren Kennungen auf, wodurch versionsspezifische Operationen ermöglicht werden. |
document360-mcp-get-workflow-statuses |
Listet die für das Projekt konfigurierten Workflow-Status mit ihren Kennungen auf. |
document360-mcp-get-workflow-assignees |
Listet die Benutzer und Gruppen auf, die dem Workflow eines Artikels zugewiesen werden können. |
Diese Werkzeuge ermöglichen strukturierte Entdeckung und kontextuellen Zugriff auf Dokumentationsinhalte.
Schreibwerkzeuge
| Werkzeug | Beschreibung |
|---|---|
document360-mcp-create-article |
Erstellt einen neuen Artikel in einer bestimmten Kategorie und Projektversion. Unterstützt strukturierte Inhaltsformate und erfordert eine Bestätigung vor der Erstellung. |
document360-mcp-update-article |
Aktualisiert einen bestehenden Artikel, während dessen Struktur und Formatierung erhalten bleiben. Unterstützt teilweise Updates und erfordert das Abrufen des Artikels vor der Änderung. |
document360-mcp-create-category |
Erstellt eine neue Kategorie innerhalb einer ausgewählten Projektversion. Unterstützt hierarchische Kategorienstrukturen. |
document360-mcp-update-category |
Aktualisiert Kategorieeigenschaften wie Name, Position, Hierarchie oder Sichtbarkeit innerhalb der Wissensdatenbank. |
document360-mcp-update-category-content |
Aktualisiert den Inhalt der Kategorieseiten (gilt für Seiten- oder Indexkategorien), während die bestehende Struktur erhalten bleibt. |
document360-mcp-publish-article |
Veröffentlicht einen Artikel, indem er den neuesten Entwurf zur Live-Version bewirbt. |
document360-mcp-unpublish-article |
Veröffentlicht einen Artikel und entfernt ihn von der Live-Wissensdatenbank-Website. |
document360-mcp-publish-category |
Veröffentlicht den neuesten Entwurf einer Page-Kategorie in der Live-Version. |
document360-mcp-unpublish-category |
Entveröffentlicht eine Seitenkategorie und entfernt sie von der Live-Wissensdatenbank-Website. |
document360-mcp-set-workflow-status |
Legt den Workflow-Status einer Artikel- oder Seitenkategorie fest, mit optionalem Abgabetermin, Kommentar und Zugewiesenen. |
Schreibvorgänge folgen denselben Versionsverhalten und Inhaltshandhabungsregeln wie der Document360-Editor.
Diese Werkzeuge können einzeln oder in Kombination verwendet werden, um End-to-End-Dokumentationsworkflows zu unterstützen. Zum Beispiel können KI-Assistenten einen Artikel suchen, dessen Inhalt aktualisieren, ihn durch einen Review-Workflow bewegen und ihn in einem einzigen Gespräch auf der Live-Seite veröffentlichen. Das macht MCP geeignet für Automatisierungsszenarien wie Massen-Inhaltsupdates, groß angelegte Dokumentationserstellung, strukturierte Review- und Approval-Workflows sowie die Aufrechterhaltung von Konsistenz über mehrere Artikel hinweg. Die Erfahrung von Prompts und Antworten kann je nach verwendetem KI-Assistenten variieren, da jedes Tool Anfragen unterschiedlich interpretiert und verarbeitet. Sie können überwachen, wie Ihre Wissensdatenbank über MCP mit dem MCP-Server-Analyse-Dashboard abgerufen wird.