MCP — einen externen KI-Agenten mit Omniscol verbinden

Was der Agent tun kann

Der MCP-Agent funktioniert sehr gut bei reinen Abfragen, bei denen die Daten in Omniscol liegen:

• „Geben Sie mir die Raumbelegungsquote im Verhältnis zu den Öffnungszeiten in dieser Woche.“
• „Finden Sie mir einen Raum, der an drei Montagen im Oktober im gleichen Zeitfenster von 2 Stunden verfügbar ist.“
• „Wie viele Unterrichtsstunden hat Jean Dupont im laufenden Schuljahr gehalten?“
• „Welches sind alle Mathematik-Unterrichtsstunden von heute?“
• „Listen Sie die Lehrkräfte auf, die in diesem Trimester weniger als 70 % ihrer Dienststunden geleistet haben.“

Diese Abfragen kombinieren typischerweise mehrere Werkzeuge: Stundenplan, statistische Dashboards, berechnete Verfügbarkeiten, Lehrkraft-Datensätze. Der Agent orchestriert die Aufrufe und formuliert die Antwort in natürlicher Sprache.

Die bereitgestellten Werkzeuge

Der MCP-Server baut seine Werkzeuge aus den Omniscol-API-Routen auf, die für MCP freigegeben sind. Ausdrücklich ausgeschlossene Routen und bestimmte technische Module (zum Beispiel solche, die mit der Authentifizierung der Benutzer zusammenhängen) werden nicht zu Werkzeugen. Die Liste spiegelt daher die für MCP bereitgestellte API wider, nicht die gesamte interne Oberfläche der Anwendung. Es ist gleichwohl ein sehr großer Teil. Darüber hinaus gibt es eine Reihe von Routen, die MCP vorbehalten sind und von Omniscol selbst nicht genutzt werden. Das ist der Fall bei Werkzeugen zur erweiterten Suche, damit ein freier Text, der eine Entität benennt („Lehrkraft Jean Dupont“, „Klasse 6A“), von Omniscol seiner technischen Kennung zugeordnet wird, die anschließend dazu dient, die Daten präzise abzufragen. Das ist auch der Fall bei komplexen Werkzeugen, für die Omniscol keine grafische Oberfläche besitzt, weil sie sich besser für einen Prompt eignen: die Suche nach Belegung und Verfügbarkeit einer Entität zum Beispiel („finde mir einen Raum, der 2 Stunden am Nachmittag an 3 Montagen in Folge verfügbar ist“, „ist eine Mathematik-Lehrkraft in der Woche vom 14. Oktober für 3 Stunden verfügbar?“).

Die Werkzeuge decken insbesondere ab:

• Modul Verwaltung (Benutzer, Fächer, Schuljahre, Einstellungen),
• Modul Stundenplanverwaltung (Konfiguration, Standorte, Räume, Klassen, Unterrichtsstunden),
• Modul Stundenpläne (Stundenplan, Dashboards, Suchen),
• Modul Abwesenheitsverwaltung (Erfassung, Statistiken),
• globale Suche.

Die Leserouten eignen sich am besten für eine agentische Nutzung. Bestimmte Schreiboperationen können im Katalog vorhanden sein, je nach den Rechten des Tokens und der verfügbaren API, aber sie müssen überwacht bleiben: Eine Abfrage, die mehrere fachliche Objekte verändert, muss von einem Benutzer geprüft werden, bevor sie als verlässlich gilt.

Den MCP-Server aktivieren

Der MCP-Server ist auf Premium-Konten verfügbar. Alles geht vom MCP-Bildschirm aus, der über das Modul Verwaltung mit Konfigurieren geöffnet wird: Er zeigt die Server-URL je nach gewähltem Umfang (global oder auf ein Modul beschränkt) an und stellt, kopierbereit, die Konfigurationselemente für Ihren Client bereit.

Die Standardauthentifizierung von MCP ist OAuth2. Ein kompatibler Client (wie Claude) verbindet sich einfach mit der Server-URL, entdeckt dort die OAuth2-Konfiguration des Kontos, und der Benutzer genehmigt den Zugang über einen Zustimmungsbildschirm: Es ist nichts anderes bereitzustellen als die URL. Der gewährte Umfang folgt den Rechten des Kontos und seinen Sichtbarkeitsbeschränkungen. Der OAuth2-Server von Omniscol, sein Bildschirm zur Verwaltung der Clients und die Einzelheiten der Zustimmung sind auf OAuth2 / OIDC (Anbieter) beschrieben.

Für einen Client, der OAuth2 nicht unterstützt, erzeugt derselbe Bildschirm einen Token (API-Schlüssel, Ablaufdatum, optional zugeordneter Benutzer, anzukreuzende Schreibrechte) und bietet dann, einfügebereit, die je nach Fall nützlichen Formate an: Header Authorization: Bearer, URL mit Token, Konfigurationsblock für Claude Desktop (kostenloser Modus) und Befehl für einen lokalen Proxy. Der Token stützt sich auf das Schlüsselsystem, das in Omniscol-API beschrieben ist.

Bewährte Sicherheitspraktiken

• OAuth2-Authentifizierung — praktischer und vorzuziehen, wenn Ihr Agent sie unterstützt (kostenpflichtige Version von Claude).
• Der KI vorbehaltener Token — erstellen Sie einen Token mit einer sprechenden Bezeichnung (KI-Agent — Claude Desktop), den Sie bei Bedarf widerrufen können.
• Minimaler Umfang — wählen Sie bei einem API-Token nur die benötigten API-Zugangspunkte aus. Beschränken Sie bei einem OAuth-Token die Scopes auf den tatsächlichen Bedarf.
• Aktivitätsprotokolle (Logs) — ein Aufruf erscheint in den mit dem Token verknüpften Protokollen, wenn die betreffende Route protokolliert wird. Diese Protokolle zeichnen den Aufruf auf; sie bewahren weder die Einzelheiten der zurückgegebenen Daten noch einen wiederholbaren Inhalt der Abfrage auf.
• Sichtbarkeitsbeschränkungen — der Agent sieht, was Omniscol ihm zurückgibt. Wenn Sie strenge Sichtbarkeitsbeschränkungen für die Rolle des Tokens konfiguriert haben, gelten sie.