Ga naar inhoud

Installatie

Op deze pagina leert u in ongeveer tien minuten hoe u vanuit het niets een werkende avenir-mcp kunt opzetten. Elke stap wordt afgesloten met een controle, zodat u weet of het gelukt is voordat u verdergaat.

  1. Installeer uv, de tool waarmee avenir-mcp wordt uitgevoerd.
  2. Vraag een YNAB-token aan, waarmee avenir-mcp toegang krijgt tot uw plannen.
  3. Controleer of avenir-mcp één keer handmatig start.
  4. Voeg avenir-mcp toe aan uw client.
  5. Controleer of het werkt aan de hand van een eerste vraag.
  6. Sta wijzigingen toe, indien u wilt dat de agent het voor u op orde brengt.
Waarom Waar kunt u het verkrijgen
Een YNAB-account avenir-mcp leest en wijzigt uw plannen app.ynab.com
Een MCP-client de applicatie waarmee u communiceert; deze start avenir-mcp Claude Code, Claude Desktop, Cursor, VS Code…
uv downloadt en voert avenir-mcp uit, samen met de benodigde Python-omgeving, in een geïsoleerde omgeving de volgende stap

Je hoeft Python niet te installeren, de repository niet te klonen en geen virtuele omgeving aan te maken: uv doet dat allemaal.

In een terminal:

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

Of met Homebrew: brew install uv.

Sluit de terminal en open hem opnieuw, en controleer dan:

Terminal window
uv --version

Er verschijnt een versie, zoals uv 0.12.19. Command not found? Het installatieprogramma voegt uv alleen toe aan het PATH van nieuwe terminals: open een nieuwe. Details in de documentatie van uv.

  1. Meld u aan bij YNAB in een webbrowser op app.ynab.com — de mobiele apps geven geen ontwikkelaarsinstellingen weer.
  2. Klik linksboven op uw naam en vervolgens op Accountinstellingen.
  3. Open Ontwikkelaarsinstellingen.
  4. Klik onder Persoonlijke toegangstokens op Nieuw token, voer uw YNAB-wachtwoord in en klik vervolgens op Genereren.
  5. Kopieer het token dat bovenaan de pagina wordt weergegeven: een lange reeks letters, cijfers en streepjes. YNAB toont dit slechts één keer. Mocht u het kwijtraken, maak dan een nieuw token aan en trek het oude token in.

Eén bestand installeert avenir-mcp, de Python waarop het draait en de instellingen die het nodig heeft. In dit gedeelte komt geen terminal en geen configuratiebestand voor, en geen van de stappen verschilt op Windows, macOS of Linux, behalve waar dat er staat.

Download voor Claude Desktop

Het bestand is altijd dat van de nieuwste release; in het bestand staat vermeld welke versie wordt geïnstalleerd, en de onderstaande stappen zijn in alle gevallen hetzelfde.

  1. Installeer Claude Desktop, als u dat nog niet hebt gedaan, via claude.ai/download, en open het één keer.

  2. Download de extensie via de knop hierboven of via deze link. Het bestand is ongeveer 17 kB groot en wordt in uw downloadmap opgeslagen onder de naam avenir-mcp.mcpb.

    Op Windows waarschuwen Edge of Chrome u mogelijk dat het bestand niet vaak wordt gedownload. Die waarschuwing gaat over hoe zeldzaam het bestand is, niet over wat erin zit: klik op de drie puntjes naast de download, en dan op Keep. Wat u in plaats daarvan aan het bestand kunt controleren, staat in SECURITY.md.

  3. Sleep het bestand naar Settings → Extensions. Open Claude Desktop en ga vervolgens naar Settings → Extensions: op dat scherm ziet u een overzicht van de extensies die u hebt, en daar wordt het bestand geïnstalleerd. Neem het bestand avenir-mcp.mcpb uit uw downloadmap of uit de downloadlijst van uw browser en sleep het naar dat scherm. Het installatiedialoogvenster wordt geopend.

    Dubbelklikken op het bestand kan ook werken, als uw systeem .mcpb-bestanden al met Claude Desktop opent. Mocht Windows u in plaats daarvan vragen met welk programma u het bestand wilt openen, sluit dat venster dan: aan .mcpb-bestanden is geen programma gekoppeld, en als u naar claude.exe zoekt, vindt u niets. Sleep het bestand in plaats daarvan naar het scherm Extensions.

    Werkt geen van beide? Open op datzelfde scherm de Advanced settings en klik onder Extension Developer op Install Extension…; kies het bestand uit uw downloadmap.

  4. Installeer de extensie. Het dialoogvenster geeft de naam van de extensie, avenir-mcp for YNAB, en zegt wat ze doet. Klik op Install.

  5. Plak uw token in het veld YNAB personal access token, het token uit de stap hiervoor. Ctrl + V op Windows en Linux, ⌘ + V op macOS. Het veld verbergt wat u erin plakt; Claude Desktop bewaart het waar uw systeem wachtwoorden bewaart, en het staat in geen enkel bestand dat u kunt openen.

  6. Laat het vakje Allow changes to your plans uit staan, en sla op. avenir-mcp beantwoordt vragen en wijzigt niets zolang dat vakje uit staat. U kunt het later aanvinken, op dezelfde plek.

  7. Controleer of ze er staat. Settings → Extensions vermeldt nu avenir-mcp for YNAB, ingeschakeld.

  8. Vraag het iets. Schrijf in een nieuw gesprek: „Geef een overzicht van mijn YNAB-plannen.” Claude vraagt u de eerste keer om het gereedschap toe te staan; sta het toe, en het antwoord geeft de namen van uw plannen. Het allereerste antwoord duurt een paar seconden langer dan de volgende, terwijl Claude Desktop Python en avenir-mcp ophaalt.

