Open WebUI anbinden

Ihre eigene Open-WebUI-Installation mit LoanMonitor verbinden: einmal registrieren, die Werte in Open WebUI eintragen, und jede Person meldet sich mit dem eigenen Konto an.

Open WebUI ist eine Chat-Oberfläche, die Sie selbst betreiben, auf einem Server oder als Desktop-App Open WebUI Desktop. Mit LoanMonitor verbunden, kann der Assistent Ihre Darlehen lesen und, wenn Sie es erlauben, ändern. Jede Person meldet sich mit ihrem eigenen LoanMonitor-Konto an; der Assistent sieht also genau das, was diese Person auch in LoanMonitor sieht.

Diese Anleitung folgt Open WebUI 0.11. Ältere Versionen benennen manche Felder anders. Die genauen Werte für Ihr Konto finden Sie zum Kopieren auf der MCP-Seite in LoanMonitor (Einstellungen → Zugriff → MCP, Reiter Eigener Chat).

Was Sie brauchen

Einen Kundenadmin in LoanMonitor, der Ihre Open-WebUI-Installation einmal registriert. Ein Eintrag pro Installation, nicht pro Mitarbeiter.
Einen Open-WebUI-Admin, der die Verbindung in Open WebUI anlegt.
Netzwerkzugang: Der Open-WebUI-Server selbst muss api.loanmonitor.eu und auth.loanmonitor.eu per HTTPS erreichen. Ein VPN ändert nichts, solange das funktioniert.

1. Instanz in LoanMonitor registrieren

In LoanMonitor Einstellungen → Zugriff → MCP öffnen, Reiter Eigener Chat, und auf Instanz registrieren klicken:

Feld	Eintrag
Name	Eine Bezeichnung für Sie und Ihre Kollegen, z. B. `Open WebUI Finanzen`. Sie erscheint bei der Anmeldung auf der Zustimmungsseite als "Ihre Firma · Name".
Oberfläche	`Open WebUI`
Adresse der Instanz	Die Adresse in der Browserzeile, wenn Sie Open WebUI nutzen, z. B. `https://chat.example.com` (mit Pfad-Präfix, falls vorhanden). `https` ist Pflicht; `http` geht nur für `localhost` und `127.0.0.1`.
Verbindungs-ID in Open WebUI	Standard `loanmonitor`. Dieselbe ID tragen Sie in Schritt 2 in Open WebUI ein.

Der Dialog zeigt die resultierende Callback-URL, z. B. https://chat.example.com/oauth/clients/mcp:loanmonitor/callback. LoanMonitor akzeptiert Anmeldungen nur für genau diese Adresse. In Open WebUI muss Admin Panel → Settings → General → WebUI URL dieselbe Adresse sein, die Sie registriert haben, denn Open WebUI baut daraus seine Callback-URL.

Nach Registrieren zeigt LoanMonitor das Client-Secret der Instanz einmal an. Kopieren Sie es sofort; Sie brauchen es in Schritt 2. LoanMonitor speichert es nicht und kann es nicht noch einmal anzeigen. Geht es verloren, klicken Sie neben der Instanz auf Neues Secret: Das alte Secret funktioniert dann sofort nicht mehr, und Sie tragen das neue in Open WebUI ein.

2. Verbindung in Open WebUI anlegen

In Open WebUI Admin Panel → Settings → Integrations öffnen und eine Verbindung vom Typ MCP (Streamable HTTP) hinzufügen:

Feld in Open WebUI	Wert
URL	`https://api.loanmonitor.eu/mcp` (das Feld zeigt den Platzhalter API Base URL)
ID	die registrierte Verbindungs-ID (Standard `loanmonitor`)
Auth	`OAuth 2.1 (Static)`
Client ID	die Client-ID neben Ihrer Instanz auf der MCP-Seite
Client Secret	das bei der Registrierung einmal angezeigte Client-Secret
OAuth Server URL	leer lassen
OAuth Scopes	`openid profile email offline_access loans:read loans:write`
OAuth Resource Parameter	`Automatic`

OAuth Server URL ist nicht die Callback-URL. Lassen Sie das Feld leer: Open WebUI findet den LoanMonitor-Anmeldeserver über die URL oben und baut die Callback-URL selbst.

Die Scope-Liste vollständig eintragen. Der Standard, den Open WebUI erkennt, enthält kein openid und kein offline_access, und ohne offline_access muss sich jede Person stündlich neu anmelden.

Auf Register Client klicken. Das Abzeichen daneben muss von Not Registered auf Registered wechseln.

