agorum core pro als MCP-Server verwenden

Hinweis: Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins ALBERT | AI Agents. Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.

Sie können agorum core mit den KI-Plugins ALBERT | AI und ALBERT | AI Agents als MCP-Server einsetzen. Bei der Installation von ALBERT | AI Agents wird das Konfigurationsprojekt agorum.ai.agents.mcp automatisch mitinstalliert, das dafür notwendig ist.

MCP-Server-Verbindungsinformationen

Wenn Sie ALBERT | AI Agents installiert und eingerichtet haben, können Sie den agorum core pro Server auch als MCP-Server verwenden.

Sie können über folgende URL auf den MCP-Server zugreifen. Tragen Sie dazu für den Platzhalter SERVER die Adresse oder den Namen Ihres agorum core pro Servers ein.

http://<SERVER>.agorum.com/api/rest/custom/agorum.ai.agents.mcp

Zusätzlich benötigen Sie ein JSON Web Token (JWT) für den Benutzer, mit dem die Verbindung hergestellt werden soll. Die Benutzerberechtigungen sind relevant dafür, welche KI-Tools zur Verfügung stehen. Das JWT-Token können Sie in Ihrem agorum core pro Server erzeugen, wenn Sie im Hauptmenü Administration > Werkzeuge > JWT-Generator öffnen.

Beispielverbindung mit dem MCP Inspector

Im folgenden Beispiel wird der MCP Inspector verwendet, um zu zeigen, wie agorum core pro als MCP-Server eingesetzt werden kann. Der MCP Inspector wird als Client verwendet, um KI-Tools im agorum core MCP-Server aufzurufen.

Hinweis: Der MCP Inspector ist ein externes Entwickler-Werkzeug zum Testen und Debuggen von MCP-Servern. Es handelt sich um einen interaktiven Tester mit grafischer Oberfläche, der speziell dafür entwickelt wurde, die Funktionalität von MCP-Servern zu überprüfen. Die vorliegende Dokumentation beschreibt lediglich eigene Erfahrungen im Umgang mit dem MCP Inspector und erhebt keinen Anspruch auf Aktualität und Vollständigkeit.

Voraussetzung:

Der MCP Inspector ist eine Node.js-Anwendung. Sie müssen Node.js in einer aktuellen Version installiert haben, um den MCP Inspector zu verwenden.

Stellen Sie sicher, dass Node.js in einer aktuellen Version installiert ist. Öffnen Sie eine Konsole und geben Sie Folgendes ein:
```
node -v
```
Führen Sie in der geöffneten Konsole folgenden Befehl aus:
```
npx @modelcontextprotocol/inspector
```
Nach Ausführen des Befehls in der Konsole öffnet sich die Weboberfläche des MCP Inspector automatisch in Ihrem Browser oder Sie bekommen die entsprechende URL im Terminal angezeigt.
Der Transport Type in der Weboberfläche des MCP Inspector muss Streamable HTTP sein, nur Streamable HTTP wird für den Client-Zugriff auf den agorum core pro MCP-Server unterstützt.
Geben Sie in der Weboberfläche des MCP Inspector die URL des agorum core pro Servers an.
```
http://<SERVER>.agorum.com/api/rest/custom/agorum.ai.agents.mcp
```
Erzeugen Sie in der agorum core pro Bedienoberfläche ein JWT für Ihren Benutzer unter > Administration > Werkzeuge > JWT-Generator. Verwenden Sie einen Benutzer für den API-Aufruf, der Zugriff auf die KI-Tools hat. Die Zugriffsrechte des Benutzers sind relevant dafür, welche KI-Tools verwendet werden können.
Kopieren Sie das JWT in das Feld Bearer Token in der Weboberfläche des MCP Inspector.
Klicken Sie in der Weboberfläche des MCP Inspector Connect, um die Verbindung zu agorum core pro herzustellen.

Ergebnis: Der MCP Inspector stellt die Verbindung her. Ein Eintrag initialize erscheint in der History.
Klicken Sie im Bereich Tools auf List Tools, um die Liste der verfügbaren KI-Tools abzurufen, die von ALBERT | AI agents angeboten werden.

Ergebnis: Der MCP Inspector ruft die verfügbaren KI-Tools ab. Ein Eintrag tools/list erscheint in der History. Die Liste der Tools wird im Bereich Tools angezeigt.
Testen Sie beliebige Tools aus der Tools-Liste. Wenn Sie auf ein Tool in der Liste klicken, werden die Beschreibung und ggf. die Eingabeparameter auf der rechten Fensterseite angezeigt. Wählen Sie etwa das Tool agorum_ai_agents_library_basic_get_exif aus, geben Sie als ID die UUID eines Bildes im agorum core Server an und klicken Sie Run Tool.

Ergebnis: Die EXIF-Metadaten des Bildes werden angezeigt. Sie haben mit dem MCP Inspector den Client-Zugriff auf ein KI-Tool getestet, das über den agorum core pro MCP-Server zur Verfügung steht.

Verwenden eines ALBERT | AI KI-Tools im MCP Inspector