Q.wiki MCP-Server – Überblick & Endpoint

Geändert am Fr, 5 Jun um 4:04 NACHMITTAGS

Dieser Artikel erklärt, was der Q.wiki MCP-Server ist, was er kann und wie du den Endpoint deiner Q.wiki-Instanz findest.

Beta: Der Q.wiki MCP-Server befindet sich aktuell in der Beta-Phase. Funktionsumfang und Verfügbarkeit können sich noch ändern.

Was ist MCP?

Über das Model Context Protocol (MCP) – einen offenen Standard – können KI-Tools wie Microsoft Copilot, ChatGPT oder Claude live auf die Inhalte deiner Q.wiki-Instanz zugreifen.

Was der Q.wiki MCP-Server kann (Tools)

Funktion	Was der angebundene Agent damit kann
Volltextsuche	Über alle Module hinweg suchen – Prozesse, Arbeitsanweisungen, Dokumente, Glossar.
Seitenabruf mit Metadaten	Komplette Q.wiki-Seiten inkl. Seitenverantwortlichem, Status und letztem Freigabedatum abrufen.
Rollen & Verantwortlichkeiten	Rollen mit Name und Beschreibung ausliefern (nicht nur als IDs), einzelne Rolle per ID nachschlagen, zuletzt bearbeitete Seiten einer Rolle abrufen – z. B. für Fragen wie „Was sind die aktuellen Themen in meinem Verantwortungsbereich?"
Dateiseiten & Anhänge	Inhalte aus angehängten Dateien werden mitdurchsucht.
Kommentare lesen	Der Agent kann bestehende Diskussionen einbeziehen.
Kommentare schreiben	Der Agent kann Feedback oder Hinweise als Kommentar in Q.wiki hinterlassen (optional, erfordert Schreibrechte bei der Authentifizierung).

Gut zu wissen: Der MCP-Server gibt ausschließlich Inhalte zurück, auf die der angemeldete Nutzer auch direkt in Q.wiki Lesezugriff hat. Bestehende Berechtigungen bleiben vollständig erhalten.

Voraussetzungen

Das Zusatzmodul „API / MCP" ist für deine Q.wiki-Instanz gebucht und freigeschaltet.

Wichtig: Ohne das Zusatzmodul „API / MCP" kannst du keinen MCP-Endpoint freischalten. Du kannst das Modul über das Angebotsformular auf modell-aachen.de (extern) anfordern.

MCP-URL finden

Sobald das Zusatzmodul gebucht ist, ist der MCP-Server automatisch unter folgender URL erreichbar:

https://<tenant>.qwikinow.de/external-api/v1/mcp

Ersetze <tenant> durch den Namen deiner Q.wiki-Instanz. Die URL findest du in Q.wiki unter Mein Account > Mein Profil > Content API – dort kannst du sie direkt kopieren.

Authentifizierung

Der KI-Client authentifiziert sich per OAuth 2.0 – du musst keine Token oder Credentials manuell eingeben. Bei Q.wiki mit Entra-ID-SSO läuft der Login automatisch durch. Jede Verbindung wird nach 30 Tagen automatisch widerrufen und muss dann einmalig neu bestätigt werden.

Im OAuth-Dialog triffst du zwei Entscheidungen:

Unit-Auswahl: Du wählst die Unit aus, deren Inhalte der Agent durchsuchen darf – analog zur normalen Q.wiki-Suche werden ausschließlich Inhalte dieser Unit berücksichtigt.
Berechtigungsumfang: Nur Leserechte (Agent kann suchen und Inhalte lesen) oder zusätzlich Schreibrechte (Agent kann Kommentare in Q.wiki hinterlassen).

Bekannte Einschränkungen

Schreibend nur für Kommentare; das Erstellen von Seitenentwürfen folgt in einer späteren Version.
Nur für Q.wiki NOW! verfügbar – nicht für On-Premises-Installationen.