Model Context Protocol
Parlez à votre grand livre depuis les outils d'IA que vous utilisez déjà
Le serveur MCP Beancount connecte votre grand livre en texte brut à Claude Code, Claude Desktop, Cursor, Windsurf, Zed — tout client d'IA compatible MCP. Pas de copier-coller. Pas d'exports. Il suffit de demander.
URL du serveur MCP
https://beancount.io/api-gateway/mcp> Quel est mon patrimoine net aujourd'hui ?
⏺ runBqlQuery("SELECT sum(position) WHERE account ~ 'Assets|Liabilities'")
Votre patrimoine net aujourd'hui est de 128,450.32 USD.
> Ajoutez le dîner d'équipe d'hier à 42 USD et validez-le
⏺ editLedgerFiles(dry_run: true) → +1 transaction
⏺ git commit a1b4f2e — "AI edit: add team dinner transaction"
Terminé — validé dans votre grand livre avec une piste d'audit complète.
Il suffit de demander
Répondre à « combien ai-je dépensé en voyages le trimestre dernier ? » nécessitait de connaître la syntaxe BQL, de trouver les bons fichiers et de copier les résultats dans une conversation. Maintenant, c'est une phrase.
“Quel est mon patrimoine net aujourd'hui ?”
Une réponse en direct tirée de votre grand livre réel — pas une estimation.
“Résumez les dépenses du mois dernier”
L'IA écrit la requête BQL pour vous et lit les résultats.
“Ajoutez une transaction et validez-la dans git”
Un vrai commit dans le dépôt de votre grand livre, réversible comme n'importe quel autre.
“Qu'y a-t-il dans mon dépôt de grand livre ?”
Parcourez et lisez vos fichiers .beancount sans quitter votre éditeur.
Ce que l'IA peut faire
Le serveur expose quatre outils pour le grand livre. L'IA les compose : découvrez votre structure de fichiers, lisez pour le contexte, interrogez pour des réponses, proposez une modification.
runBqlQuery
Exécutez des requêtes BQL (Beancount Query Language) sur les soldes, les transactions et les comptes.
listLedgerFiles
Parcourez la structure de répertoires de votre dépôt de grand livre.
readLedgerFiles
Lisez le contenu de vos fichiers .beancount et d'autres documents du grand livre.
editLedgerFiles
Créez, mettez à jour, remplacez ou supprimez des fichiers dans un commit git atomique.
Connectez-vous en moins d'une minute
Choisissez votre client IA. Copiez. Collez. Demandez.
- Exécutez cette commande dans votre terminal.
- Claude Code ouvre une fenêtre de navigateur — connectez-vous et choisissez le grand livre à connecter.
- Approuvez une fois. Les identifiants se renouvellent automatiquement à partir de là.
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcpVous avez plus d'un grand livre ? Ajoutez à nouveau le serveur sous un nom différent et autorisez l'autre grand livre dans sa propre invite :
claude mcp add --transport http beancount-business https://beancount.io/api-gateway/mcpVous n'avez pas de compte Web Beancount ? Inscrivez-vous sur beancount.io — votre grand livre est à un git push près.
Votre grand livre, protégé
Une IA avec accès en écriture à vos livres gagne la confiance par la conception, pas par des promesses.
OAuth 2.1 limité au grand livre
Une session est autorisée pour exactement un grand livre. Une session pour votre grand livre personnel ne peut pas toucher votre grand livre professionnel — rayon d'explosion, limité.
Chaque modification est un commit git
Les modifications sont enregistrées sous forme de commits réels ("AI edit: …") dans le dépôt de votre grand livre — une piste d'audit complète que vous pouvez consulter et annuler avec les outils git standard.
Aperçus en mode dry-run
editLedgerFiles prend en charge un mode dry_run qui valide et prévisualise les modifications exactes sans rien écrire, afin que votre client puisse vous montrer un diff au préalable.
Serveur sans état
Le serveur MCP ne stocke rien au-delà de ce que la conversation de votre client IA contient déjà. Votre grand livre reste là où il vit aujourd'hui.
Votre grand livre est déjà un dépôt git. Découvrez comment fonctionne Git for Beancount
Foire aux questions
Qu'est-ce que MCP et pourquoi est-ce important pour Beancount ?
MCP (Model Context Protocol) est une norme ouverte qui permet aux assistants IA d'appeler des outils et des sources de données externes de manière structurée et sûre. Au lieu de deviner ou de vous demander de coller des données, votre client IA se connecte directement à votre grand livre — il interroge vos données réelles, lit vos fichiers réels et effectue des modifications précises.
Quels clients IA fonctionnent avec le serveur MCP Beancount ?
Tout client compatible MCP prenant en charge OAuth 2.1 fonctionne immédiatement, notamment Claude Code, Claude Desktop, Cursor, Windsurf et Zed. Les clients sans prise en charge d'OAuth 2.1 peuvent se connecter avec un jeton statique généré dans les paramètres de votre compte beancount.io.
Comment connecter mon grand livre ?
Ajoutez l'URL du serveur à la configuration MCP de votre client. Lors de la première utilisation, le client ouvre une fenêtre de navigateur — connectez-vous avec votre compte Web Beancount et choisissez le grand livre auquel vous souhaitez accorder l'accès. Le client stocke et actualise automatiquement les identifiants à partir de là.
Que peut réellement faire l'IA avec mon grand livre ?
Le serveur expose quatre outils : runBqlQuery exécute des requêtes Beancount Query Language, listLedgerFiles parcourt votre dépôt de grand livre, readLedgerFiles lit vos documents de grand livre et editLedgerFiles crée, met à jour ou supprime des fichiers dans un commit git atomique. L'IA les combine pour répondre aux questions et proposer des modifications.
L'IA peut-elle modifier mon grand livre à mon insu ?
Les modifications passent par l'outil editLedgerFiles, que les clients MCP bien conçus vous présentent avant de les exécuter. Un mode dry_run prévisualise les modifications exactes sans rien écrire, et chaque modification validée est un vrai commit git — une piste d'audit complète que vous pouvez annuler avec les outils git standard.
Mes données sont-elles envoyées à un tiers ?
Vos données de grand livre transitent par le backend Web Beancount, qui gère déjà votre grand livre, et reviennent sous forme de résultats structurés à votre client IA. Les sessions sont limitées au grand livre : chacune peut accéder exactement au grand livre que vous avez autorisé, et le serveur MCP ne stocke rien au-delà de ce que la conversation de votre client IA contient.
Curieux de savoir comment c'est construit ? Lisez la FAQ technique sur le blog
Vos données comptables rencontrent votre flux de travail IA
Le serveur MCP Beancount est disponible dès aujourd'hui pour tous les utilisateurs de Web Beancount. Votre grand livre est à un git push.