MCP-Server
Das Model Context Protocol (MCP) ist ein offener Standard, der beschreibt, wie eine KI-Anwendung externe Tools findet und nutzt. WivenLLM ist ein MCP-Client: Jeder MCP-Server lässt sich anbinden, und seine Tools werden zu Fähigkeiten, die Ihre Agenten nutzen können.
Wozu das dient
Ohne MCP erfordert die Anbindung von WivenLLM an ein internes Tool eine eigene Entwicklung. Mit MCP genügt es, dass das Tool einen standardkonformen Server bereitstellt: WivenLLM fragt den Server ab, entdeckt die angebotenen Funktionen und stellt sie den Agenten zur Verfügung.
Der Vorteil: Das MCP-Ökosystem ist gemeinsam. Ein für eine andere Anwendung geschriebener Server funktioniert hier, und umgekehrt.
Beispiele für so Angebundenes: ein Ticketsystem, ein ERP, ein Projektmanagement-Tool, ein interner Dienst, eine proprietäre Dokumentdatenbank.
Konfigurieren (Administrator)
Ein MCP-Server wird in der JSON-Konfigurationsdatei der MCP-Server hinzugefügt, die im Speicherverzeichnis der Instanz liegt. Die Oberfläche bietet kein Formular zum Hinzufügen. Die Datei sieht so aus:
{
"mcpServers": {
"tickets-local": {
"command": "npx",
"args": ["-y", "mon-serveur-mcp"],
"env": { "API_TOKEN": "..." }
},
"erp-distant": {
"type": "streamable",
"url": "https://mcp.exemple.ch/mcp",
"headers": { "Authorization": "Bearer ..." }
}
}
}
Ein Server wird auf zwei Arten deklariert:
Lokaler Server. WivenLLM startet das Programm und kommuniziert direkt mit ihm. Deklariert werden der auszuführende Befehl, seine Argumente und seine Umgebungsvariablen. Das Programm und seine Abhängigkeiten (zum Beispiel npx) müssen dort vorhanden sein, wo WivenLLM läuft.
Entfernter Server. WivenLLM verbindet sich mit einer HTTP-Adresse. Deklariert werden die URL und gegebenenfalls die Authentifizierungs-Header. Das Feld type hat den Wert streamable oder sse; ohne dieses Feld wird sse verwendet.
Der Server erscheint dann unter Einstellungen → Agent → Agentenfähigkeiten, Abschnitt MCP-Server, nachdem die Liste aktualisiert wurde. Seine Tools sind dort einzeln aufgeführt.
MCP-Server sind global: Eine Aktivierung pro Arbeitsbereich gibt es nicht. Die Tools eines gestarteten Servers stehen allen Agenten der Instanz zur Verfügung, ausser jenen, die ein Administrator in diesem Bildschirm deaktiviert hat.
Lebenszyklus
- Die Server werden bei Bedarf gemeinsam gestartet, bei der ersten Agentensitzung oder beim ersten Öffnen des Administrationsbildschirms. Um einen davon auszunehmen, ergänzen Sie seine Definition um
"wivenllm": { "autoStart": false }. - Der Administrationsbildschirm zeigt ihren Zustand an und erlaubt, sie zu stoppen, zu starten und das Ganze neu zu laden.
- Ein nicht verfügbarer Server hindert die Agenten nicht am Arbeiten: Die entsprechenden Tools fehlen einfach.
Worauf Sie achten sollten
MCP-Tools werden ohne Bestätigung ausgeführt. Es erscheint keine Bestätigungskarte: Das Tool wird ausgeführt, sobald der Agent es beschliesst, auch wenn es Daten im angebundenen System ändert. Deaktivieren Sie die Schreib-Tools, die Sie keinem Agenten anvertrauen wollen, und geben Sie dem Server ein Konto mit eingeschränkten Rechten.
Ein MCP-Server läuft mit den Rechten, die Sie ihm geben. Ein lokaler Server läuft auf Ihrem Rechner; ein entfernter Server erhält, was der Agent ihm übermittelt. Installieren Sie nur Server, deren Herkunft Sie kennen.
Die Daten fliessen. Ein entfernter MCP-Server erhält die Argumente, die der Agent ihm sendet. Bei einer Installation, die nichts hinauslassen darf, haben nur lokale oder interne Server ihren Platz.
Jedes Tool verbraucht Kontext. Ein Server mit fünfzig Funktionen erschwert die Wahl des Agenten erheblich. Bevorzugen Sie gezielte Server, deaktivieren Sie unnötige Tools und stützen Sie sich auf die intelligente Auswahl der Fähigkeiten.
Fehler sind sichtbar. Ein fehlschlagendes MCP-Tool gibt seinen Fehler an den Agenten zurück, der ihn melden muss, statt einen Erfolg vorzutäuschen.
MCP oder Agenten-Ablauf?
| Bedarf | Mechanismus |
|---|---|
| Zugang zu einem externen System geben, wobei der Agent entscheidet, wann er es nutzt | MCP |
| Immer dieselben Schritte in derselben Reihenfolge ausführen | Agenten-Ablauf |
| Ein fachliches Verfahren vermitteln | Bibliothek der Fähigkeiten |
Die drei lassen sich auf Ebene des Agenten kombinieren: Er kann einem in einem Merkblatt beschriebenen Verfahren folgen, ein MCP-Tool aufrufen und einen Ablauf starten. Ein Ablauf hingegen kann kein MCP-Tool aufrufen: Er verfügt nur über seine eigenen Blöcke.

Français