MCP-Server einrichten

"Analysiere die RAM-Auslastung der Hosts am Standort München in den letzten 6 Stunden." Eine solch typische Aufgabenstellung lässt sich in Checkmk ganz traditionell mit einem Blick auf ein entsprechend erstelltes Dashboard oder einen individuell gestalteten Graphen erledigen. Mit dem Einzug eines MCP-Servers geht dies nun auch über einen KI-Assistenten mit natürlicher Sprache und ad-hoc ohne etwaige Vorabeiten.

Über das Model Context Protocol (MCP) können Sie beliebige kompatible Clients an Checkmk anbinden, beispielsweise ChatGPT, Claude oder LibreChat. Auch das verwendete LLM liegt ganz in Ihrer Hand, seitens Checkmk gibt es hier keinerlei Vorgaben.

Der MCP-Server liefert Status, historische Daten, Konfigurationen, Verfügbarkeiten und so weiter — und das ausschließlich mit Lese-Rechten. Sie können den Zugriff auf diese KI-Schnittstelle also auch Dritten gewähren, ohne zu riskieren, dass diese etwas löschen oder verändern.

Die Einrichtung ist grundsätzlich trivial: Der Server muss in Checkmk aktiviert und im Client registriert werden, der sich wiederum via OAuth am Server authentifizieren muss.

Im Folgenden lesen Sie, wie genau der MCP-Server mit ausgewählten Clients eingerichtet wird, welche Voraussetzungen geschaffen werden müssen und was Sie damit erreichen können.

Folgende Voraussetzungen müssen erfüllt sein:

Besonderes Augenmerk gilt dem letzten Punkt: Die Absicherung per HTTPS ist notwendig, da die Authentifizierung über OAuth läuft, das wiederum TLS benötigt.

In der Praxis stehen die Chancen gut, dass die TLS-Verbindung bereits vor dem Instanz-Apache-Server terminiert wird, beispielsweise durch irgendeine Art von Proxy- oder auch schlicht den System-Apache-Server. In diesem Fall muss die terminierende Anwendung X-Forwarded-Proto: https senden. Somit läuft zwar die Verbindung zwischen Checkmk/MCP-Server und terminierender Komponente über HTTP, aber der Server weiß, dass die Anfrage vom Client aus korrekt HTTPS-gesichert gestellt wurde. Eine beispielhafte Apache-Konfiguration finden Sie im Artikel Weboberfläche per HTTPS absichern.

Sobald die Voraussetzungen stehen, ist die Einrichtung in drei Schritten erledigt.

Aktivieren Sie zunächst den MCP-Server unter Setup > General > Global settings > AI features > Enable MCP server.

Registrieren und authentifizieren Sie den MCP-Server anschließend in Ihrem Client mit folgender URL: https://myserver/mysite/check_mk/mcp.

Die Registrierung ist im Grunde immer gleich, kann aber auf unterschiedliche Arten vorgenommen werden, etwa über die grafischen Oberflächen, die Kommandozeile oder Config-Dateien. Folgend finden Sie jeweils ein Beispiel:

Die eigentliche Authentifizierung ist dann unabhängig vom genutzten Client immer gleich: In einem neuen Browser-Tab öffnet sich der OAuth-Dialog, um die Verbindung zu bestätigen — natürlich durch einen für die Konfiguration berechtigten Nutzer.

Die authentifizierte Verbindung finden Admins in Checkmk unter Setup > General > Registered OAuth clients, wo sie diese auch löschen können.

Persönliche OAuth-Tokens können Nutzer zudem über User > Oauth access tokens einsehen und zurückziehen.

Rein optional können Sie die Übertragung von MCP-Nutzungsdaten an Checkmk aktivieren. Das hilft uns, die Nutzung des MCP-Features besser zu verstehen und es zu verbessern. Sie finden die Einstellung unter Setup > General > Global settings > AI features > Send MCP usage data to Checkmk. Die Daten werden als OpenTelemetry-Traces an https://mcp-analytics.checkmk.com:54829 geschickt — sofern eine Firewall oder ein Proxy zwischengeschaltet ist, müssen Host und Port entsprechend freigegeben werden.

Und natürlich werden keinerlei Prompts und sonstige Inhalte geteilt!

Sobald die Verbindung steht, hier ein Tipp für Ihre erste Anfrage: Welche Tools stehen zur Verfügung? MCP arbeitet mit einzelnen Tool-Definitionen, beispielsweise get_hosts zur Abfrage der Hosts. Initial arbeitet der MCP-Server mit 13 separaten Tools, wird aber kontinuierlich erweitert — daher ergäbe es wenig Sinn, die Tools hier einzeln aufzulisten. Fragen Sie einfach die KI!

Generell müssen Sie sich auch nicht unbedingt um einzelne Tools kümmern: Clients wie ChatGPT und Claude entscheiden eigenständig, welche Tools für Anfragen benötigt werden. Aber Sie können sich sehr wohl mit einzelnen Tools beschäftigen und zum Beispiel in LibreChat Agenten einrichten, denen nur get_hosts oder nur get_availability zur Verfügung stehen. Wenn Sie beispielsweise mit API-Tokens statt Pauschalangeboten arbeiten, ließe sich so der Token-Verbrauch optimieren.

Natürlich können Sie die KI-Schnittstelle nutzen, um sich eine Übersicht über das Monitoring, einzelne Netzwerksegmente oder Geschäftsanwendungen zu verschaffen. Entwickelt haben wir den MCP-Server aber vor allem für die Root-Cause-Analyse (RCA) — hierzu ein paar Beispiele aus der Praxis.