Model Context Protocol
使い慣れたAIツールから帳簿に話しかける
Beancount MCPサーバーがプレーンテキストの帳簿をClaude Code、Claude Desktop、Cursor、Windsurf、Zedなど、MCP対応のあらゆるAIクライアントに接続します。コピーペーストもエクスポートも不要。ただ尋ねるだけです。
MCPサーバーURL
https://beancount.io/api-gateway/mcp> 今日の純資産は？
⏺ runBqlQuery("SELECT sum(position) WHERE account ~ 'Assets|Liabilities'")
あなたの純資産は本日時点で128,450.32 USDです。
> 昨日の42 USDのチーム夕食を追加してコミットして
⏺ editLedgerFiles(dry_run: true) → +1 transaction
⏺ git commit a1b4f2e — "AI edit: add team dinner transaction"
完了 — 完全な監査証跡付きで帳簿にコミットしました。
ただ尋ねるだけ
「前四半期の旅行費はいくらだった？」に答えるには、かつてBQL構文の知識、適切なファイルの特定、結果をチャットにコピーする作業が必要でした。今は一文で済みます。
“今日の純資産はいくらですか？”
実際の台帳から引き出したライブの回答です。推測ではありません。
“先月の支出をまとめてください”
AI が BQL クエリを書き、結果を読み上げます。
“取引を追加して git にコミットする”
台帳リポジトリへの実際のコミットであり、他のコミットと同じように元に戻せます。
“台帳リポジトリには何がありますか？”
エディタを離れずに .beancount ファイルを参照して読むことができます。
AI ができること
サーバーは4つの台帳ツールを公開します。AI がそれらを組み合わせます。ファイル構造を発見し、コンテキストを読み取り、クエリで回答を得て、編集を提案します。
runBqlQuery
残高、取引、勘定科目に対して BQL（Beancount Query Language）クエリを実行します。
listLedgerFiles
台帳リポジトリのディレクトリ構造を閲覧します。
readLedgerFiles
.beancount ファイルやその他の台帳ドキュメントの内容を読み取ります。
editLedgerFiles
アトミックな git コミットでファイルを作成、更新、置換、または削除します。
1分以内に接続できます
AIクライアントを選んで、コピーして、貼り付けて、質問しよう。
- ターミナルでこのコマンドを実行してください。
- Claude Codeがブラウザウィンドウを開きます — ログインして接続する台帳を選んでください。
- 一度承認すると、資格情報はここから自動的に更新されます。
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcp台帳が複数ありますか？別の名前でサーバーを再度追加し、他の台帳をそれぞれのプロンプトで承認してください：
claude mcp add --transport http beancount-business https://beancount.io/api-gateway/mcpWeb Beancountアカウントをお持ちでないですか？ beancount.ioでサインアップ — 台帳はgit push一つで完了です。
あなたの台帳を守ります
あなたの帳簿への書き込みアクセスを持つAIは、約束ではなく設計によって信頼を勝ち取ります。
台帳スコープのOAuth 2.1
1つのセッションは1つの台帳に対してのみ認可されます。個人の台帳のセッションはビジネス台帳に触れることはできません。影響範囲を制限します。
すべての編集はgitコミット
変更は実際のコミット（"AI edit: …"）として台帳のリポジトリに記録されます。標準的なgitツールで確認・取り消しできる完全な監査証跡です。
ドライランによるプレビュー
editLedgerFilesはdry_runモードに対応しており、何も書き込まずに正確な変更を検証・プレビューできるため、クライアントは先に差分を表示できます。
ステートレスサーバー
MCPサーバーは、AIクライアントの会話にすでにあるもの以外は何も保存しません。台帳は現在ある場所に留まります。
あなたの台帳全体はすでにgitリポジトリです。 Git for Beancountの動作を確認する
よくある質問
MCPとは何か、Beancountにとってなぜ重要なのか？
MCP（Model Context Protocol）は、AIアシスタントが外部ツールやデータソースに構造化された安全な方法でアクセスできるようにするオープン標準です。推測したりデータを貼り付けるよう求めたりする代わりに、AIクライアントは台帳に直接接続し、実際のデータをクエリし、実際のファイルを読み取り、正確な編集を行います。
Beancount MCPサーバーと連携できるAIクライアントは？
OAuth 2.1に対応したMCP互換クライアントなら、Claude Code、Claude Desktop、Cursor、Windsurf、Zedなど、すぐにそのまま使えます。OAuth 2.1に対応していないクライアントは、beancount.ioのアカウント設定で生成した静的トークンを使って接続できます。
元帳を接続するにはどうすればいいですか？
サーバーのURLをクライアントのMCP設定に追加してください。初回使用時にクライアントがブラウザウィンドウを開きます。Web Beancountアカウントでログインし、アクセスを許可する元帳を選択します。以降、クライアントが自動で認証情報を保存・更新します。
AIは元帳で実際に何ができるのですか？
サーバーは4つのツールを提供します。runBqlQueryはBeancount Query Languageクエリを実行し、listLedgerFilesは元帳リポジトリを閲覧し、readLedgerFilesは元帳ドキュメントを読み取り、editLedgerFilesは原子的なgitコミットでファイルを作成・更新・削除します。AIはこれらを組み合わせて質問に答えたり、編集を提案したりします。
AIが私の知らないうちに元帳を変更することはありますか？
編集はeditLedgerFilesツールを通じて行われ、適切な動作をするMCPクライアントは実行前にそれを表示します。dry_runモードでは何も書き込まずに正確な変更内容をプレビューでき、コミットされた変更はすべて実際のgitコミットです。標準のgitツールで元に戻せる完全な監査証跡が残ります。
データが第三者に送信されることはありますか？
元帳データは、すでに元帳を管理しているWeb Beancountバックエンドを経由し、構造化された結果としてAIクライアントに返されます。セッションは元帳単位でスコープされ、各セッションは承認した元帳にのみアクセスできます。MCPサーバーは、AIクライアントの会話が保持する情報以外は一切保存しません。
どのように構築されているか気になりますか？ ブログでエンジニアリングFAQを読む