Ga naar inhoud

Kiezen hoe avenir-mcp draait

avenir-mcp wordt geconfigureerd met omgevingsvariabelen, die worden ingesteld in het -blokenv van uw MCP-client. De volledige lijst vindt u in Configuratie].

Instelling Effect
niets (standaard) 19 leestools; de 13 schrijftools worden niet getoond en zijn niet aan te roepen
AVENIR_MCP_WRITE=1 alle 32 tools; elke schrijfactie behalve approve_transactions krijgt een voorbeeld en een bevestiging

Elke andere waarde (0, true, yes) houdt de server alleen lezend: alleen 1 schakelt schrijven in.

Je client start avenir-mcp als subproces en praat ermee via zijn standaardinvoer en -uitvoer. Er luistert niets op het netwerk. Dat doen alle voorbeelden in Installatie.

Voor een client die verbinding maakt met een URL, of om één server te delen tussen meerdere clients op uw computer. Maak eerst een lang willekeurig token aan, dat de clients moeten tonen:

Terminal window
export AVENIR_MCP_HTTP_TOKEN=$(openssl rand -hex 32)

Start dan de server:

Terminal window
AVENIR_MCP_TRANSPORT=http \
AVENIR_MCP_HOST=127.0.0.1 \
AVENIR_MCP_PORT=8103 \
YNAB_API_KEY=uw-token \
uvx avenir-mcp

Het luistert op http://127.0.0.1:8103/mcp(streamable HTTP). Richt uw client daarop met het token in een headerAuthorization — met Claude-code:

Terminal window
claude mcp add --transport http avenir-mcp http://127.0.0.1:8103/mcp \
--header "Authorization: Bearer $AVENIR_MCP_HTTP_TOKEN"

Via HTTP wordt elk verzoek gecontroleerd voordat het een tool bereikt:

Controle Geweigerd met Stops
de headerHost verwijst naar deze machine (127.0.0.1, localhost, ::1) 421 een webpagina die de server bereikt via DNS-rebinding
een headerOrigin, indien aanwezig, is die van deze server 403 een pagina van een andere site, die in uw browser wordt weergegeven
Authorization: Bearer <token>, met ofAVENIR_MCP_HTTP_TOKEN het token dat bij het opstarten wordt weergegeven 401 elk ander programma op uw computer of netwerk

Het token is altijd vereist, ongeacht of het alleen-lezen is of niet. Indien niet AVENIR_MCP_HTTP_TOKENis ingesteld, genereert de server bij het opstarten een willekeurig token en geeft dit eenmalig weer op stderr; dit verandert bij elke opstart, dus stel de variabele in om uw clients een token te geven dat geldig blijft.

Toegepaste operaties worden vastgelegd zodat ze ongedaan kunnen worden gemaakt. Standaard is het journaal $XDG_STATE_HOME/avenir-mcp/journal.jsonl, of ~/.local/state/avenir-mcp/journal.jsonl als XDG_STATE_HOME niet is ingesteld. Kies een ander bestand met AVENIR_MCP_JOURNAL. Zie Journaal en ongedaan maken.

avenir-mcp schrijft diagnoses naar stderr – nooit naar stdout, dat in stdio-modus van het protocol is – op het niveau van AVENIR_MCP_LOG_LEVEL, standaard WARNING:

Niveau Je ziet
WARNING (standaard) alleen problemen
INFO elke toolaanroep en elk YNAB-verzoek
DEBUG alles, inclusief de eigen meldingen van de MCP-bibliotheek

Een verwachte fout (een verkeerd geschreven maand, een onbekende rekening) wordt op één regel gelogd; een echte storing houdt haar traceback. Het token wordt nooit gelogd.

Voor een collector zoals Vector, Fluent Bit, Promtail of een Datadog-agent dient u JSON aan te vragen en stderr naar een bestand te schrijven dat door de collector wordt gelezen. In de configuratie van de client:

"command": "/bin/sh",
"args": ["-c", "exec uvx avenir-mcp 2>>\"$HOME/.local/state/avenir-mcp/avenir.log\""],
"env": { "YNAB_API_KEY": "uw-token", "AVENIR_MCP_LOG_FORMAT": "json", "AVENIR_MCP_LOG_LEVEL": "INFO" }

Elke regel ziet er dan zo uit:

{"time":"2026-09-25T09:12:04.120+00:00","level":"INFO","logger":"avenir_mcp.client","message":"Fetching accounts for plan demo-budget"}

Draait de server via HTTP als dienst, dan bewaart de dienstbeheerder stderr: systemd stuurt het naar het journal, launchd naar het bestand dat StandardErrorPath noemt.

INFOVanaf bevatten berichten uitsluitend identificatiecodes en aantallen — nooit begunstigden, bedragen of categorieën — zodat logbestanden uw computer kunnen verlaten zonder dat uw financiële gegevens worden meegenomen. Bewaar DEBUGdeze voor lokale probleemoplossing.

AVENIR_MCP_CONFIDENCE_THRESHOLD (standaard 0.90) is het deel van de geschiedenis van een begunstigde dat moet overeenkomen voordat een categorie wordt voorgesteld. Verlaag hem om meer suggesties te krijgen, die minder vaak kloppen. Zie Suggesties.

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