MCP-Server für KI-Clients

Ein MCP-Server gibt deinem kompatiblen KI-Client Zugriff auf ausgewählte Daten deiner eigenen Bankkonten. MCP steht für Model Context Protocol: Der Client erhält darüber Werkzeuge, mit denen er Daten aus deinem Kontoflux.io-Workspace abrufen kann.

Wenn dein Server bereits eingerichtet ist, kannst du direkt einen Client verbinden. Wenn du neu beginnst, füge einen MCP-Server in der App hinzu. Prüfe dort zuerst, ob der richtige Workspace ausgewählt ist.

Was du mit dem MCP-Server machen kannst

Je nach freigegebenen Tools und Bankkonten kann dein KI-Client:

• Konten und Kontostände abrufen: Freigegebene Konten auflisten oder ein einzelnes Konto per ID oder IBAN auswählen (get_accounts).
• Transaktionen auflisten: Buchungen abrufen und mit Seitengröße und Seitenversatz weitere Ergebnisse laden (get_transactions).
• Transaktionen gezielt filtern: Nach eigenem Konto, Kategorie, übergeordneter Kategorie oder IBAN des Gegenkontos eingrenzen (get_transactions).
• Zeiträume auswählen: Nach Buchungsdatum, Wertstellungsdatum oder Importdatum filtern (get_transactions).
• Ergebnisse sortieren: Nach Buchungsdatum, Wertstellungsdatum, Importdatum, Betrag oder Transaktions-ID aufsteigend oder absteigend sortieren (get_transactions).
• Mit Suchtext suchen: Transaktionen anhand von Namen oder Begriffen finden (search_transactions, Modus search).
• Referenzen abgleichen: Buchungen mit Rechnungsnummern, Zahlungsreferenzen oder Verwendungszwecken vergleichen und nach Matching-Score geordnet abrufen (search_transactions, Modus match).
• Kategorien nachschlagen: Kategorien mit IDs, Namen und Unterkategorien auflisten oder eine einzelne Kategorie per ID abrufen, um passende Transaktionsfilter zu wählen (get_categories).

Fertige Abläufe für Zahlungsabgleich, Monatsabschluss, Liquidität und weitere Finanzaufgaben findest du unter Skills für KI-Agenten.

Server einrichten

1. Öffne Automationen → Integrationen und füge einen MCP-Server hinzu.
2. Gib der Integration einen passenden Namen, etwa „KI-Auswertung Geschäftskonto“.
3. Öffne MCP-Einstellungen und wähle unter Verfügbare Tools die gewünschten Werkzeuge.
4. Speichere die Auswahl.
5. Öffne Bankkonten und wähle unter Erlaubte Bankkonten die Konten für diese Integration. Speichere auch diese Einstellung.
6. Wähle einen der unten beschriebenen Zugangswege und prüfe, ob die Integration Aktiv ist.
7. Öffne unter Übersicht den Bereich Client verbinden und wähle deinen Client.

Die URL enthält Workspace und Integration. Verwende die kopierte Adresse dieser Integration, auch wenn du im selben Workspace weitere MCP-Server eingerichtet hast.

Client verbinden

Öffne deine MCP-Integration unter Automationen → Integrationen. In Übersicht → Client verbinden findest du die Einrichtung für deinen Client. Bei einer aktiven MCP-Integration findest du die Client-Auswahl auch im Dashboard, in der Kachel Bankkonten automatisieren unter Mit Bankdaten verbinden.

1. Wähle unter KI-Client auswählen den gewünschten Client. Dadurch öffnet sich ein Dialog mit seiner Schritt-für-Schritt-Anleitung. Im Dialog kannst du auch zu einem anderen Client wechseln.
2. Für die OAuth-Verbindung müssen die Integration, OAuth-Autorisierungsserver aktivieren und Dynamic Client Registration erlauben eingeschaltet sein. Fehlt eine OAuth-Einstellung, führt dich OAuth-Einstellungen öffnen zur Konfiguration. Speichere deine Änderungen dort und öffne danach die Einrichtung deines Clients erneut. Die Client-Auswahl ändert diese Freigaben nicht.
3. Wähle deinen Client in der folgenden Übersicht, um die vollständige Anleitung zu lesen. Die passenden Installationslinks, Befehle und Kopierfelder findest du in der App direkt beim jeweiligen Schritt.