Auf Save klicken.

Open WebUI neu laden (oder die Desktop-App neu starten). Open WebUI lädt seine Tool-Liste beim Laden der Seite; eine neue Verbindung erscheint im Chat erst nach dem Neuladen.

3. Nutzen (jede Person)

Im Chat auf das Integrations-Symbol rechts neben + klicken. Es ist ein eigener Knopf, kein Eintrag im +-Menü.

Tools öffnen und LoanMonitor aktivieren.

Beim ersten Mal öffnet der Browser die LoanMonitor-Anmeldung. Mit dem eigenen LoanMonitor-Konto anmelden.

Die Zustimmungsseite nennt Ihre Firma und die Instanz. Read loans erlauben und, wenn der Assistent Änderungen vornehmen soll, Write loans.

Fragen Sie zum Beispiel: "Liste meine Darlehen auf."

Open WebUI Desktop

Die Desktop-App betreibt Open WebUI auf Ihrem eigenen Rechner, meist unter http://127.0.0.1:8080. Registrieren Sie in Schritt 1 genau diese Adresse und öffnen Sie Open WebUI unter derselben Adresse. http://localhost:8080 ist für die Anmeldung eine andere Adresse, und der Callback würde nicht passen.

Instanz verwalten

Auf der MCP-Seite, Reiter Eigener Chat, kann ein Kundenadmin:

Name, Adresse oder Verbindungs-ID bearbeiten. WebUI URL und ID in Open WebUI entsprechend anpassen.
Ein Neues Secret erzeugen. Das bisherige Secret funktioniert sofort nicht mehr; tragen Sie das neue gleich in der Open-WebUI-Verbindung ein.
Die Instanz widerrufen. Anmeldungen darüber funktionieren dann nicht mehr, und bereits offene Sitzungen werden bei der nächsten Anfrage abgewiesen.

Eine Instanz, die registriert wurde, bevor LoanMonitor Client-Secrets ausgegeben hat, zeigt den Hinweis "Diese Instanz hat kein Client-Secret". Widerrufen Sie sie und registrieren Sie die Instanz neu; Sie erhalten eine neue Client-ID und ein Secret.

Fehlerbehebung

Problem	Was tun
"Please enter a valid URL"	Das Feld URL (Platzhalter API Base URL) ist leer. `https://api.loanmonitor.eu/mcp` eintragen.
"Connection failed" oder "Registration failed"	Prüfen, ob die URL `https://api.loanmonitor.eu/mcp` lautet, OAuth Server URL leer ist und das Client-Secret eingetragen ist.
"Please enter Client ID and Client Secret"	Das Client-Secret aus der Registrierung eintragen. Verloren? Auf der MCP-Seite ein Neues Secret erzeugen.
Kein Integrations-Symbol im Chat	Open WebUI neu laden oder die Desktop-App neu starten. Prüfen, ob die Verbindung eingeschaltet ist.
Andere Personen sehen LoanMonitor nicht	Admins sehen das Tool automatisch. Anderen Personen oder Gruppen über Access Control an der Verbindung Zugriff geben.
Anmeldung scheitert mit einem Redirect- oder Callback-Fehler	Die Adresse, unter der Sie Open WebUI öffnen, die Einstellung WebUI URL und die registrierte Adresse müssen gleich sein, auch bei `127.0.0.1` gegenüber `localhost`.
"invalid_client" nach der Anmeldung	Das Client-Secret ist falsch oder wurde ersetzt. Das aktuelle Secret eintragen oder ein neues erzeugen.

Häufige Fragen

Brauchen wir einen Eintrag pro Mitarbeiter? Nein. Ein Eintrag pro Open-WebUI-Installation. Jede Person meldet sich einzeln an.

Welche Rechte hat eine Person? Genau ihre LoanMonitor-Rechte: dieselben Kunden, Standorte und Berechtigungen wie in der LoanMonitor-Webanwendung. Arbeitet sie für mehrere Kunden, sieht der Assistent nur den Kunden, für den diese Instanz registriert ist.

Unsere Instanz hat zwei Adressen (z. B. interner und externer Hostname). Registrieren Sie sie mit der Oberfläche Andere und tragen Sie beide Callback-URLs ein, oder ändern Sie die Adresse des Eintrags, wenn Sie umziehen.

Mehr zum Verbinden von Assistenten: KI-Assistenten verbinden (MCP). Weitere Fragen? Schreiben Sie an support@loanmonitor.eu. Senden Sie nie ein Client-Secret per E-Mail.

Auf dieser Seite