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, ebenso wie die Pflege von Glossarbegriffen, das Verwalten von Bewertungserinnerungen, die Durchführung zugewiesener Aufgaben und das Versenden von Artikel-Feedback – 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.
-
MCP ist auf Business- und Enterprise-Tarifen verfügbar. Wenn Ihr Projekt einen anderen Tarif hat, fordert die AI-Einstellungen > MCP-Seite Sie auf, ein Upgrade durchzuführen, bevor Sie MCP aktivieren können.
Wenn Ihr Projekt bereits auf einem Business- oder Enterprise-Plan ist, aber die MCP-Seite trotzdem eine Upgrade-Eingabe anzeigt, bestätigen Sie zuerst Ihren aktuellen Plan unter Settings > Knowledge Base Portal > Billing > My Plan. Wenn der Reiter "Mein Plan" korrekt Business oder Enterprise anzeigt und die MCP-Seite weiterhin den Zugriff blockiert, wenden Sie sich an den Document360-Support, damit das Team die Berechtigung Ihres Projekts überprüfen kann.
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 deinen KI-Assistenten zu verbinden, siehe Verbinden von MCP mit deinem KI-Assistenten.
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.
- Schreibvorgänge (wie das Erstellen oder Aktualisieren von Artikeln, Kategorien und Glossarbegriffen) sind nur möglich, wenn der authentifizierte Benutzer die entsprechenden Berechtigungen hat.
- 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.
- Aufgabentools zeigen nur Aufgaben an und reagieren darauf, die dem authentifizierten Benutzer zugewiesen sind, direkt oder über eine Gruppe.
- Artikel-Feedback, das über MCP gesendet wird, wird gegen den authentifizierten Nutzer erfasst. Leserkonten können Artikel-Feedback senden, können aber keine anderen Schreibwerkzeuge verwenden.
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, kontextuelle Abrufe, kontrollierte Inhaltsupdates, Workflow-Management, Veröffentlichungsoperationen, Glossarverwaltung, Bewertungserinnerungen, Aufgabenverwaltung und Artikelfeedback.
Wenn Document360 neue MCP-Tools veröffentlicht, erkennt Ihr KI-Assistent sie nicht automatisch. Aktualisieren Sie die Werkzeugliste in Ihrem KI-Assistenten oder trennen Sie den Document360-Connector und verbinden Sie ihn wieder, um sie zu nutzen.
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 überall in deiner Dokumentation ein exaktes Wort oder eine Phrase und liefert jede Artikel- und Seitenkategorie, die sie enthält, 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. |
document360-mcp-list-glossary-terms |
Listet die Glossarbegriffe des Projekts auf, einschließlich der Definition jedes Begriffs und der Sprachvarianten. |
document360-mcp-list-review-reminders |
Listet die Artikel und Seitenkategorien in einem Arbeitsbereich auf, die eine Rezensionserinnerung enthalten, egal ob veraltet oder geplant, mit dem frühesten Bewertungsdatum zuerst. |
document360-mcp-get-my-tasks |
Listet die Ihnen in einem Arbeitsbereich zugewiesenen Aufgaben auf, einschließlich Workflow-Zuweisungen, Leserfeedback und Erinnerungen für Wiederholungen. Dies ist dieselbe Liste wie die Aufgaben-Seite im Portal . |
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. |
document360-mcp-create-glossary-term |
Fügt dem Glossar einen neuen Begriff hinzu, entweder als globaler Begriff oder als Sprachbegriff für eine Sprache. |
document360-mcp-update-glossary-term |
Aktualisiert den Begriff oder die Definition eines Glossars. Nur die Felder, die du änderst, werden aktualisiert. |
document360-mcp-set-article-review-reminder |
Plant eine Überprüfungserinnerung für einen Artikel, markiert ihn jetzt zur Überprüfung oder löscht die Erinnerung. |
document360-mcp-snooze-task |
Schlägt eine Ihrer Aufgaben bis zu einem bestimmten Datum oder bringt eine ausgeschlafene Aufgabe zurück. |
document360-mcp-mark-task-done |
Markiert eine Ihrer Workflow-Aufgaben als erledigt, genauso wie auf der Aufgaben-Seite als erledigt markieren. Es ändert den Workflow-Status nicht. |
document360-mcp-update-feedback-status |
Aktualisiert den Status, den zugewiesenen Empfänger oder die interne Notiz des Leserfeedbacks. |
document360-mcp-send-article-feedback |
Sendet Feedback zu einem veröffentlichten Artikel an Ihr Dokumentationsteam, zum Beispiel wenn Inhalte unklar, veraltet oder fehlende Informationen sind. Das Feedback erscheint im Feedback-Manager. |
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.