Client	Einrichtung
Cursor	App öffnen, Server bestätigen und über OAuth anmelden.
VS Code	App öffnen, anmelden und Tools im Chat auswählen.
Windsurf	Konfiguration ergänzen, in Cascade anmelden und Tools aktivieren.
Claude Code	Im Terminal hinzufügen, in Claude Code anmelden.
Codex	Im Terminal hinzufügen und anmelden, in Codex prüfen.
Gemini CLI	Im Terminal hinzufügen, in Gemini CLI anmelden.
Hermes Agent	Im Terminal hinzufügen, OAuth und Tool-Auswahl bestätigen.
OpenClaw	Auf dem OpenClaw-Gerät hinzufügen, anmelden und Verbindung prüfen.
Claude.ai	Eigenen Connector hinzufügen, verbinden und im Chat einschalten.
ChatGPT	Entwicklermodus aktivieren, Verbindung erstellen und im Chat auswählen.

Anschließend meldest du dich für die Verbindung bei Kontoflux.io an und bestätigst den Zugriff. Der Installationslink überträgt die Server-Adresse; er enthält keinen MCP-Schlüssel und erteilt allein noch keinen Zugriff auf deine Bankdaten.

Die Desktop-Installationslinks setzen voraus, dass der gewählte Client auf deinem Gerät installiert ist. Wenn der Browser ihn nicht öffnet, findest du unter Manuelle Konfiguration die Angaben zum Kopieren. Für weitere Clients verwende die jeweils angezeigte Anleitung oder die MCP URL. Welche Einrichtung der Client unterstützt, hängt auch von dessen Version und Einstellungen ab.

Wenn du Dynamic Client Registration erlauben nicht aktivieren möchtest, verwende eine manuell registrierte OAuth-App mit einem Client, der deren Zugangsdaten annimmt, oder einen statischen Schlüssel. Bei einer eingeschränkten Liste erlaubter Redirect-Domains muss auch die Rücksprungadresse deines Clients zugelassen sein.

Die folgenden Anleitungen verwenden die Befehle aus dem Dialog Client verbinden. Darin sind die URL deiner Integration und der passende Servername bereits eingesetzt. Wo unten <Servername> steht, ist genau dieser Name gemeint; kopiere den vollständigen Befehl aus der App.

Cursor verbinden

1. Installiere Cursor auf deinem Gerät, falls es noch fehlt. Wähle dann Cursor im Dialog Client verbinden und klicke auf In Cursor installieren.
2. Erlaube deinem Browser, Cursor zu öffnen. Bestätige dort den vorgeschlagenen MCP-Server und dessen Start, falls Cursor danach fragt.
3. Folge der Anmeldung bei Kontoflux.io im Browser und bestätige den Zugriff auf deinen Workspace.
4. Prüfe in Cursor unter Customize, ob der MCP-Server aktiviert ist. Frage im Chat: „Welche Bankkonten sind verbunden?“ und erlaube den passenden Tool-Aufruf.

Falls der Installationslink Cursor nicht öffnet, kopiere im Dialog die Manuelle Konfiguration. Ergänze den Server in ~/.cursor/mcp.json für alle Projekte oder in .cursor/mcp.json für ein einzelnes Projekt. Behalte vorhandene Server bei. Die MCP-Anleitung von Cursor erklärt Konfiguration und Tool-Freigaben.

VS Code verbinden

1. Installiere VS Code auf deinem Gerät, falls es noch fehlt. Wähle VS Code im Dialog Client verbinden und klicke auf In VS Code installieren.
2. Erlaube deinem Browser, VS Code zu öffnen. Bestätige den MCP-Server. Wenn VS Code nachfragt, bestätige, dass du dem Server vertraust, und erlaube seinen Start.
3. Folge der Anmeldung bei Kontoflux.io im Browser und bestätige den Zugriff auf deinen Workspace.
4. Öffne in der Chatansicht Configure Tools und aktiviere die Tools dieses Servers.
5. Frage im Chat: „Welche Bankkonten sind verbunden?“ und bestätige einen angefragten Tool-Aufruf.

Falls sich VS Code über den Button nicht öffnet, verwende MCP: Add Server in der Befehlspalette und die MCP URL aus Kontoflux.io. Alternativ findest du im Dialog die Manuelle Konfiguration. Die MCP-Anleitung für VS Code beschreibt die Konfigurationsdateien und die Verwaltung der Server.

Windsurf verbinden

Diese Einrichtung gilt für Windsurf mit Cascade (Legacy).

