Anleitung zur Verbindung von Open WebUI mit MCP-Servern

 

Technologie Model Context Protocol (MCP) Es ermöglicht KI-Sprachmodellen, über die Chat-Umgebung hinauszugehen und mit externen Tools und Echtzeitdaten zu interagieren. Daher Verbinden Sie Open WebUI mit MCP-Servern Das ist eine tolle Idee, wenn du dein Spiel auf die nächste Stufe heben willst.

Tatsächlich ist die Integration von MCP-Servern, auch wenn es kompliziert klingt, keine Raketenwissenschaft, wenn man weiß, wo man anfangen soll. Egal, ob Sie nach einem native Implementierung Egal, ob Sie eine Brücke für Server benötigen, die auf STDI oder HTTP laufen, es gibt klare Wege, um Ihr Modell mit technischer Dokumentation, Datenbanken oder externen Diensten zu verbinden, die dieses Protokoll unterstützen.

Wie verbindet man Open WebUI mit MCP-Servern?

Ab Version 0.6.31 enthält Open WebUI bereits Folgendes: native Unterstützung für MCPAllerdings gibt es eine wichtige Einschränkung: Es funktioniert nur durch Streamable HTTPDies bedeutet, dass Sie keine direkte Verbindung zu einem Server herstellen können, der stdio (Input/Output Standard) verwendet, da die Webarchitektur der Plattform HTTP-basierte Kommunikation erfordert, um mehrere Benutzer und Sitzungen sicher zu verwalten.

Um sich zu verbinden WebUI öffnen Bei MCP-Servern muss ein Administrator zu folgendem Server gehen: Verwaltungseinstellungen Gehen Sie anschließend zum Abschnitt „Externe Tools“. Dort können Sie einfach einen neuen Server hinzufügen, den MCP-Typ auswählen und die entsprechende URL eingeben. Wichtig zu wissen ist, dass nur Administratoren Diese Server können registriert werden, da ein MCP-Server über weitreichende Berechtigungen im System verfügt und es ein enormes Sicherheitsrisiko darstellen würde, wenn jeder Benutzer einen solchen Server installieren könnte.

Bezüglich der Authentifizierung beim Verbinden von Open WebUI mit MCP-Servern stehen Ihnen je nach Serverstandort mehrere Optionen zur Verfügung. Bei einer lokalen und risikoarmen Umgebung wählen Sie "Keiner"Aber Vorsicht: Wenn Sie „Bearer“ auswählen und das Schlüsselfeld leer lassen, lehnen viele Server die Verbindung ab. In professionelleren Umgebungen können Sie Folgendes verwenden: OAuth 2.1entweder statisch (mit Client-ID und Client-Geheimnis) oder dynamisch, sodass sich die KI vor dem Zugriff auf Daten sicher authentifizieren kann.

MCPO als Brücke für lokale Server verwenden

Was passiert, wenn Sie einen heruntergeladenen MCP-Server haben, der stdio und nicht HTTP verwendet? Hier wird es interessant. MCPO (Model Context Protocol Orchestrator)Dieses Programm fungiert als Proxy, der diese "traditionellen" Server in ein Format übersetzt. OpenAPI kompatibel mit HTTPwodurch Open WebUI sie als Standardwerkzeuge erkennt.

Um dieses System einzurichten und Open WebUI mit MCP-Servern zu verbinden, ist die einfachste Methode die Verwendung von Docker. Zuerst stellen Sie den Container bereit. WebUI mit Ollama öffnen Anschließend starten Sie den MCPO-Container. Dieser benötigt eine Datei namens config.json Hier legen Sie fest, welche MCP-Server Sie verbinden möchten. Sobald die Datei auf Ihrem PC erstellt wurde, müssen Sie sie mithilfe von Docker-Befehlen in das Container-Volume kopieren, damit der Orchestrator weiß, welche Tools gestartet werden sollen.

Sobald MCPO auf Port 8000 läuft, müssen Sie zur WebUI zurückkehren und das Tool hinzufügen, das auf die Adresse verweist. http://host.docker.internal:8000Wenn Sie mehrere Server in der JSON-Datei konfiguriert haben, müssen Sie jeden einzelnen hinzufügen und seinen spezifischen Pfad angeben, z. B. den Endpunkt des Microsoft-Dokumentationsservers am Ende der URL hinzufügen.

Modellkonfiguration und -optimierung

Um Open WebUI mit MCP-Servern zu verbinden, reicht es nicht aus, den Server einfach nur zu verbinden: Sie müssen dem Modell mitteilen, dass es diese Tools verwenden soll. Gehen Sie zum Abschnitt „Modelle“, wählen Sie das Modell aus, das Sie erweitern möchten, und geben Sie Folgendes ein: Erweiterte ParameterDort besteht die wichtigste Anpassung darin, die Funktionsaufruf von „Standard“ auf „Nativ“ umstellenWenn Sie diese Änderung nicht vornehmen, wird das Modell die verfügbaren Werkzeuge wahrscheinlich ignorieren.

Scrollen Sie als Nächstes auf derselben Einstellungsseite nach unten zum Abschnitt „Tools“ und Aktivieren Sie die MCP-Server Sie haben sich zuvor registriert. Es gibt auch ein Feld namens „Funktionsnamenfilterliste“. Normalerweise bleibt dieses leer, um alle Funktionen nutzen zu können. Sollten Sie jedoch Verbindungsprobleme feststellen, ist folgender Trick sehr effektiv: Setzen Sie ein einfaches Komma (,)Dadurch wird das System gezwungen, die Liste zu validieren, und in der Regel werden dadurch Parsing-Fehler behoben.

Wenn beim Verwenden des Tools ein Verbindungsfehler auftritt, obwohl die Bestätigungsschaltfläche anzeigt, dass alles in Ordnung ist, überprüfen Sie Ihre Authentifizierung. Manchmal liegt es daran, dass… ersten Händedruck Die Serverantwort ist zu langsam und überschreitet das erwartete Timeout. In solchen Fällen wird empfohlen, den Wert von zu erhöhen. MCP_INITIALIZE_TIMEOUTDie Standardeinstellung beträgt 10 Sekunden, um dem Server Zeit zum Starten zu geben.

Nach der Verbindung von Open WebUI mit den MCP-Servern und der korrekten Konfiguration des Workflows zwischen dem Modell, dem MCPO-Orchestrator und der Open WebUI-Oberfläche lässt sich ein einfaches Chatfenster in ein Kommandozentrum verwandeln, das Skripte ausführen, technische Handbücher konsultieren und komplexe Daten mithilfe des Model Context Protocol-Standards verwalten kann. Dies gewährleistet eine reibungslose Kommunikation und Sicherheit, die stets unter der Kontrolle des Administrators steht.