Dépannage

Connexion

Mon client n’affiche pas les outils d’avenir-mcp

1. Vérifiez que le serveur est connecté : claude mcp list, ou le panneau MCP de votre client.
2. Lancez uvx avenir-mcp dans un terminal. Il doit attendre un client en silence ; une erreur affichée là est celle que votre client cache.
3. Redémarrez le client après avoir modifié sa configuration.
4. Vérifiez que uv est dans le PATH que voit votre client. Les applications graphiques ne voient pas toujours le PATH de votre shell : donnez le chemin complet de uvx dans la configuration.

Les outils qui modifient mon budget manquent

avenir-mcp est en lecture seule sauf si son environnement contient AVENIR_MCP_WRITE=1 — exactement 1. Redémarrez le serveur après l’avoir changé.

ModuleNotFoundError: avenir_mcp dans un dossier synchronisé par iCloud Drive

iCloud peut marquer des fichiers comme masqués, et les versions récentes de Python ignorent les fichiers .pth masqués, ce qui casse les installations éditables. Gardez l’environnement virtuel hors du dossier synchronisé : UV_PROJECT_ENVIRONMENT=~/.local/share/avenir-mcp/venv uv sync.

YNAB

YNAB 401

Le jeton est faux ou a été révoqué. Créez-en un nouveau dans les Developer Settings de YNAB et mettez à jour YNAB_API_KEY.

YNAB 404

Un budget, un compte, une catégorie ou un mois que YNAB ne connaît pas. Les identifiants viennent de list_plans, list_accounts, list_category_groups ou get_category_balances ; les mois doivent exister dans le budget.

YNAB 429

Les 200 requêtes par heure sont épuisées. Attendez quelques minutes ; les appels suivants coûtent peu grâce à la synchronisation incrémentale. Voir Données et synchronisation.

Écritures

L’agent répond sans cesse confirmation_required

Votre client ne sait pas afficher de fenêtre de confirmation : avenir-mcp a donc renvoyé un aperçu et un code. Dites à l’agent que vous êtes d’accord : il rappelle l’outil avec le code. Un code dure 10 minutes et ne sert qu’une fois ; après un redémarrage du serveur, demandez un nouvel aperçu.

The budget changed between the preview and the answer

Quelque chose a modifié une transaction entre l’aperçu et votre réponse — vous dans YNAB, un import, un autre agent. Redemandez : le nouvel aperçu reflète l’état actuel.

Nothing to undo

Aucune opération de ce budget n’est encore en vigueur dans le journal de cette machine : elle a déjà été annulée, faite ailleurs, ou le fichier du journal a changé. Voir Journal et annulation.

Diagnostics

Où voir ce que fait le serveur ?

Réglez AVENIR_MCP_LOG_LEVEL=INFO (chaque appel et requête) ou DEBUG (tout). Les diagnostics vont sur stderr, que votre client garde dans ses journaux MCP — dans Claude Code, claude --debug les affiche. stdout appartient au protocole.

Chaque message qu’un outil peut renvoyer est listé dans le catalogue des erreurs.