Zum Inhalt springen

Installation

Diese Seite führt Sie in etwa zehn Minuten von null zu einem funktionierenden avenir-mcp. Jeder Schritt endet mit einer Prüfung, damit Sie wissen, dass er geklappt hat, bevor Sie weitermachen.

  1. uv installieren, das Tool, das avenir-mcp ausführt.
  2. Ein YNAB-Token besorgen, den Zugang von avenir-mcp zu Ihren Plans.
  3. Prüfen, ob avenir-mcp startet, einmal von Hand.
  4. avenir-mcp zu Ihrem Client hinzufügen.
  5. Prüfen, ob es funktioniert, mit einer ersten Frage.
  6. Änderungen erlauben, wenn der Agent für Sie aufräumen soll.
Wozu Woher
Ein YNAB-Konto avenir-mcp liest und ändert Ihre Plans app.ynab.com
Einen MCP-Client die Anwendung, mit der Sie sprechen; sie startet avenir-mcp Claude Code, Claude Desktop, Cursor, VS Code…
uv lädt avenir-mcp und das nötige Python herunter und führt sie in einer isolierten Umgebung aus der nächste Schritt

Sie müssen Python nicht installieren, das Repository nicht klonen und keine virtuelle Umgebung anlegen: Das alles erledigt uv.

In einem Terminal:

Terminal-Fenster
curl -LsSf https://astral.sh/uv/install.sh | sh

Oder mit Homebrew: brew install uv.

Schließen Sie das Terminal und öffnen Sie es erneut, dann prüfen Sie:

Terminal-Fenster
uv --version

Es wird eine Version ausgegeben, etwa uv 0.12.19. Command not found? Der Installer fügt uv nur dem PATH neuer Terminals hinzu: Öffnen Sie ein neues. Details in der Dokumentation von uv.

  1. Melden Sie sich bei YNAB in einem Webbrowser an, unter app.ynab.com – die mobilen Apps zeigen die Entwicklereinstellungen nicht.
  2. Klicken Sie oben links auf Ihren Namen, dann auf Account Settings.
  3. Öffnen Sie Developer Settings.
  4. Klicken Sie unter Personal Access Tokens auf New Token, geben Sie Ihr YNAB-Passwort ein, dann Generate.
  5. Kopieren Sie das oben auf der Seite angezeigte Token: eine lange Folge aus Buchstaben, Ziffern und Bindestrichen. YNAB zeigt es nur ein einziges Mal. Wenn Sie es verlieren, legen Sie ein neues an und widerrufen Sie das alte.

Eine einzige Datei installiert avenir-mcp, das Python, auf dem es läuft, und die Einstellungen, die es braucht. In diesem Abschnitt gibt es weder ein Terminal noch eine Konfigurationsdatei, und kein Schritt davon ist unter Windows, macOS oder Linux anders, außer wo es dort steht.

Download für Claude Desktop