1. Wähle Windsurf im Dialog Client verbinden und klicke auf Konfiguration kopieren.
2. Öffne in Cascade über das MCPs-Symbol die Konfiguration unter ~/.codeium/windsurf/mcp_config.json.
3. Ergänze den kopierten Servereintrag unter mcpServers. Behalte vorhandene Server bei und speichere die Datei.
4. Öffne die MCPs-Ansicht in Cascade und prüfe den Server. Folge der OAuth-Anmeldung bei Kontoflux.io und bestätige den Zugriff im Browser.
5. Aktiviere die gewünschten Tools in Cascade und frage im Chat: „Welche Bankkonten sind verbunden?“

Die MCP-Anleitung für Windsurf und Cascade beschreibt die Konfiguration und die Tool-Auswahl.

Claude Code verbinden

1. Prüfe, ob Claude Code installiert ist. Wähle Claude Code im Dialog Client verbinden, klicke auf Befehl kopieren und führe den Einrichtungsbefehl in deinem Terminal aus.
2. Starte Claude Code im Terminal mit claude. Gib anschließend /mcp in Claude Code ein.
3. Wähle den gerade hinzugefügten Server und starte die Anmeldung. Melde dich bei Kontoflux.io im Browser an und bestätige den Zugriff auf deinen Workspace.
4. Prüfe mit /mcp in Claude Code, ob der Server verbunden ist. Frage dann: „Welche Bankkonten sind verbunden?“ und bestätige den Tool-Aufruf, falls du danach gefragt wirst.

Der Einrichtungsbefehl aus der App speichert den Server für deinen lokalen Benutzer. Bei Bedarf findest du im Dialog auch eine Manuelle Konfiguration. Die MCP-Anleitung von Claude Code erklärt die verfügbaren Konfigurationsbereiche und die Anmeldung.

Codex verbinden

1. Prüfe, ob Codex CLI installiert ist. Wähle Codex im Dialog Client verbinden, kopiere den Einrichtungsbefehl und führe ihn in deinem Terminal aus.
2. Kopiere anschließend den Anmeldebefehl aus dem Dialog und führe auch ihn im Terminal aus. Er hat die Form codex mcp login <Servername>.
3. Melde dich im geöffneten Browser bei Kontoflux.io an und bestätige den Zugriff auf deinen Workspace.
4. Starte Codex mit codex. Prüfe den Server innerhalb von Codex mit /mcp und frage: „Welche Bankkonten sind verbunden?“

Im Dialog findest du bei Bedarf auch die Manuelle Konfiguration. Die MCP-Anleitung von Codex beschreibt die gemeinsame Konfiguration für die lokalen Codex-Clients und die OAuth-Anmeldung.

Gemini CLI verbinden

1. Prüfe, ob Gemini CLI installiert ist. Wähle Gemini CLI im Dialog Client verbinden, kopiere den Einrichtungsbefehl und führe ihn in deinem Terminal aus.
2. Starte Gemini CLI mit gemini. Kopiere den Anmeldebefehl aus dem Dialog und gib ihn innerhalb von Gemini CLI ein. Er hat die Form /mcp auth <Servername>.
3. Melde dich bei Kontoflux.io im Browser an und bestätige den Zugriff auf deinen Workspace.
4. Prüfe den Server mit /mcp list in Gemini CLI. Frage anschließend: „Welche Bankkonten sind verbunden?“ und bestätige den Tool-Aufruf, falls du danach gefragt wirst.

Der Einrichtungsbefehl speichert den Server für deinen lokalen Benutzer. Für eine Einrichtung über die Konfigurationsdatei findest du im Dialog die Manuelle Konfiguration. Die MCP-Anleitung von Gemini CLI erklärt die Befehle und die Anmeldung.

Claude.ai verbinden

1. Öffne in Claude Customize → Connectors und wähle + → Add custom connector. In Team- und Enterprise-Workspaces muss ein Owner den Connector zuerst für die Organisation hinzufügen.
2. Füge die MCP URL aus Kontoflux.io in das URL-Feld ein und bestätige mit Add.
3. Klicke beim Connector auf Connect. Melde dich bei Kontoflux.io an und bestätige den Zugriff auf deinen Workspace.
4. Öffne einen Chat und schalte den Connector unter + → Connectors ein. Frage zum Beispiel: „Welche Bankkonten sind verbunden?“

Die Claude-Anleitung für eigene Connectoren beschreibt auch die Einrichtung für Organisationen.

ChatGPT verbinden

