Model Context Protocol
Habla con tu libro mayor desde las herramientas de IA que ya usas
El servidor MCP de Beancount conecta tu libro mayor de texto plano con Claude Code, Claude Desktop, Cursor, Windsurf, Zed — cualquier cliente de IA compatible con MCP. Sin copiar y pegar. Sin exportaciones. Solo pregunta.
URL del servidor MCP
https://beancount.io/api-gateway/mcp> ¿Cuál es mi patrimonio neto hoy?
⏺ runBqlQuery("SELECT sum(position) WHERE account ~ 'Assets|Liabilities'")
Tu patrimonio neto hoy es 128,450.32 USD.
> Agrega la cena de equipo de ayer por 42 USD y confírmala
⏺ editLedgerFiles(dry_run: true) → +1 transaction
⏺ git commit a1b4f2e — "AI edit: add team dinner transaction"
Listo — confirmado en tu libro mayor con un registro de auditoría completo.
Solo pregunta
Responder "¿cuánto gasté en viajes el último trimestre?" solía significar saber la sintaxis de BQL, encontrar los archivos correctos y copiar los resultados en un chat. Ahora es una frase.
“¿Cuál es mi patrimonio neto hoy?”
Una respuesta en vivo extraída de tu libro de contabilidad real, no una suposición.
“Resume los gastos del último mes”
La IA escribe la consulta BQL por ti y lee los resultados.
“Añade una transacción y haz commit en git”
Un commit real en el repositorio de tu libro de contabilidad, reversible como cualquier otro.
“¿Qué hay en mi repositorio del libro?”
Navega y lee tus archivos .beancount sin salir de tu editor.
Lo que la IA puede hacer
El servidor expone cuatro herramientas de contabilidad. La IA las compone: descubre tu estructura de archivos, lee para contexto, consulta para respuestas, propón una edición.
runBqlQuery
Ejecuta consultas BQL (Beancount Query Language) contra saldos, transacciones y cuentas.
listLedgerFiles
Explora la estructura de directorios de tu repositorio de contabilidad.
readLedgerFiles
Lee el contenido de tus archivos .beancount y otros documentos de contabilidad.
editLedgerFiles
Crea, actualiza, reemplaza o elimina archivos en un commit atómico de git.
Conéctate en menos de un minuto
Elige tu cliente de IA. Copia. Pega. Pregunta.
- Ejecuta este comando en tu terminal.
- Claude Code abrirá una ventana del navegador: inicia sesión y elige qué libro de contabilidad conectar.
- Aprueba una vez. Las credenciales se actualizan automáticamente desde aquí.
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcp¿Tienes más de un libro de contabilidad? Añade el servidor de nuevo con un nombre diferente y autoriza el otro libro en su propio mensaje:
claude mcp add --transport http beancount-business https://beancount.io/api-gateway/mcp¿No tienes una cuenta de Web Beancount? Regístrate en beancount.io — tu libro de contabilidad está a un git push de distancia.
Tu libro de contabilidad, protegido
Una IA con acceso de escritura a tus libros genera confianza mediante el diseño, no con promesas.
OAuth 2.1 con alcance por libro
Una sesión está autorizada para exactamente un libro. Una sesión para tu libro personal no puede tocar tu libro de negocios: radio de alcance limitado.
Cada edición es un commit de git
Los cambios se registran como commits reales ("AI edit: …") en el repositorio de tu libro: un registro de auditoría completo que puedes revisar y revertir con herramientas estándar de git.
Vistas previas de simulación
editLedgerFiles admite un modo dry_run que valida y previsualiza los cambios exactos sin escribir nada, para que tu cliente pueda mostrarte un diff primero.
Servidor sin estado
El servidor MCP no almacena nada más allá de lo que ya contiene la conversación de tu cliente de IA. Tu libro permanece donde vive hoy.
Todo tu libro ya es un repositorio de git. Mira cómo funciona Git for Beancount
Preguntas frecuentes
¿Qué es MCP y por qué es importante para Beancount?
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.
¿Qué clientes de IA funcionan con el servidor MCP de Beancount?
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.
¿Cómo conecto mi libro de contabilidad?
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 el libro al que quieres conceder acceso. El cliente almacena y renueva las credenciales automáticamente a partir de entonces.
¿Qué puede hacer realmente la IA con mi libro de contabilidad?
El servidor expone cuatro herramientas: runBqlQuery ejecuta consultas en Beancount Query Language, listLedgerFiles navega por tu repositorio de libro mayor, readLedgerFiles lee tus documentos del libro mayor y editLedgerFiles crea, actualiza o elimina archivos en un commit atómico de git. La IA las combina para responder preguntas y proponer ediciones.
¿Puede la IA modificar mi libro de contabilidad sin que yo lo sepa?
Las ediciones se realizan a través de la herramienta editLedgerFiles, que los clientes MCP bien comportados te muestran antes de ejecutarlas. Un modo dry_run previsualiza los cambios exactos sin escribir nada, y cada cambio confirmado es un commit real de git: un registro de auditoría completo que puedes revertir con herramientas estándar de git.
¿Se envían mis datos a un tercero?
Los datos de tu libro de contabilidad fluyen a través del backend de Web Beancount, que ya gestiona tu libro, y regresan como resultados estructurados a tu cliente de IA. Las sesiones están limitadas al libro: cada una puede acceder exactamente al libro que autorizaste, y el servidor MCP no almacena nada más allá de lo que contiene la conversación de tu cliente de IA.
¿Curioso sobre cómo está construido? Lee las preguntas frecuentes de ingeniería en el blog
Tus datos contables se encuentran con tu flujo de trabajo de IA
El servidor MCP de Beancount está disponible hoy para todos los usuarios de Web Beancount. Tu libro de contabilidad está a un git push de distancia.