Aller au contenu

Installer

Cette page vous mène de zéro à avenir-mcp qui fonctionne, en une dizaine de minutes. Chaque étape se termine par une vérification : vous savez qu’elle a marché avant de passer à la suivante.

  1. Installer uv, l’outil qui lance avenir-mcp.
  2. Obtenir un jeton YNAB, l’accès d’avenir-mcp à vos plans.
  3. Premier lancement à la main, une seule fois.
  4. Ajouter avenir-mcp à votre client.
  5. Vérifier que tout fonctionne avec une première question.
  6. Autoriser les modifications, si vous voulez que l’agent range pour vous.
Pourquoi Où l’obtenir
Un compte YNAB avenir-mcp lit et modifie vos plans app.ynab.com
Un client MCP l’application avec laquelle vous parlez ; c’est elle qui lance avenir-mcp Claude Code, Claude Desktop, Cursor, VS Code…
uv télécharge et lance avenir-mcp, et le Python dont il a besoin, dans un environnement isolé l’étape suivante

Vous n’avez pas besoin d’installer Python, de cloner le dépôt ni de créer un environnement virtuel : uv s’en charge.

Dans un terminal :

Fenêtre de terminal
curl -LsSf https://astral.sh/uv/install.sh | sh

Ou, avec Homebrew : brew install uv.

Fermez et rouvrez le terminal, puis vérifiez :

Fenêtre de terminal
uv --version

Une version s’affiche, par exemple uv 0.12.19. Commande introuvable ? L’installeur ajoute uv au PATH des nouveaux terminaux seulement : ouvrez-en un nouveau. Détails dans la documentation d’uv.

  1. Connectez-vous à YNAB dans un navigateur, sur app.ynab.com — les applications mobiles n’affichent pas les réglages développeur.
  2. Cliquez sur votre nom en haut à gauche, puis Account Settings.
  3. Ouvrez Developer Settings.
  4. Sous Personal Access Tokens, cliquez sur New Token, saisissez votre mot de passe YNAB, puis Generate.
  5. Copiez le jeton affiché en haut de la page : une longue suite de lettres, de chiffres et de tirets. YNAB ne l’affiche qu’une fois. Si vous le perdez, créez-en un autre et révoquez l’ancien.

Un seul fichier installe avenir-mcp, le Python sur lequel il tourne et les réglages dont il a besoin. Cette section ne comporte ni terminal ni fichier de configuration, et aucune de ses étapes ne diffère entre Windows, macOS et Linux, sauf là où elle le dit.

Télécharger pour Claude Desktop

Le fichier correspond toujours à la dernière version disponible ; la version qu’il installe est indiquée dans le fichier lui-même, et les étapes ci-dessous sont les mêmes quelle que soit cette version.

  1. Installez Claude Desktop, si ce n’est pas déjà fait, depuis claude.ai/download, et lancez-le une fois.

  2. Téléchargez l’extension à l’aide du bouton ci-dessus ou via ce lien. Elle pèse environ 17 ko et sera enregistrée dans votre dossier de téléchargements sous le nom avenir-mcp.mcpb.

    Sous Windows, Edge ou Chrome peuvent vous avertir que le fichier n’est pas couramment téléchargé. Cet avertissement porte sur la rareté du fichier, non sur son contenu : cliquez sur les trois points à côté du téléchargement, puis sur Keep. Ce que vous pouvez vérifier du fichier à la place est écrit dans SECURITY.md.

  3. Faites glisser le fichier vers Settings → Extensions. Ouvrez Claude Desktop, puis Settings → Extensions : cet écran répertorie les extensions dont vous disposez, et c’est là que le fichier s’installe. Sélectionnez le fichier avenir-mcp.mcpb dans votre dossier de téléchargements ou dans la liste des téléchargements de votre navigateur, puis faites-le glisser sur cet écran. La boîte de dialogue d’installation s’ouvre.

    Un double-clic sur le fichier peut également fonctionner, si votre système ouvre déjà les fichiers .mcpb avec Claude Desktop. Si, au contraire, Windows vous demande avec quelle application ouvrir le fichier, fermez cette fenêtre : les fichiers .mcpb ne sont associés à aucune application, et la recherche de claude.exe ne donne aucun résultat. Faites plutôt glisser le fichier sur l’écran Extensions.

    Aucune des deux ne fonctionne ? Sur ce même écran, ouvrez les Advanced settings puis, sous Extension Developer, cliquez sur Install Extension… ; sélectionnez le fichier dans votre dossier de téléchargements.

  4. Installez-la. La boîte de dialogue donne le nom de l’extension, avenir-mcp for YNAB, et dit ce qu’elle fait. Cliquez sur Install.

  5. Collez votre jeton dans le champ nommé YNAB personal access token, celui de l’étape précédente. Ctrl + V sous Windows et Linux, ⌘ + V sur macOS. Le champ masque ce que vous y collez ; Claude Desktop le garde là où votre système conserve les mots de passe, et il n’est écrit dans aucun fichier que vous pourriez ouvrir.

  6. Laissez la case Allow changes to your plans décochée, puis enregistrez. avenir-mcp répond aux questions et ne modifie rien tant que cette case reste décochée. Vous pourrez la cocher plus tard, au même endroit.

  7. Vérifiez qu’elle est bien là. Settings → Extensions affiche désormais avenir-mcp for YNAB, activée.

  8. Posez-lui une question. Dans une nouvelle conversation, écrivez : « Liste mes plans YNAB. » Claude vous demande d’autoriser l’outil la première fois ; autorisez-le, et la réponse donne les noms de vos plans. La toute première réponse prend quelques secondes de plus que les suivantes, le temps que Claude Desktop récupère Python et avenir-mcp.

