Probleemoplossing

Verbinding

Mijn client toont de tools van avenir-mcp niet

1. Controleer dat de server verbonden is: claude mcp list, of het MCP-paneel van je client.
2. Draai uvx avenir-mcp in een terminal. Het hoort stil op een client te wachten; een fout die daar verschijnt, is de fout die je client verbergt.
3. Herstart de client na het bewerken van zijn configuratie.
4. Controleer dat uv in het PATH staat dat je client ziet. Grafische applicaties zien het PATH van je shell misschien niet: geef het volledige pad naar uvx op in de configuratie.

De tools die mijn plan wijzigen ontbreken

avenir-mcp is alleen lezend tenzij zijn omgeving AVENIR_MCP_WRITE=1 bevat – precies 1. Herstart de server nadat je het 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

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

De agent blijft confirmation_required antwoorden

Je client kan geen bevestigingsvenster tonen, dus gaf avenir-mcp een voorbeeld en een code terug. Zeg de agent dat je akkoord gaat: hij roept opnieuw aan 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 aan een transactie veranderd tussen het voorbeeld en je antwoord – jij in YNAB, een import, een andere agent. Vraag het opnieuw: het nieuwe voorbeeld laat de huidige toestand zien.

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

Waar zie ik wat de server doet?

Stel AVENIR_MCP_LOG_LEVEL=INFO in (elke aanroep en elk verzoek) of DEBUG (alles). Diagnoses gaan naar stderr, dat je client in zijn MCP-logs bewaart – in Claude Code toont claude --debug ze. stdout is van het protocol.

Elke melding die een tool kan teruggeven, staat in de foutencatalogus.