1. Öffne in ChatGPT Settings → Security and login und aktiviere Developer mode. Die Funktion muss für dein Konto und deinen Workspace freigegeben sein.
2. Öffne über ChatGPT öffnen die Verbindungsübersicht. Klicke dort auf + und trage einen Namen und eine Beschreibung ein.
3. Füge unter Connection die vollständige MCP URL als MCP-Endpunkt ein und erstelle die Verbindung.
4. Folge der Anmeldung bei Kontoflux.io und bestätige den Zugriff auf deinen Workspace. Prüfe die Tools, die ChatGPT für die Verbindung gefunden hat.
5. Starte einen neuen Chat und füge die MCP-Verbindung über das Tool-Menü hinzu. Frage zum Beispiel: „Welche Bankkonten sind verbunden?“

Die OpenAI-Anleitung zur Verbindung mit ChatGPT beschreibt die aktuelle Oberfläche. Die OAuth-Anleitung von OpenAI erklärt die Anmeldung bei einem verbundenen Server.

Hermes Agent verbinden

1. Wähle Hermes Agent im Dialog Client verbinden. Führe den Einrichtungsbefehl auf dem Gerät aus, auf dem Hermes mit MCP-Unterstützung installiert ist. Die Standardinstallation enthält diese Unterstützung bereits.
2. Der Befehl startet die OAuth-Anmeldung. Melde dich im Browser bei Kontoflux.io an und bestätige den Zugriff. Öffnet sich kein Browser, verwende die URL aus dem Terminal. Bestätige anschließend dort die Tools: Y für alle oder select für eine Auswahl. Danach speichert Hermes den Server.
3. Führe den Prüfbefehl aus dem Dialog aus. hermes mcp test <Servername> prüft die Verbindung und die verfügbaren Tools des gespeicherten Servers.
4. Starte hermes chat oder gib /reload-mcp in einem laufenden Chat ein. Frage dann: „Welche Bankkonten sind verbunden?“

Läuft Hermes auf einem entfernten Gerät, leite den angezeigten Rückruf-Port per SSH weiter. So erreicht die Weiterleitung aus deinem Browser den Hermes-Server. Die Hermes-Anleitung für OAuth über SSH erklärt die Portweiterleitung.

Die MCP-Anleitung von Hermes beschreibt OAuth und die Tool-Auswahl. Die OAuth-Einrichtungsanleitung zeigt auch Verbindungstest und Neuladen.

OpenClaw verbinden

1. Wähle OpenClaw im Dialog Client verbinden. Führe den Einrichtungsbefehl in einem Terminal auf dem Gerät aus, auf dem deine aktuelle OpenClaw-Version läuft. Bei einem entfernten Gateway ist das dessen Server. Der Befehl hinterlegt die MCP-URL mit Streamable HTTP und OAuth.
2. Führe den angezeigten Anmeldebefehl im selben Terminal aus. Öffne die ausgegebene URL im Browser und bestätige den Zugriff bei Kontoflux.io. Wenn der Browser den Rückruf nicht erreicht, etwa bei einem entfernten Server, nutze den angezeigten --code-Fallback. Die OpenClaw-Anleitung zur OAuth-Anmeldung erklärt beide Wege.
3. Führe den Prüfbefehl aus dem Dialog aus. openclaw mcp probe <Servername> baut eine Verbindung auf und prüft die verfügbaren Tools.
4. Starte eine neue Agent-Sitzung und frage: „Welche Bankkonten sind verbunden?“ Fehlen die Tools, starte das laufende Gateway neu und prüfe das Tool-Profil: coding und messaging erlauben MCP; minimal blendet diese Tools aus.

openclaw mcp reload lädt nur den eigenen CLI-Prozess neu. Ein separat laufendes Gateway braucht seinen eigenen Neustart. Diese Unterschiede beschreibt die OpenClaw-Anleitung zur MCP-Verwaltung.

Verfügbare Werkzeuge

get_categories liest die Kategorieliste über die API. Mit der optionalen numerischen categoryId ruft der Client eine einzelne Kategorie ab. Die Antwort enthält id, name und gegebenenfalls Unterkategorien in children. So kann der Client passende IDs oder exakte Namen für die Filter wählen. Das Werkzeug braucht categories:read.

get_transactions liefert eine Liste ohne Suchtext. Diese optionalen Parameter grenzen sie ein und bestimmen ihre Reihenfolge:

Wenn du category und parentCategory gemeinsam angibst, verknüpft die API sie mit ODER: Sie liefert Buchungen der exakten Kategorie sowie Buchungen, deren übergeordnete Kategorie parentCategory entspricht. Ohne eigene Sortierung gilt _id absteigend. Datumsgrenzen sind einschließlich; ein Datum ohne Uhrzeit bezeichnet Mitternacht zu Beginn dieses Tages, nicht dessen Ende. Für genaue Zeiträume verwende vollständige ISO-Zeitstempel mit Zeitzone.

