Probleemoplossing
Verbinding
Section titled “Verbinding”Mijn client toont de tools van avenir-mcp niet
- Controleer of de server verbonden is:
claude mcp list, of via het MCP-paneel van uw client. - Voer uit in
uvx avenir-mcpeen terminal. Het programma zou stil moeten wachten op een client; een foutmelding die daar wordt weergegeven, is dezelfde die door uw client wordt verborgen. - Start de client opnieuw op nadat u de configuratie ervan hebt aangepast.
- Controleer of
uvzich bevindt op de die uwPATHclient ziet. Grafische toepassingen zien mogelijk de vanPATHuw shell niet: geef het volledige pad naar op inuvxde configuratie.
De tools die mijn plan wijzigen ontbreken
avenir-mcp is alleen-lezen, tenzij de omgeving precies AVENIR_MCP_WRITE=1— bevat1.
Start de server opnieuw op nadat u dit hebt gewijzigd.
ModuleNotFoundError: avenir_mcp in een map die iCloud Drive synchroniseert
iCloud kan bestanden als verborgen markeren, en recente Python-versies slaan verborgen
.pth-bestanden over, wat bewerkbare installaties breekt. Houd de virtuele omgeving buiten
de gesynchroniseerde map: UV_PROJECT_ENVIRONMENT=~/.local/share/avenir-mcp/venv uv sync.
YNAB 401
Het token is verkeerd of is ingetrokken. Maak een nieuw aan in de Developer Settings van
YNAB en werk YNAB_API_KEY bij.
YNAB 404
Een plan, rekening, categorie of maand die YNAB niet kent. Id’s komen uit list_plans,
list_accounts, list_category_groups of get_category_balances; maanden moeten in het
plan bestaan.
YNAB 429
De 200 verzoeken per uur zijn op. Wacht een paar minuten; latere aanroepen zijn goedkoop dankzij delta-synchronisatie. Zie Gegevens en synchronisatie.
Schrijfacties
Section titled “Schrijfacties”De agent blijft confirmation_required antwoorden
Uw klant kan geen bevestigingsvenster weergeven, dus heeft avenir-mcp een voorbeeld en een code teruggestuurd. Laat de medewerker weten dat u akkoord gaat: hij belt opnieuw met de code. Een code is 10 minuten geldig en werkt één keer; vraag na een herstart van de server om een nieuw voorbeeld.
The plan changed between the preview and the answer
Er is iets veranderd aan een transactie tussen het voorbeeld en uw antwoord — door u in YNAB, een import of een andere gebruiker. Vraag het nogmaals: het nieuwe voorbeeld geeft de huidige stand van zaken weer.
Nothing to undo
Geen enkele operatie van dit plan is nog van kracht in het journaal van deze computer: ze is al ongedaan gemaakt, elders gedaan, of het journaalbestand is veranderd. Zie Journaal en ongedaan maken.
Diagnose
Section titled “Diagnose”Waar zie ik wat de server doet?
Stel in AVENIR_MCP_LOG_LEVEL=INFO(elke oproep en elk verzoek) of DEBUG(alles).
Diagnostische gegevens worden naar stderr gestuurd, die uw client in zijn MCP-logbestanden bewaart — in Claude Code
claude --debugworden deze weergegeven. stdout behoort tot het protocol.
Elke melding die een tool kan teruggeven, staat in de foutencatalogus.
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