Aller au contenu
avenir-mcp

Dépannage

Connexion

Section intitulée « 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 plan 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

Section intitulée « 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 plan, 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 plan.

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

Section intitulée « É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 plan 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 plan 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

Section intitulée « 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.

Projet non officiel. « 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. » Nous ne sommes ni affiliés, ni associés, ni liés officiellement de quelque manière que ce soit à YNAB ou à ses filiales et sociétés affiliées. Le site officiel de YNAB se trouve à l’adresse https://www.ynab.com. Les noms YNAB et You Need A Budget, ainsi que les noms, dénominations commerciales, marques, emblèmes et images qui s’y rattachent, sont des marques déposées de YNAB. avenir-mcp est fourni tel quel, sans garantie, et n’est pas un conseil financier. Mentions légales · Confidentialité