Model Context Protocol
با ابزارهای هوش مصنوعی که از قبل استفاده میکنید با دفتر کل خود صحبت کنید
سرور MCP مربوط به Beancount دفتر کل متنساده شما را به Claude Code، Claude Desktop، Cursor، Windsurf، Zed و هر کلاینت هوش مصنوعی سازگار با MCP متصل میکند. بدون کپیپیست. بدون خروجیگیری. فقط بپرسید.
URL سرور MCP
https://beancount.io/api-gateway/mcp> ارزش خالص امروز من چقدر است؟
⏺ runBqlQuery("SELECT sum(position) WHERE account ~ 'Assets|Liabilities'")
ارزش خالص شما امروز 128,450.32 USD است.
> شام تیمی دیروز به مبلغ 42 USD را اضافه کن و commit کن
⏺ editLedgerFiles(dry_run: true) → +1 transaction
⏺ git commit a1b4f2e — "AI edit: add team dinner transaction"
انجام شد — با یک مسیر حسابرسی کامل به دفتر کل شما commit شد.
فقط بپرسید
پاسخ به «در سهماهه گذشته چقدر برای سفر خرج کردم؟» قبلاً به معنای دانستن نحو BQL، پیدا کردن فایلهای مناسب و کپی کردن نتایج در چت بود. حالا فقط یک جمله است.
“ارزش خالص امروز من چقدر است؟”
پاسخی زنده که از دفتر کل واقعی شما گرفته شده — نه یک حدس.
“خلاصهای از هزینههای ماه گذشته ارائه بده”
هوش مصنوعی کوئری BQL را برای شما مینویسد و نتایج را بازخوانی میکند.
“یک تراکنش اضافه کن و به git commit کن”
یک commit واقعی در مخزن دفتر کل شما، که مانند هر commit دیگری قابل برگشت است.
“در مخزن دفتر کل من چیست؟”
فایلهای .beancount خود را بدون ترک ویرایشگر مرور و بخوانید.
کاری که هوش مصنوعی میتواند انجام دهد
سرور چهار ابزار دفتر کل را در معرض دید قرار میدهد. هوش مصنوعی آنها را ترکیب میکند: ساختار فایل خود را کشف کنید، برای زمینه بخوانید، برای پاسخها کوئری بزنید، یک ویرایش پیشنهاد دهید.
runBqlQuery
اجرای پرسوجوهای BQL (Beancount Query Language) علیه موجودیها، تراکنشها و حسابها.
listLedgerFiles
مرور ساختار پوشههای مخزن دفتر کل شما.
readLedgerFiles
خواندن محتوای فایلهای .beancount و سایر اسناد دفتر کل شما.
editLedgerFiles
ایجاد، بهروزرسانی، جایگزینی یا حذف فایلها در یک commit اتمی git.
در کمتر از یک دقیقه متصل شوید
کلاینتی که میخواهید را انتخاب کنید. کپی کنید. جایگذاری کنید. بپرسید.
- این دستور را در ترمینال خود اجرا کنید.
- 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/mcpحساب Web Beancount ندارید؟ در beancount.io ثبتنام کنید — دفتر کل شما فقط یک git push فاصله دارد.
دفتر کل شما، محافظت شده
یک هوش مصنوعی با دسترسی نوشتن به دفترهای شما از طریق طراحی اعتماد ایجاد میکند، نه وعدهها.
OAuth 2.1 محدود به دفتر کل
یک نشست فقط برای یک دفتر کل مجاز است. یک نشست برای دفتر کل شخصی شما نمیتواند به دفتر کل تجاری شما دسترسی داشته باشد — شعاع تأثیر، محدود.
هر ویرایش یک کامیت git است
تغییرات بهعنوان کامیتهای واقعی ("AI edit: …") در مخزن دفتر کل شما ثبت میشوند — یک مسیر حسابرسی کامل که میتوانید با ابزارهای استاندارد git آن را بررسی و بازگردانی کنید.
پیشنمایشهای آزمایشی
editLedgerFiles از حالت dry_run پشتیبانی میکند که تغییرات دقیق را بدون نوشتن چیزی اعتبارسنجی و پیشنمایش میکند، بنابراین client شما میتواند ابتدا diff را به شما نشان دهد.
سرور بدون وضعیت
سرور MCP چیزی فراتر از آنچه مکالمه client هوش مصنوعی شما در خود دارد ذخیره نمیکند. دفتر کل شما همانجا که امروز است باقی میماند.
کل دفتر کل شما از قبل یک مخزن git است. ببینید Git for Beancount چگونه کار میکند
سوالات متداول
MCP چیست و چرا برای Beancount مهم است؟
MCP (Model Context Protocol) یک استاندارد باز است که به دستیارهای هوش مصنوعی اجازه میدهد به ابزارها و منابع داده خارجی به روشی ساختاریافته و ایمن دسترسی پیدا کنند. به جای حدس زدن یا درخواست چسباندن دادهها، client هوش مصنوعی شما مستقیماً به دفتر کل شما متصل میشود — دادههای واقعی شما را پرسوجو میکند، فایلهای واقعی شما را میخواند و ویرایشهای دقیقی انجام میدهد.
کدام client های هوش مصنوعی با سرور MCP Beancount کار میکنند؟
هر client سازگار با MCP که از OAuth 2.1 پشتیبانی میکند، بهصورت آماده کار میکند، از جمله Claude Code، Claude Desktop، Cursor، Windsurf و Zed. client هایی که از OAuth 2.1 پشتیبانی نمیکنند میتوانند با یک توکن static تولید شده در تنظیمات حساب beancount.io شما متصل شوند.
چگونه دفتر کل خود را متصل کنم؟
URL سرور را به تنظیمات MCP client خود اضافه کنید. در اولین استفاده، client یک پنجره مرورگر باز میکند — با حساب Web Beancount خود وارد شوید و دفتر کل مورد نظر خود را برای دسترسی انتخاب کنید. client از آنجا بهطور خودکار اعتبارنامهها را ذخیره و تازهسازی میکند.
هوش مصنوعی واقعاً با دفتر کل من چه کاری میتواند انجام دهد؟
سرور چهار ابزار را ارائه میدهد: runBqlQuery پرسوجوهای Beancount Query Language را اجرا میکند، listLedgerFiles مخزن دفتر کل شما را مرور میکند، readLedgerFiles اسناد دفتر کل شما را میخواند و editLedgerFiles فایلها را در یک کامیت git اتمی ایجاد، بهروزرسانی یا حذف میکند. هوش مصنوعی آنها را برای پاسخ به سؤالات و پیشنهاد ویرایش ترکیب میکند.
آیا هوش مصنوعی میتواند بدون اطلاع من دفتر کل من را تغییر دهد؟
ویرایشها از طریق ابزار editLedgerFiles انجام میشوند که client های MCP خوشرفتار قبل از اجرا به شما نشان میدهند. حالت dry_run تغییرات دقیق را بدون نوشتن چیزی پیشنمایش میکند و هر تغییر ارتکابیافته یک کامیت git واقعی است — یک مسیر حسابرسی کامل که میتوانید با ابزارهای استاندارد git بازگردانی کنید.
آیا دادههای من به شخص ثالث ارسال میشود؟
دادههای دفتر کل شما از طریق بکاند Web Beancount که قبلاً دفتر کل شما را مدیریت میکند، جریان مییابد و بهعنوان نتایج ساختاریافته به client هوش مصنوعی شما بازگردانده میشود. جلسات محدود به دفتر کل هستند: هر کدام دقیقاً به دفتر کل که شما مجاز کردهاید دسترسی دارند و سرور MCP چیزی فراتر از آنچه مکالمه client هوش مصنوعی شما در خود دارد ذخیره نمیکند.
کنجکاو هستید چگونه ساخته شده است؟ پرسشهای متداول فنی را در وبلاگ بخوانید
دادههای حسابداری شما با جریان کار هوش مصنوعی شما ملاقات میکند
سرور MCP Beancount امروز برای همه کاربران Web Beancount در دسترس است. دفتر کل شما فقط یک git push فاصله دارد.