Votre grand livre entre dans la conversation.

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.

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.

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à.

Le serveur expose des familles d’outils ciblées — le manifeste de découverte lisible par machine sous beancount.io/.well-known/ liste l’ensemble actuel. Les outils de registre exécutent des requêtes Beancount Query Language (runBqlQuery), parcourent le dépôt (listLedgerFiles), lisent les documents du registre (readLedgerFiles) et créent, mettent à jour ou suppriment des fichiers dans un commit git atomique (editLedgerFiles, avec un mode de prévisualisation dry_run). D’autres outils gèrent les clés API (lister, créer, révoquer — la création nécessite un plan payant et une autorisation OAuth, pas une clé API) ainsi que les connexions et importations bancaires (mettre en attente, soumettre ou rejeter des transactions ; une nouvelle banque est liée dans le navigateur, pas via MCP). L’IA les combine pour répondre aux questions et proposer des modifications.

Les modifications passent par l’outil editLedgerFiles. Un mode dry_run prévisualise les opérations de fichiers planifiées sans rien valider, et la décision de demander confirmation avant un vrai commit dépend du client. Chaque changement validé se traduit par un véritable commit git — une piste d’audit complète que vous pouvez annuler avec les outils git standard. Le chemin de commit peut signaler des erreurs de validation après l’écriture, alors prévisualisez d’abord et vérifiez le registre ensuite.

Les données de votre grand livre transitent par le backend Web Beancount et reviennent comme résultats d'outils à votre client IA. Le modèle d'IA que vous choisissez reçoit ces résultats, donc les politiques de données de son fournisseur s'appliquent également. Chaque session autorisée est limitée à un grand livre.