KI-Verbindung: was tun, wenn sie nicht funktioniert

„Unauthorized” oder der Client bittet um eine neue Verbindung

Der Access-Token gilt 1 Stunde, der Refresh-Token 60 Tage. Clients erneuern selbstständig; ist der Refresh-Token abgelaufen oder haben Sie den Konnektor in Assetli entfernt, muss der Client erneut durch die Zustimmung. Das ist normal. Geschieht es alle paar Minuten, speichert der Client den Refresh-Token nicht; verbinden Sie von vorn, indem Sie den Konnektor auf beiden Seiten entfernen.

Der Zustimmungsbildschirm erscheint bei jeder Verbindung

Manche Anwendungen registrieren bei jeder Verbindung einen neuen OAuth-Client (dynamische Registrierung). Jede Registrierung ist aus Sicht von Assetli ein neuer Konnektor, deshalb wird erneut nach Zustimmung gefragt. Das schadet nicht; alte Konnektoren ohne Tokens laufen von selbst ab. Reste entfernen Sie unter Kontomenü → KI-Verbindung (MCP).

Die KI bietet keine Schreibwerkzeuge an

Welche Werkzeuge ein Client erhält, bestimmt die auf dem Zustimmungsbildschirm erteilte Berechtigung. Mit Lesen und Schreiben erhält er die Vorschau- und Schreibwerkzeuge in jedem Tarif; schreiben lässt sich aber nur im Tarif Premium oder Max (die 30-tägige Testphase zählt mit), im Tarif Free lehnt der Server sie ab. Nur mit Lesen erhält er die Schreibwerkzeuge nie; entfernen Sie den Konnektor und verbinden Sie erneut mit Lesen und Schreiben. Ausnahme: Ein Konnektor, der vor dem 30. 10. 2026 im Tarif Free hinzugefügt wurde, merkt sich eine Liste ohne Schreibwerkzeuge; entfernen und verbinden Sie ihn nach einem Upgrade daher einmal neu (in ChatGPT genügt es, die App unter Settings → Apps zu aktualisieren).

Die KI sagt, sie habe das Werkzeug nicht oder könne die Änderung nicht vornehmen

Typischerweise im Tarif Free oder bei einer Verbindung nur zum Lesen: Sie bitten darum, eine Umbuchung zu verknüpfen, eine Regel anzulegen oder einen Kontostand zu bestätigen, und die KI antwortet, dass sie kein solches Werkzeug hat oder der Server es abgelehnt hat. Das ist richtig; Schreiben über KI braucht die Berechtigung Schreiben und den Tarif Premium oder Max. Assetli teilt der KI das gleich beim Verbinden mit (Tarif, Berechtigung und warum das Schreiben fehlt), sodass sie Ihnen den Grund erklären und einen Link anbieten sollte, über den Sie die Änderung selbst vornehmen.

Lesewerkzeuge liefern dafür Links direkt zur Aktion in der Web-App:

• eine Umbuchung zum Verknüpfen: die Transaktion mit bereits geöffnetem „Mit Umbuchung verknüpfen…“,
• Transaktionen: die Transaktionsdetails (Kategorie, Regel, Verknüpfung) und die Liste der nicht kategorisierten,
• Kategorisierungsregeln: der Reiter Regeln,
• ein Konto ohne neue Daten: das Bearbeiten des Kontos und die Kontenübersicht mit der Schaltfläche „Saldo stimmt“.

Der Link öffnet sich in dem Profil, das im Web gerade gewählt ist; ist der Konnektor mit einem anderen Profil verbunden, wechseln Sie zuerst das Profil. Die mobile App hat dieselben Aktionen. Schreiben über KI aktivieren Sie mit dem Wechsel zu Premium (eine Verbindung mit der Berechtigung Lesen und Schreiben schreibt dann sofort, ohne neue Verbindung) oder, wenn Sie nur Lesen erteilt haben, mit einer neuen Verbindung mit Lesen und Schreiben.

„This operation requires the write scope”

Sie haben nur Lesen erteilt. Entfernen Sie den Konnektor in Assetli und verbinden Sie erneut; wählen Sie auf dem Zustimmungsbildschirm Lesen und Schreiben.

