Tu libro mayor entra en la conversación.

MCP (Model Context Protocol) es un estándar abierto que permite a los asistentes de IA llamar a herramientas externas y fuentes de datos de manera estructurada y segura. En lugar de adivinar o pedirte que pegues datos, tu cliente de IA se conecta directamente a tu libro: consulta tus datos reales, lee tus archivos actuales y realiza ediciones precisas.

Cualquier cliente compatible con MCP que admita OAuth 2.1 funciona sin configuración adicional, incluidos Claude Code, Claude Desktop, Cursor, Windsurf y Zed. Los clientes sin soporte para OAuth 2.1 pueden conectarse con un token estático generado en la configuración de tu cuenta de beancount.io.

Añade la URL del servidor a la configuración MCP de tu cliente. En el primer uso, el cliente abre una ventana del navegador: inicia sesión con tu cuenta de Web Beancount y elige si puede acceder a un único libro contable o a todos ellos. A partir de ahí, el cliente almacena y renueva las credenciales automáticamente.

El servidor expone familias de herramientas enfocadas: el manifiesto de descubrimiento legible por máquina en beancount.io/.well-known/ enumera el conjunto actual. Las herramientas de ledger ejecutan consultas del Lenguaje de Consulta de Beancount (runBqlQuery), exploran el repositorio (listLedgerFiles), leen documentos del ledger (readLedgerFiles) y crean, actualizan o eliminan archivos en un commit de git atómico (editLedgerFiles, con un modo de vista previa dry_run). Otras herramientas gestionan claves de API (list, mint, revoke; mint requiere un plan de pago y una concesión OAuth, no una clave de API) y conexiones e importaciones bancarias (stage, submit o descartar transacciones; un banco nuevo se vincula en el navegador, no a través de MCP). La IA las combina para responder preguntas y proponer ediciones.

Las ediciones pasan por la herramienta editLedgerFiles. Un modo dry_run previsualiza las operaciones de archivo planificadas sin comprometer nada, y si tu cliente pregunta antes de un commit real depende del cliente. Cada cambio comprometido llega como un commit de git real: un registro de auditoría completo que puedes revertir con herramientas estándar de git. La ruta de commit puede informar errores de validación después de la escritura, así que previsualiza primero y verifica el ledger después.

Los datos de tu libro mayor pasan por el backend de Web Beancount y regresan como resultados de herramientas a tu cliente de IA. El modelo de IA que elijas recibe esos resultados, por lo que también se aplican las políticas de datos de su proveedor. Cada sesión autorizada está limitada a un solo libro mayor.