De installatie is klaar. De rest van deze pagina gaat over de andere clients en over installeren met de hand; ga verder met uw eerste gesprek, of met wijzigingen toestaan als u wilt dat de agent voor u opruimt.

Naar Do
Het token wijzigen, of wijzigingen toestaan Settings → Extensions → avenir-mcp for YNAB
Bijwerken download de extensie opnieuw en sleep deze naar het scherm Settings → Extensions, waar u deze over de reeds geïnstalleerde versie heen plaatst; via de link krijgt u altijd de nieuwste versie
Verwijderen verwijder de extensie via Settings → Extensions; het token gaat mee

Voordat u een client configureert, dient u ‘avenir-mcp’ eenmaal handmatig uit te voeren. Hierdoor wordt het programma gedownload en wordt aangetoond dat het opstart.

Terminal window
YNAB_API_KEY=uw-token uvx avenir-mcp

De eerste keer worden avenir-mcp en Python gedownload: een paar seconden tot een minuut. Daarna wordt er niets getoond en keert het commando niet terug – dat hoort zo: avenir-mcp wacht tot een client met hem praat. Druk op Ctrl+C om het te stoppen.

Verschijnt er in plaats daarvan een fout? Zie Probleemoplossing.

Kies uw client. Deze instellingen zijn alleen-lezen: avenir-mcp kan vragen beantwoorden, maar niets wijzigen. De optie om wijzigingen toe te staan volgt later.] In Cursor, LM Studio en VS Code kunt u het met één muisklik installeren via de knop bovenaan het tabblad.

In een terminal:

Terminal window
claude mcp add avenir-mcp --scope user \
--env YNAB_API_KEY=uw-token \
-- uvx avenir-mcp
Deel Betekenis
claude mcp add avenir-mcp registreer een MCP-server met de naam avenir-mcp
--scope user voor al uw projecten; laat dit weg om de server alleen voor de huidige map te registreren
--env YNAB_API_KEY=… de omgeving waarmee avenir-mcp wordt gestart
-- wat hierna volgt, is het commando waarmee de server wordt gestart
uvx avenir-mcp dat commando

Claude Code bewaart dit, inclusief het token, in ~/.claude.json, waar alleen u toegang toe heeft.

Terminal window
claude mcp list

avenir-mcp hoort verbonden te zijn:

avenir-mcp: uvx avenir-mcp - ✔ Connected

Start dan claude en typ /mcp: avenir-mcp toont zijn 19 tools.

Vraag nu, in een nieuw gesprek: „Geef een overzicht van mijn YNAB-plannen.” De agent roept op list_plans — uw cliënt kan u vragen om dit toe te staan — en geeft de namen ervan weer. Hier volgt het demoplan dat in deze documentatie wordt gebruikt:

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

avenir-mcp werkt. Ga verder met uw eerste gesprek, of sta eerst wijzigingen toe.

Om de agent in staat te stellen transacties te classificeren, geld tussen categorieën over te boeken of rekeningen af te stemmen, voegt u dit toe aanAVENIR_MCP_WRITE=1 de omgeving van avenir-mcp.

Geïnstalleerd vanuit de extensie: open Settings → Extensions → avenir-mcp for YNAB, vink Allow changes to your plans aan, sla op, en start Claude Desktop opnieuw. De extensie zet de variabele voor u, er valt niets te typen.

De waarde moet precies 1 zijn. Controleer: de client toont nu 32 tools in plaats van 19.

Alleen-lezen (standaard) Met AVENIR_MCP_WRITE=1
Aantal weergegeven tools 19 32
Classificeren, begroten, afstemmen, aanmaken — in voorbeeldweergave, door u bevestigd, ongedaan te maken
Indien de agent een door u bevestigde wijziging verkeerd begrijpt kan er niets worden gewijzigd een wijziging die u hebt bevestigd en die u ongedaan kunt maken

Elke wijziging wordt u getoond voordat deze wordt doorgevoerd: zie Veiligheid door ontwerp.

Naar Do
Bijwerken uvxhaalt van tijd tot tijd zelf nieuwe versies op; forceer dit met uvx --refresh avenir-mcp. De Claude Desktop-extensie wordt bijgewerkt door deze opnieuw te downloaden en in het scherm Settings → Extensions op de reeds geïnstalleerde extensie te slepen
Verwijderen claude mcp remove avenir-mcp --scope user, of verwijder de vermeldingavenir-mcp uit de configuratie van de client . De extensie verwijdert u via Settings → Extensions, token inbegrepen
Opschonen Het enige bestand van avenir-mcp op uw computer is het logboek, in ~/.local/state/avenir-mcp/
Het token intrekken YNAB → Accountinstellingen → Ontwikkelaarsinstellingen → Intrekken naast het token

Onofficieel project. “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.” We zijn op geen enkele manier verbonden, geassocieerd of officieel gelieerd aan YNAB of een van zijn dochterondernemingen of gelieerde bedrijven. De officiële website van YNAB vind je op https://www.ynab.com. De namen YNAB en You Need A Budget, evenals verwante namen, handelsnamen, merken, emblemen en afbeeldingen, zijn geregistreerde handelsmerken van YNAB. avenir-mcp wordt geleverd zoals het is, zonder garantie, en is geen financieel advies. Juridische informatie · Privacy