Ihr Wiki über MCP an externe KI Agenten anbinden

Hallo Subscriber,

willkommen zu einer weiteren Ausgabe des DokuWiki Newsletters. KI-Agenten werden immer nützlicher, weil sie mehr können, als nur Fragen zu beantworten. Sie können Werkzeuge verwenden und dadurch auf Informationen aus anderen Quellen zugreifen und in Ihrem Auftrag Aufgaben ausführen.

In unseren vorherigen Newslettern haben wir uns mit unserem AI Agent Plugin für DokuWiki beschäftigt, das diese Möglichkeiten direkt ins Wiki bringt.

In dieser Ausgabe geht es darum, wie Sie DokuWiki über das Model Context Protocol (MCP) mit externen KI-Agenten verbinden können. Wir zeigen, wie MCP es diesen Agenten ermöglicht, Informationen aus verschiedenen Systemen abzurufen, miteinander zu verknüpfen und auf dieser Grundlage Aktionen auszuführen.

Wir hoffen, dass Ihnen diese Ausgabe gefällt und Sie einige interessante Anregungen finden.

Ihr CosmoCode DokuWiki Team

DokuWiki als Teil eines KI-Workflows

Besonders interessant werden KI-Agenten, wenn sie Informationen aus mehreren Systemen zusammenführen können.

Nehmen wir einen Support-Mitarbeiter, der ein Kundenticket bearbeitet. Im Ticketsystem steht das konkrete Problem des Kunden, das CRM enthält weitere Informationen zum Kunden und in DokuWiki finden sich die passenden Anleitungen zur Fehlerbehebung und die Produktdokumentation.

Ein KI-Agent kann all diese Quellen zusammenführen. Er kann das Ticket lesen, die Kundendaten aus dem CRM abrufen, in DokuWiki nach der passenden Anleitung suchen und den Mitarbeiter bei der Bearbeitung des Problems unterstützen.

Das gleiche Prinzip lässt sich auf viele andere Arbeitsabläufe übertragen. Ein Vertriebsmitarbeiter kann eine Opportunity aus dem CRM mit Produktinformationen und Vertriebsrichtlinien aus DokuWiki verbinden. Ein IT-Mitarbeiter kann anhand einer Meldung aus dem Monitoring-System das passende Runbook in DokuWiki heraussuchen. Entwickler können Claude Code sowohl mit einem Quellcode-Repository als auch mit der Dokumentation in DokuWiki arbeiten lassen.

Dabei bleibt jedes System für seine eigenen Informationen zuständig. Es stellt diese Informationen über seine jeweiligen eigenen Mechanismen bereit und kümmert sich um die Pflege der Daten. Der KI-Agent führt die benötigten Informationen bei Bedarf zusammen.

Was ist MCP?

MCP steht für Model Context Protocol. Es handelt sich dabei um einen Standard, mit dem Software ihre Funktionen für KI-Systeme bereitstellen kann. Der Agent bekommt dabei Werkzeuge, die auf das jeweilige System zugeschnitten sind: ein openTicket für ein Ticketsystem, ein searchCustomer für ein CRM oder ein readPage für DokuWiki.

Ein KI-System kann gleichzeitig mit mehreren MCP-Servern verbunden sein und deren Werkzeuge nutzen. So kann es bei einer Aufgabe auf Informationen aus verschiedenen Systemen zugreifen. Die Werkzeuge können dabei nicht nur Informationen liefern. Sie können auch Änderungen vornehmen. Ein closeTicket kann beispielsweise ein Ticket schließen, ein writePage eine DokuWiki-Seite ändern.

Das DokuWiki MCP Plugin

Wie Sie sicherlich schon vermutet haben, lässt sich MCP einfach über ein DokuWiki Plugin hinzufügen. Eine erste Version des Plugins wurde bereits Anfang letzten Jahres als Prototyp veröffentlicht. Sie stellt die grundlegenden Funktionen bereit: DokuWikis Remote-API-Mechanismen werden als MCP-Tools zur Verfügung gestellt und die Authentifizierung erfolgt über das Zugriffstoken des Benutzers. Der Agent handelt also im Namen des angemeldeten Benutzers. Für ihn gelten damit dieselben ACLs wie für den Benutzer selbst.

Für die persönliche Nutzung hat das gut funktioniert. Für den Einsatz in Unternehmen gab es allerdings noch einige Einschränkungen. Diese wurden in der Version behoben, die kürzlich im Early Access für unsere DokuWiki Business Plugin Partner veröffentlicht wurde.

Anbindung an zentrale KI-Systeme

In Unternehmen wird der Zugang zu KI häufig zentral bereitgestellt, zum Beispiel über Microsoft 365 Copilot Cowork, Claude oder ChatGPT. Wenn ein solches System auf DokuWiki zugreifen soll, stellt sich allerdings die Frage: Woher weiß DokuWiki, welcher Benutzer gerade auf das Wiki zugreifen möchte?

Hier kommt OAuth ins Spiel. Der Administrator richtet die Verbindung zwischen dem KI-System und dem Wiki einmal ein. Wenn ein Benutzer das Wiki anschließend zum ersten Mal über seinen KI-Agenten verwendet, muss er sich nur noch wie gewohnt in seinem Browser am Wiki anmelden und den Zugriff durch den Agenten erlauben. Der Agent kann danach mit den Berechtigungen dieses Benutzers auf das Wiki zugreifen. Die notwendigen technischen Schritte laufen dabei automatisch ab.

Das funktioniert unabhängig davon, wie sich der Benutzer am Wiki anmeldet. Ob einfache plainauth Authentifizierung, Active Directory, Zwei-Faktor-Authentifizierung oder SSO – für den Agenten macht das keinen Unterschied.

Die neue Plugin-Version bietet darüber hinaus die Möglichkeit, gezielt festzulegen, welche Tools dem Agenten zur Verfügung stehen. Sie können beispielsweise zunächst ausschließlich lesende Werkzeuge freigeben und Schreibzugriffe erst später aktivieren, wenn Sie Erfahrungen mit dem Verhalten Ihrer Agenten gesammelt haben. Die ACLs von DokuWiki gelten natürlich unabhängig davon weiterhin.

Und weil Microsoft die Dinge gerne etwas anders handhabt, gibt es noch eine weitere Neuerung. Damit ein MCP-Endpunkt in Cowork genutzt werden kann, muss zunächst ein spezielles App-Paket hochgeladen werden. Erst danach können Benutzer die MCP-Verbindung verwenden. Das benötigte Paket lässt sich mit unserem Plugin bequem direkt in der DokuWiki-Administration erstellen.

MCP oder DokuWiki AI Agent?

Ist das DokuWiki AI Agent Plugin durch MCP also überflüssig geworden? Ganz und gar nicht. Im Gegenteil: Beide Ansätze können sich sehr gut ergänzen.