KI-Assistenten verbinden (MCP)
Claude, ChatGPT und andere KI-Assistenten mit Ihren LoanMonitor-Daten nutzen: die zwei Verbindungswege, was jeder braucht und wie Sie ihn einrichten.
LoanMonitor lässt sich mit KI-Assistenten wie Claude und ChatGPT verbinden. Danach können Sie Fragen zu Ihren Darlehen in normaler Sprache stellen oder Routinearbeit an den Assistenten abgeben.
Beispiele für Fragen:
- „Welche Darlehen laufen in den nächsten zwölf Monaten aus?“
- „Zeig mir Restschuld und Zinsen aller Darlehen bei der Sparkasse.“
- „Fasse unser Portfolio nach Kreditgeber zusammen.“
- „Hier ist die Zinsanpassungsmitteilung der Bank. Erfasse sie beim richtigen Darlehen.“
Die Verbindung nutzt das Model Context Protocol (MCP), einen offenen Standard, über den KI-Assistenten externe Werkzeuge sicher verwenden.
Diese Seite gibt einen Überblick. Wenn Sie in LoanMonitor angemeldet sind, finden Sie unter Einstellungen → Zugriff → MCP die genauen Werte für Ihr Konto, vorausgefüllt und zum Kopieren bereit.
Ihre Daten bleiben geschützt
- Ihre Berechtigungen gelten. Der Assistent sieht und darf nie mehr als Sie selbst in LoanMonitor. Sehen Sie nur bestimmte Standorte, sieht der Assistent auch nur diese.
- Nur Lesen ist möglich. Sie entscheiden, ob der Assistent nur lesen oder auch Daten anlegen und ändern darf.
- Sie können die Verbindung jederzeit trennen, indem Sie den Connector im Assistenten entfernen oder den API-Schlüssel in LoanMonitor widerrufen.
- Jede Änderung wird protokolliert. Änderungen über einen Assistenten erscheinen in der Änderungshistorie des Darlehens, genau wie Änderungen in der App.
Zwei Wege zur Verbindung
Es gibt zwei Wege. Welcher passt, hängt von der App ab, die Sie nutzen.
| Anmeldung im Browser (OAuth) | API-Schlüssel | |
|---|---|---|
| Funktioniert mit | Claude (Web, Desktop- und Handy-App), ChatGPT (Web und Handy) | Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex CLI, Gemini CLI und anderen MCP-Clients |
| Anmeldung | Mit Ihrem normalen LoanMonitor-Login im Browser | Mit einem API-Schlüssel, den Sie in LoanMonitor erstellen |
| Installation | Keine | Ein kleines Programm, das Ihre App auf Ihrem Rechner startet (benötigt Node.js 20 oder neuer) |
| Welche Kunden | Alle Kunden, auf die Ihr Konto Zugriff hat | Genau ein Kunde pro Schlüssel |
| Nur Lesen | Bei der Anmeldung „Darlehen schreiben“ nicht erlauben | Einen Nur-Lese-Schlüssel erstellen |
| Ideal für | Alltägliche Fragen im Chat | Entwickler, Automatisierung, Desktop-Programmierwerkzeuge |
Nutzen Sie einen Weg pro App. Richten Sie nicht beide für denselben Assistenten ein, sonst sieht er jedes Werkzeug doppelt.
Weg 1: Anmeldung im Browser (OAuth)
Keine Installation, kein Schlüssel. Sie fügen LoanMonitor als Connector in Ihrem Assistenten hinzu und melden sich mit Ihrem gewohnten LoanMonitor-Konto an.
Die Serveradresse lautet:
https://api.loanmonitor.eu/mcpFunktioniert auf claude.ai sowie in der Desktop- und Handy-App von Claude. Ob eigene Connectors verfügbar sind, hängt von Ihrem Claude-Tarif ab.
- Öffnen Sie auf claude.ai Customize → Connectors und klicken Sie auf Add custom connector.
- Geben Sie einen Namen (zum Beispiel LoanMonitor) und die Serveradresse oben ein.
- Tragen Sie unter Advanced settings die OAuth Client ID ein, die auf der MCP-Seite in LoanMonitor steht.
- Klicken Sie auf Add und dann auf Connect. Die LoanMonitor-Anmeldung öffnet sich. Melden Sie sich an und bestätigen Sie den angefragten Zugriff.
- Testen Sie es in einem neuen Chat: „Liste meine Darlehen auf.“
Claude fragt nach Schreibrechten erst, wenn Sie zum ersten Mal eine schreibende Aktion nutzen.
Funktioniert auf chatgpt.com und in der ChatGPT-Handy-App. Nötig ist ein Tarif mit Entwicklermodus (Plus, Pro, Business, Enterprise oder Education).
- Schalten Sie einmalig den Entwicklermodus ein: Einstellungen → Sicherheit und Anmeldung → Entwicklermodus.
- Öffnen Sie chatgpt.com/plugins, klicken Sie auf + und dann auf App erstellen → MCP-App erstellen.
- Geben Sie die Serveradresse oben ein und wählen Sie OAuth als Authentifizierung.
- Wählen Sie in den erweiterten OAuth-Einstellungen Custom OAuth client und tragen Sie die Werte von der MCP-Seite in LoanMonitor ein (Client-ID und Scopes). Lassen Sie das Client-Secret leer und schalten Sie OIDC enabled aus.
- Klicken Sie auf Erstellen. Die LoanMonitor-Anmeldung öffnet sich. Melden Sie sich an und bestätigen Sie den angefragten Zugriff.
- Testen Sie es in einem Chat: „Liste meine Darlehen auf.“
Für reines Lesen lassen Sie loans:write bei den Scopes weg.
Bei der Anmeldung im Browser handelt der Assistent als Sie und sieht daher alle Kunden, auf die Sie Zugriff haben. Arbeiten Sie für mehrere Kunden, sagen Sie dem Assistenten, welchen Sie meinen.
Weg 2: API-Schlüssel
Desktop- und Entwicklerwerkzeuge starten ein kleines LoanMonitor-Programm auf Ihrem Rechner. Es ist auf npm als @loanmonitor/mcp veröffentlicht und verbindet sich mit einem API-Schlüssel mit LoanMonitor.
Node.js prüfen. Führen Sie node --version in einem Terminal aus. Sie brauchen Version 20 oder neuer.
API-Schlüssel erstellen. Öffnen Sie in LoanMonitor Einstellungen → Zugriff → API-Schlüssel und klicken Sie auf Schlüssel erstellen. Wählen Sie nur Lesen für Fragen und Auswertungen oder Lesen und Schreiben, wenn der Assistent auch Darlehen anlegen, Auszahlungen oder Zinsanpassungen erfassen oder Dokumente hochladen soll. Der Schlüssel wird nur einmal angezeigt, kopieren Sie ihn also sofort.
Werte kopieren. Die MCP-Seite (Einstellungen → Zugriff → MCP) zeigt die drei Werte, die Ihre App braucht: die API-Adresse, Ihren Schlüssel und Ihre Kunden-ID.
Server in der App eintragen. Die MCP-Seite enthält fertige Anleitungen für jede App. Die meisten Apps nutzen eine Konfiguration wie im Beispiel unten.
App vollständig neu starten (beenden, dann wieder starten) und fragen: „Liste meine Darlehen auf.“
{
"mcpServers": {
"loanmonitor": {
"command": "npx",
"args": ["-y", "@loanmonitor/mcp"],
"env": {
"LOAN_MONITOR_API_URL": "https://api.loanmonitor.eu/api/v1",
"LOAN_MONITOR_API_KEY": "lm_...",
"LOAN_MONITOR_CUSTOMER_ID": "<Ihre Kunden-ID>"
}
}
}
}Behandeln Sie einen API-Schlüssel wie ein Passwort. Geben Sie ihn nicht weiter, legen Sie ihn nicht in gemeinsam genutzte Projektdateien und widerrufen Sie ihn in LoanMonitor, falls er bekannt geworden sein könnte. Machen Sie das lokale Programm nie aus dem Internet erreichbar (zum Beispiel über einen Tunnel): Wer die Adresse findet, könnte sonst mit Ihrem Schlüssel handeln.
Was der Assistent kann
| Bereich | Beispiele | Nötiger Zugriff |
|---|---|---|
| Darlehen | Darlehen auflisten und suchen, Details, Tilgungspläne und Portfoliokennzahlen anzeigen | Lesen |
| Stammdaten | Standorte, Kontrahenten (Banken, Kreditgeber) und Bankkonten auflisten | Lesen |
| Dokumente | Die zu einem Darlehen gespeicherten Dokumente auflisten | Lesen |
| Planung | Einen Tilgungsplan berechnen, ohne ihn zu speichern, zum Abgleich mit dem Plan der Bank | Lesen |
| Anlegen und ändern | Darlehen anlegen oder korrigieren, Auszahlungen, Zinsanpassungen und Sondertilgungen erfassen, Verträge und Bankmitteilungen hochladen | Schreiben |
| Dokumentation | Diese Dokumentation durchsuchen und lesen | Nur mit Anmeldung im Browser |
Eigene Integrationen
Der API-Schlüssel funktioniert auch für Ihre eigene Automatisierung, zum Beispiel mit n8n oder einem Skript: Senden Sie ihn im Header X-API-Key an die LoanMonitor-API. Ein typisches Beispiel ist das automatische Ablegen der Zinsanpassungs-E-Mails Ihrer Bank. Sie planen eine Integration? Schreiben Sie an support@loanmonitor.eu; wir helfen gern.
Fehlerbehebung
| Problem | Lösung |
|---|---|
| Der Assistent zeigt keine LoanMonitor-Werkzeuge | App vollständig neu starten. Bei Anmeldung im Browser einen neuen Chat beginnen. |
| „Unauthorized“ oder die Anmeldung schlägt fehl | Prüfen, ob der API-Schlüssel vollständig und nicht widerrufen ist. Bei Anmeldung im Browser den Connector entfernen und neu verbinden. |
| „Customer mismatch“ | Die Kunden-ID gehört nicht zum Schlüssel. Beide Werte von der MCP-Seite desselben Kontos kopieren. |
| Der Assistent kann nichts anlegen oder ändern | Der Schlüssel ist nur zum Lesen, oder bei der Anmeldung wurden keine Schreibrechte erteilt. |
| Neue Funktionen fehlen | Der Assistent lädt die Werkzeugliste beim Start eines Chats. Neuen Chat beginnen oder neu verbinden. |
Kommen Sie nicht weiter? Schreiben Sie an support@loanmonitor.eu. Bitte senden Sie Ihren API-Schlüssel nie per E-Mail mit.
Variabel verzinste Darlehen
So legen Sie ein variabel verzinstes Darlehen an und erfassen jede Zinsanpassung aus der Mitteilung Ihrer Bank.
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.