L’installation est terminée. La suite de cette page traite des autres clients et de l’installation à la main ; continuez avec votre première conversation, ou avec autoriser les modifications si vous voulez que l’agent range pour vous.

Pour Faire
Changer le jeton, ou autoriser les modifications Settings → Extensions → avenir-mcp for YNAB
Mettre à jour téléchargez à nouveau l’extension et faites-la glisser sur l’écran Settings → Extensions, par-dessus celle qui est déjà installée ; le lien renvoie toujours vers la dernière version disponible
Retirer retirez-la depuis Settings → Extensions ; le jeton part avec elle

Avant de configurer un client, lancez avenir-mcp une fois à la main. Cela le télécharge et prouve qu’il démarre.

Fenêtre de terminal
YNAB_API_KEY=votre-jeton uvx avenir-mcp

Le premier lancement télécharge avenir-mcp et Python : de quelques secondes à une minute. Ensuite rien ne s’affiche et la commande ne rend pas la main — c’est normal : avenir-mcp attend qu’un client lui parle. Appuyez sur Ctrl+C pour l’arrêter.

Une erreur s’affiche à la place ? Voir le dépannage.

Choisissez votre client. Ces configurations sont en lecture seule : avenir-mcp répond aux questions mais ne modifie rien. Autoriser les modifications vient après. Cursor, LM Studio et VS Code permettent de l’installer en un seul clic, à partir du bouton situé en haut de leur onglet.

Dans un terminal :

Fenêtre de terminal
claude mcp add avenir-mcp --scope user \
--env YNAB_API_KEY=votre-jeton \
-- uvx avenir-mcp
Élément Sens
claude mcp add avenir-mcp enregistre un serveur MCP nommé avenir-mcp
--scope user pour tous vos projets ; sans lui, seulement pour le dossier courant
--env YNAB_API_KEY=… l’environnement avec lequel avenir-mcp démarre
-- ce qui suit est la commande qui lance le serveur
uvx avenir-mcp cette commande

Claude Code garde cela, jeton compris, dans ~/.claude.json, lisible par vous seul.

Fenêtre de terminal
claude mcp list

avenir-mcp doit être connecté :

avenir-mcp: uvx avenir-mcp - ✔ Connected

Lancez ensuite claude et tapez /mcp : avenir-mcp affiche ses 19 outils.

Demandez maintenant, dans une nouvelle conversation : « Liste mes plans YNAB. » L’agent appelle list_plans — votre client peut vous demander l’autorisation — et répond avec leurs noms. Ici, le plan de démonstration utilisé dans toute cette documentation :

list_plans
[
{
"id": "demo-budget",
"name": "Foyer de démonstration",
"first_month": "2026-06-01",
"last_month": "2026-09-01"
}
]

avenir-mcp fonctionne. Continuez avec votre première conversation, ou autorisez d’abord les modifications.

Pour que l’agent puisse classer des transactions, déplacer de l’argent entre catégories ou rapprocher des comptes, ajoutez AVENIR_MCP_WRITE=1 à l’environnement d’avenir-mcp.

Installée depuis l’extension : ouvrez Settings → Extensions → avenir-mcp for YNAB, cochez Allow changes to your plans, enregistrez, et redémarrez Claude Desktop. L’extension pose la variable pour vous, il n’y a rien à taper.

La valeur doit être exactement 1. Vérification : le client liste maintenant 32 outils au lieu de 19.

Lecture seule (défaut) Avec AVENIR_MCP_WRITE=1
Outils listés 19 32
Classer, budgéter, rapprocher, créer — prévisualisé, confirmé par vous, annulable
Si l’agent comprend mal rien ne peut changer un changement que vous avez confirmé, et que vous pouvez annuler

Chaque changement vous est montré avant d’être appliqué : voir Sécurité par conception.

Pour Faire
Mettre à jour uvx récupère les nouvelles versions de lui-même de temps en temps ; forcez-le avec uvx --refresh avenir-mcp. Pour mettre à jour l’extension Claude Desktop, il suffit de la télécharger à nouveau et de la glisser-déposer sur l’écran Settings → Extensions, par-dessus celle qui est déjà installée
Retirer claude mcp remove avenir-mcp --scope user, ou supprimez l’entrée avenir-mcp de la configuration du client. L’extension se retire depuis Settings → Extensions, jeton compris
Nettoyer le seul fichier d’avenir-mcp sur votre machine est son journal, dans ~/.local/state/avenir-mcp/
Révoquer le jeton YNAB → Account Settings → Developer Settings → Revoke à côté du jeton

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é