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.
- Installeer uv, de tool waarmee avenir-mcp wordt uitgevoerd.
- Vraag een YNAB-token aan, waarmee avenir-mcp toegang krijgt tot uw plannen.
- Controleer of avenir-mcp één keer handmatig start.
- Voeg avenir-mcp toe aan uw client.
- Controleer of het werkt aan de hand van een eerste vraag.
- Sta wijzigingen toe, indien u wilt dat de agent het voor u op orde brengt.
Wat u nodig hebt
Section titled “Wat u nodig hebt”| 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.
uv installeren
Section titled “uv installeren”In een terminal:
curl -LsSf https://astral.sh/uv/install.sh | shOf met Homebrew: brew install uv.
In PowerShell:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"Of met WinGet: winget install --id=astral-sh.uv -e.
Sluit de terminal en open hem opnieuw, en controleer dan:
uv --versionEr 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.
Een YNAB-token aanmaken
Section titled “Een YNAB-token aanmaken”- Meld u aan bij YNAB in een webbrowser op app.ynab.com — de mobiele apps geven geen ontwikkelaarsinstellingen weer.
- Klik linksboven op uw naam en vervolgens op Accountinstellingen.
- Open Ontwikkelaarsinstellingen.
- Klik onder Persoonlijke toegangstokens op Nieuw token, voer uw YNAB-wachtwoord in en klik vervolgens op Genereren.
- 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.
De Claude Desktop-extensie installeren
Section titled “De Claude Desktop-extensie installeren”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 DesktopHet 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.
-
Installeer Claude Desktop, als u dat nog niet hebt gedaan, via claude.ai/download, en open het één keer.
-
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.
-
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.mcpbuit 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 naarclaude.exezoekt, 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.
-
Installeer de extensie. Het dialoogvenster geeft de naam van de extensie, avenir-mcp for YNAB, en zegt wat ze doet. Klik op Install.
-
Plak uw token in het veld YNAB personal access token, het token uit de stap hiervoor.
Ctrl+Vop Windows en Linux,⌘+Vop 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. -
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.
-
Controleer of ze er staat. Settings → Extensions vermeldt nu avenir-mcp for YNAB, ingeschakeld.
-
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 |
Controleren of avenir-mcp start
Section titled “Controleren of avenir-mcp start”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.
YNAB_API_KEY=uw-token uvx avenir-mcp$env:YNAB_API_KEY = "uw-token"; uvx avenir-mcpDe 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.
Voeg avenir-mcp toe aan uw client
Section titled “Voeg avenir-mcp toe aan uw client”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:
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.
De extensie is de korte weg, en de weg zonder terminal: De Claude Desktop-extensie installeren.
Of met de hand, als u de configuratie liever zelf schrijft:
- Open Claude Desktop en ga vervolgens naar Instellingen → Ontwikkelaar → Configuratie bewerken. Hiermee opent u
claude_desktop_config.json:- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json- Windows:%APPDATA%\Claude\claude_desktop_config.json2. Als het bestand leeg is, plakt u dit alles. Als er al servers in staan, voegt u alleen het blok"avenir-mcp": { … }toe binnen de bestaandemcpServers, met een komma na het vorige item.
{"mcpServers": {"avenir-mcp": {"command": "uvx","args": ["avenir-mcp"],"env": { "YNAB_API_KEY": "uw-token" }}}} - macOS:
- Sla op, sluit Claude Desktop dan helemaal af – ⌘Q op macOS, of via het pictogram in het systeemvak op Windows – en open het opnieuw.
- Klik op de knop: Cursor vraagt u om bevestiging en voegt vervolgens
avenir-mcptoe aan zijn servers. - Open Cursor Settings → MCP, vervang
uw-tokendoor het token dat u hebt gekopieerd en controleer ofavenir-mcpis ingeschakeld.
Of met de hand: maak of open ~/.cursor/mcp.json (alle projecten) of
.cursor/mcp.json in een project, en voeg toe:
{ "mcpServers": { "avenir-mcp": { "command": "uvx", "args": ["avenir-mcp"], "env": { "YNAB_API_KEY": "uw-token" } } }}- Klik op de knop: VS Code vraagt u om bevestiging, vraagt vervolgens om uw token in een wachtwoordveld en slaat dit op in zijn eigen geheime opslag.
- Gebruik het vanuit Copilot Chat in de modus Agent.
Of met de hand: maak .vscode/mcp.json aan in uw werkruimte. VS Code vraagt ook daar
om het token, zodat het nooit in het bestand wordt opgeslagen: een bestand uit een
werkruimte kan gemakkelijk per ongeluk aan een repository worden toegevoegd.
{ "inputs": [ { "type": "promptString", "id": "ynab-token", "description": "Persoonlijk YNAB-toegangstoken", "password": true } ], "servers": { "avenir-mcp": { "type": "stdio", "command": "uvx", "args": ["avenir-mcp"], "env": { "YNAB_API_KEY": "${input:ynab-token}" } } }}Voer vervolgens het commando MCP: List Servers uit, kies avenir-mcp en dan
Start Server.
- Open
~/.gemini/settings.json(maak het aan als dat nodig is) en voeg toe:{"mcpServers": {"avenir-mcp": {"command": "uvx","args": ["avenir-mcp"],"env": { "YNAB_API_KEY": "uw-token" }}}} - Start
geminien typ/mcp:avenir-mcpstaat erbij met zijn tools. Het model is dat van Gemini CLI.
- Open
~/.codex/config.toml(maak het aan als dat nodig is) en voeg toe:[mcp_servers.avenir]command = "uvx"args = ["avenir-mcp"]env = { YNAB_API_KEY = "uw-token" } - Start
codexen typ/mcp:avenir-mcpwordt samen met de bijbehorende tools weergegeven. Het model is het model dat Codex gebruikt.
Voor een model dat op uw eigen computer draait — zie Kies een model.
- Klik op de knop: LM Studio vraagt u om bevestiging en voegt vervolgens
avenir-mcptoe aan het bestandmcp.json. - Open in LM Studio het tabblad Program van de rechterzijbalk, dan Install → Edit mcp.json, en vervang
uw-tokendoor het token dat u hebt gekopieerd. - Sla op, laad een model dat toolgebruik ondersteunt en begin een chat: LM Studio vraagt het vóór elke toolaanroep.
Of handmatig: voeg dit toe aan hetzelfde mcp.json-bestand:
{ "mcpServers": { "avenir-mcp": { "command": "uvx", "args": ["avenir-mcp"], "env": { "YNAB_API_KEY": "uw-token" } } }}Elke MCP-client die servers via stdio start, werkt. Geef hem:
| Instelling | Waarde |
|---|---|
| commando | uvx |
| argumenten | avenir-mcp |
| omgeving | YNAB_API_KEY= uw token |
Om het in plaats daarvan in een container uit te voeren, bouwt u de image op basis van
het Dockerfile-bestand in de hoofdmap van de repository met het commando
docker build -t avenir-mcp .. Geef vervolgens aan de client docker als commando en
run -i --rm -e YNAB_API_KEY avenir-mcp als argumenten, zodat het token in de omgeving
wordt doorgegeven in plaats van via de opdrachtregel.
Voor clients die in plaats daarvan met een URL verbinden, zie Via HTTP draaien.
Controleren of het werkt
Section titled “Controleren of het werkt”claude mcp listavenir-mcp hoort verbonden te zijn:
avenir-mcp: uvx avenir-mcp - ✔ ConnectedStart dan claude en typ /mcp: avenir-mcp toont zijn 19 tools.
Open de lijst met MCP-servers of tools van de client: avenir-mcp hoort te draaien, met
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:
[ { "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.
Wijzigingen toestaan
Section titled “Wijzigingen toestaan”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.
Verwijder avenir-mcp en voeg het opnieuw toe met de extra variabele:
claude mcp remove avenir-mcp --scope userclaude mcp add avenir-mcp --scope user \ --env YNAB_API_KEY=uw-token \ --env AVENIR_MCP_WRITE=1 \ -- uvx avenir-mcpVoeg de variabele toe naast het token, sla op en herstart de client:
"env": { "YNAB_API_KEY": "uw-token", "AVENIR_MCP_WRITE": "1" }Voeg de variabele toe naast het token in ~/.codex/config.toml en herstart Codex:
env = { YNAB_API_KEY = "uw-token", AVENIR_MCP_WRITE = "1" }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.
Bijwerken, verwijderen, intrekken
Section titled “Bijwerken, verwijderen, intrekken”| 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 |
Verder
Section titled “Verder”- Je eerste gesprek: een begeleide rondleiding.
- Functies: alles wat avenir-mcp kan.
- Configuratie: elke omgevingsvariabele.
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