„Writing and importing over MCP are part of the Premium plan”

Lesen ist in jedem Tarif kostenlos, Schreiben erfordert Premium oder Max. Den Tarif ändern Sie unter Kontomenü → Mein Tarif.

Im Tarif Free sieht der Client die Schreibwerkzeuge (wenn Sie Lesen und Schreiben erteilt haben), der Server lehnt aber jeden Aufruf ab, Vorschauen (prepare_*) eingeschlossen, es wird also nichts geschrieben. Die KI sollte Ihnen das einmal sagen und einen Link anbieten, über den Sie die Änderung selbst in der Web-App vornehmen, sowie einen direkten Link zum Wechsel zu Premium (er öffnet nach der Anmeldung die sichere Zahlung). Nach dem Wechsel zu Premium funktioniert das Schreiben sofort, ohne neue Verbindung.

„Missing confirmation_token”, „expired”, „arguments differ from the preview”

Jeder Schreibvorgang braucht einen Token aus seinem Vorschauwerkzeug, gültig 10 Minuten und an die genauen Werte der Vorschau gebunden. Die Meldungen sagen dem Modell, was zu tun ist: die Vorschau wiederholen, sie Ihnen zeigen und den neuen Token übergeben. Scheitert das Modell an dieser Stelle wiederholt, weisen Sie es ausdrücklich an, zuerst das Vorschauwerkzeug aufzurufen. Es ist der Server, der einen Schreibvorgang ohne Vorschau ablehnt, kein Fehler in Ihrer Verbindung.

Die KI sieht das falsche Profil oder nicht alle Profile

Ein Konnektor ist an das eine Profil gebunden, das Sie auf dem Zustimmungsbildschirm gewählt haben, und kann nicht wechseln. Für ein anderes Profil entfernen Sie den Konnektor und verbinden erneut mit der anderen Profilwahl. Für mehrere Profile gleichzeitig verbinden Sie sich mehrfach und benennen die Konnektoren im Client unterschiedlich.

ChatGPT liest, weigert sich aber zu schreiben

OpenAI erlaubt zum Zeitpunkt des Schreibens eigene Konnektoren mit Schreibrechten nur in Business-, Enterprise- und Edu-Workspaces. In den Tarifen Plus und Pro wird die in Assetli erteilte Schreibberechtigung nicht genutzt. Das ist eine Einschränkung von OpenAI; den aktuellen Stand finden Sie in deren Dokumentation.

Gemini kann den Konnektor nicht hinzufügen

In der Gemini-App lassen sich eigene Apps nur im Web hinzufügen, mit einem privaten Google-Konto, ab 18 Jahren, in den USA, mit der App auf Englisch und eingeschalteten Gemini-Apps-Aktivitäten. Außerhalb dieser Bedingungen fehlt die Option. Gemini CLI und Gemini Enterprise können den Server über den Transport Streamable HTTP und OAuth hinzufügen. Die Schritte stehen unter Gemini verbinden.

„Unknown tool”

Der Client nutzt eine gespeicherte Werkzeugliste, die nicht mehr zum Server passt, etwa nach der Umbenennung eines Werkzeugs. Trennen und erneut verbinden, dann wird die Liste aktualisiert. Dasselbe gilt, wenn neue Werkzeuge hinzugekommen sind und die KI sie nicht kennt.

Die Konnektor-URL

https://assetli.app/api/mcp, Transport Streamable HTTP. Der Server beantwortet JSON-RPC nur über POST; er bietet keinen vom Server ausgehenden Stream (GET liefert 405) und stellt ausschließlich Werkzeuge bereit, keine Ressourcen oder Prompts.

Wie Sie nachsehen, was passiert ist

Unter Kontomenü → KI-Verbindung (MCP) sehen Sie jeden Konnektor mit seiner Berechtigung sowie die Historie der von der KI ausgeführten Schreibvorgänge im gerade gewählten Profil: Werkzeug, Konnektor, Zeit, Ergebnis und eine Zusammenfassung der Argumente. Lesezugriffe werden nicht protokolliert.