search_transactions benötigt den Suchtext query. Der Modus search ist die Voreinstellung und nutzt die reguläre API-Suche. Mit mode: "match" nutzt der Client den Matching-Endpunkt, etwa um Buchungen zu einer Rechnungsreferenz zu finden. Die Suchanfrage wird an den jeweiligen API-Endpunkt weitergegeben. Beide Modi unterstützen accountId, die Buchungsgrenzen startDate und endDate sowie limit (standardmäßig 10, höchstens 50) und offset.

Das Matching verwendet den API-Standardschwellenwert von 0.6. Die gelieferten Scores bewerten die Textübereinstimmung; sie sind keine Wahrscheinlichkeiten und bestätigen keine Zahlung. Beide Transaktionswerkzeuge brauchen die Leseberechtigung transactions:read.

Der Client sieht nur Werkzeuge, die in der Integration freigegeben sind und zu seinen Berechtigungen passen. Alle Tools gibt auch künftig ergänzte Tools frei und umfasst damit search_transactions und get_categories. Bei einer bestehenden Auswahl einzelner Werkzeuge musst du neue Tools zusätzlich aktivieren. Prüfe für get_categories auch die Berechtigung categories:read der Verbindung.

Für eine erste Prüfung kannst du den Client bitten, die verfügbaren Konten aufzulisten. Kontrolliere, ob nur die vorgesehenen Konten erscheinen.

Zugang über OAuth

Für Clients mit OAuth-Unterstützung:

1. Öffne OAuth2-Einstellungen und prüfe OAuth-Autorisierungsserver aktivieren.
2. Lege unter Erlaubte Scopes fest, welche Berechtigungen die Integration vergeben darf. Für MCP-Zugriff wird mcp:tools benötigt; Konten, Transaktionen und Kategorien brauchen zusätzlich ihre jeweilige Leseberechtigung.
3. Wenn sich dein Client selbst registriert, aktiviere Dynamic Client Registration erlauben. Andernfalls erstelle eine OAuth-App unter Registrierte Apps.
4. Klicke auf OAuth-Einstellungen speichern.
5. Starte die Verbindung im Client und bestätige den Zugriff in Kontoflux.io.

Eine dynamische Registrierung legt nur die App an. Zugriff auf deine Bankdaten erhält sie erst, wenn du dich bei Kontoflux.io anmeldest und die Verbindung für deinen Workspace bestätigst.

Zugang über einen statischen Schlüssel

Wenn dein Client einen Bearer-Schlüssel statt OAuth verwendet:

1. Öffne API-Schlüssel in der MCP-Integration.
2. Klicke auf Neuer MCP-Schlüssel.
3. Kopiere den vollständigen Schlüssel und prüfe seinen Aktivierungsstatus.
4. Hinterlege ihn im Client für die kopierte MCP URL als Bearer-Schlüssel.

Diese Schlüssel beginnen mit mcp- und gehören zu einer bestimmten Integration. Ein normaler sk--Schlüssel aus dem API-Tab passt nicht zur MCP-URL.

Den Kontoumfang dieser Schlüssel legst du im Bereich Bankkonten der Integration fest. Die Schlüsselansicht bietet Kopieren, Aktivieren, Neugenerieren und Löschen.

Bankkonten begrenzen

Alle Bankkonten umfasst vorhandene und später hinzugefügte Konten. Eine Auswahl einzelner Konten begrenzt den Zugriff der gesamten Integration, einschließlich ihrer OAuth-Verbindungen und MCP-Schlüssel.

Mit Bankkonten beim Verbinden auswählen erhält der OAuth-Zustimmungsdialog eine zusätzliche Kontenauswahl. Du kannst dann innerhalb der Freigabe der Integration einzelne eigene Konten auswählen.

Änderungen an der Kontenauswahl gelten auch für bestehende Zugänge. Bereits in einen Client übernommene Daten werden dadurch dort nicht gelöscht.

Verbindung beenden

Über Registrierte Apps → Widerrufen entziehst du einer OAuth-App den Zugriff. Einen statischen Schlüssel deaktivierst oder löschst du im Bereich API-Schlüssel. Der Aktivierungsschalter der Integration sperrt die gesamte MCP-Instanz.

Wenn der Client keine Tools sieht, prüfe Werkzeugauswahl und OAuth-Scopes. Bei einer nicht erreichbaren URL prüfe außerdem den Aktivierungsstatus und ob die URL zur richtigen Integration gehört.