Es handelt sich stets um die Datei der neuesten Version; welche Version installiert wird, ist darin vermerkt, und die folgenden Schritte sind unabhängig davon immer dieselben.

  1. Installieren Sie Claude Desktop, falls noch nicht geschehen, von claude.ai/download, und öffnen Sie es einmal.

  2. Laden Sie die Erweiterung herunter, über die Schaltfläche oben oder über diesen Link. Sie ist etwa 17 kB groß und wird unter dem Namen avenir-mcp.mcpb in Ihrem Download-Ordner gespeichert.

    Unter Windows warnen Edge oder Chrome Sie möglicherweise, dass die Datei selten heruntergeladen wird. Diese Warnung betrifft, wie selten die Datei ist, nicht ihren Inhalt: Klicken Sie auf die drei Punkte neben dem Download, dann auf Keep. Was Sie stattdessen an der Datei prüfen können, steht in SECURITY.md.

  3. Ziehen Sie die Datei auf Settings → Extensions. Öffnen Sie Claude Desktop und wählen Sie anschließend Settings → Extensions: Auf diesem Bildschirm werden Ihre installierten Erweiterungen aufgelistet, und dort wird die Datei installiert. Nehmen Sie die Datei avenir-mcp.mcpb aus Ihrem Download-Ordner oder aus der Download-Liste Ihres Browsers und ziehen Sie sie auf diesen Bildschirm. Der Installationsdialog wird geöffnet.

    Ein Doppelklick auf die Datei könnte ebenfalls funktionieren, sofern Ihr System .mcpb-Dateien bereits mit Claude Desktop öffnet. Sollte Windows Sie stattdessen fragen, mit welcher Anwendung die Datei geöffnet werden soll, schließen Sie dieses Fenster: .mcpb-Dateien sind mit keiner Anwendung verknüpft, und die Suche nach claude.exe liefert keine Ergebnisse. Ziehen Sie die Datei stattdessen auf den Bildschirm Extensions.

    Funktioniert keines von beiden? Öffnen Sie auf demselben Bildschirm die Advanced settings und wählen Sie unter Extension Developer die Option Install Extension…; wählen Sie die Datei aus Ihrem Download-Ordner aus.

  4. Installieren Sie sie. Das Dialogfeld nennt den Namen der Erweiterung, avenir-mcp for YNAB, und sagt, was sie tut. Klicken Sie auf Install.

  5. Fügen Sie Ihr Token in das Feld YNAB personal access token ein, das Token aus dem Schritt davor. Strg + V unter Windows und Linux, ⌘ + V unter macOS. Das Feld verbirgt, was Sie einfügen; Claude Desktop verwahrt es dort, wo Ihr System Passwörter verwahrt, und es steht in keiner Datei, die Sie öffnen können.

  6. Lassen Sie das Kästchen Allow changes to your plans leer, und speichern Sie dann. avenir-mcp beantwortet Fragen und ändert nichts, solange das Kästchen leer bleibt. Sie können es später jederzeit ankreuzen, an derselben Stelle.

  7. Prüfen Sie, ob sie da ist. Settings → Extensions führt nun avenir-mcp for YNAB auf, eingeschaltet.

  8. Fragen Sie es etwas. Schreiben Sie in einem neuen Gespräch: „Liste meine YNAB-Pläne auf.“ Claude bittet Sie beim ersten Mal, das Tool zu erlauben; erlauben Sie es, und die Antwort nennt die Namen Ihrer Pläne. Die allererste Antwort dauert ein paar Sekunden länger als die danach, während Claude Desktop Python und avenir-mcp holt.

Die Installation ist fertig. Der Rest dieser Seite handelt von den anderen Clients und von der Installation von Hand; weiter mit Ihrem ersten Gespräch, oder mit Änderungen erlauben, wenn der Agent für Sie aufräumen soll.

Um Tun Sie
Das Token zu ändern, oder Änderungen zu erlauben Settings → Extensions → avenir-mcp for YNAB
Zu aktualisieren Laden Sie die Erweiterung erneut herunter und ziehen Sie sie auf dem Bildschirm Settings → Extensions über die bereits installierte Erweiterung; über den Link erhalten Sie stets die neueste Version
Zu entfernen Entfernen Sie sie unter Settings → Extensions; das Token geht mit ihr

Bevor Sie einen Client einrichten, führen Sie avenir-mcp einmal von Hand aus. Dabei wird es heruntergeladen, und Sie sehen, dass es startet.

Terminal-Fenster
YNAB_API_KEY=ihr-token uvx avenir-mcp

Der erste Start lädt avenir-mcp und Python herunter: einige Sekunden bis eine Minute. Danach wird nichts ausgegeben und der Befehl kehrt nicht zurück – das ist so gewollt: avenir-mcp wartet darauf, dass ein Client mit ihm spricht. Drücken Sie Strg+C, um es zu beenden.

Stattdessen erscheint ein Fehler? Siehe Fehlerbehebung.

Wählen Sie Ihren Client. Diese Konfigurationen sind nur lesend: avenir-mcp kann Fragen beantworten, aber nichts ändern. Änderungen erlauben folgt danach. In Cursor, LM Studio und VS Code können Sie es mit einem Klick über die Schaltfläche oben auf der jeweiligen Registerkarte installieren.

In einem Terminal:

Terminal-Fenster
claude mcp add avenir-mcp --scope user \
--env YNAB_API_KEY=ihr-token \
-- uvx avenir-mcp
Teil Bedeutung
claude mcp add avenir-mcp einen MCP-Server namens avenir-mcp registrieren
--scope user für alle Ihre Projekte; ohne diese Option nur für den aktuellen Ordner
--env YNAB_API_KEY=… die Umgebung, mit der avenir-mcp startet
-- was folgt, ist der Befehl, der den Server startet
uvx avenir-mcp dieser Befehl

Claude Code speichert das, samt Token, in ~/.claude.json, nur für Sie lesbar.

Terminal-Fenster
claude mcp list

avenir-mcp sollte verbunden sein:

avenir-mcp: uvx avenir-mcp - ✔ Connected

Starten Sie dann claude und geben Sie /mcp ein: avenir-mcp zeigt seine 19 Tools.

Fragen Sie nun in einem neuen Gespräch: „Liste meine YNAB-Pläne auf.“ Der Agent ruft list_plans auf – Ihr Client fragt Sie vielleicht um Erlaubnis – und antwortet mit ihren Namen. Hier der Demo-Plan, der in dieser gesamten Dokumentation verwendet wird:

list_plans
[
{
"id": "demo-budget",
"name": "Demo-Haushalt",
"first_month": "2026-06-01",
"last_month": "2026-09-01"
}
]

avenir-mcp funktioniert. Weiter mit Ihrem ersten Gespräch oder zuerst Änderungen erlauben.

Damit der Agent Transaktionen kategorisieren, Geld zwischen Kategorien verschieben oder Konten abgleichen kann, fügen Sie der Umgebung von avenir-mcp AVENIR_MCP_WRITE=1 hinzu.

Aus der Erweiterung installiert: Öffnen Sie Settings → Extensions → avenir-mcp for YNAB, setzen Sie das Häkchen bei Allow changes to your plans, speichern Sie, und starten Sie Claude Desktop neu. Die Erweiterung setzt die Variable für Sie, es gibt nichts zu tippen.

Der Wert muss genau 1 sein. Prüfen Sie: Der Client listet nun 32 Tools statt 19.

Nur lesend (Standard) Mit AVENIR_MCP_WRITE=1
Aufgelistete Tools 19 32
Kategorisieren, budgetieren, abgleichen, anlegen — als Vorschau gezeigt, von Ihnen bestätigt, rückgängig zu machen
Wenn der Agent etwas missversteht nichts kann sich ändern eine Änderung, die Sie bestätigt haben und rückgängig machen können

Jede Änderung wird Ihnen gezeigt, bevor sie angewendet wird: siehe Sicherheit durch Design.

Um Tun Sie
Zu aktualisieren uvx holt von Zeit zu Zeit selbst neue Versionen; erzwingen Sie es mit uvx --refresh avenir-mcp. Die Claude-Desktop-Erweiterung wird aktualisiert, indem Sie sie erneut herunterladen und auf dem Bildschirm Settings → Extensions über die bereits installierte Erweiterung ziehen
Zu entfernen claude mcp remove avenir-mcp --scope user, oder löschen Sie den Eintrag avenir-mcp aus der Konfiguration des Clients. Die Erweiterung entfernen Sie unter Settings → Extensions, mitsamt dem Token
Aufzuräumen Die einzige Datei von avenir-mcp auf Ihrem Rechner ist sein Journal, in ~/.local/state/avenir-mcp/
Das Token zu widerrufen YNAB → Account Settings → Developer Settings → Revoke neben dem Token

Inoffizielles Projekt. „We are not affiliated, associated, or in any way officially connected with YNAB or any of its subsidiaries or affiliates. The official YNAB website can be found at https://www.ynab.com. The names YNAB and You Need A Budget, as well as related names, tradenames, marks, trademarks, emblems, and images are registered trademarks of YNAB.“ Wir sind mit YNAB oder einer seiner Tochtergesellschaften oder verbundenen Unternehmen weder verbunden noch assoziiert noch in irgendeiner Weise offiziell verknüpft. Die offizielle Website von YNAB finden Sie unter https://www.ynab.com. Die Namen YNAB und You Need A Budget sowie zugehörige Namen, Handelsnamen, Zeichen, Marken, Embleme und Bilder sind eingetragene Marken von YNAB. avenir-mcp wird ohne Gewähr bereitgestellt und ist keine Finanzberatung. Rechtliche Hinweise · Datenschutz