runBqlQuery
اجرای پرسوجوهای BQL (Beancount Query Language) علیه موجودی‌ها، تراکنشها و حساب‌ها.
Model Context Protocol
دفتر کل شما هم وارد گفتگو میشود.
Beancount را به ابزارهای هوش مصنوعی که از قبل استفاده میکنید متصل کنید. درباره امور مالی خود بپرسید، با فایل‌های دفتر کل کار کنید و تغییرات را در Git قابل ردیابی نگه دارید.
فقط بپرسید
با یک سوال شروع کنید. پاسخ را تا دفتر کل خود دنبال کنید.
پشتوانهٔ پاسخ
runBqlQuerySELECT sum(position) WHERE account ~ 'Assets|Liabilities'Beancount
با کلاینت سازگار با MCP شما کار میکند
- Claude Code
- Claude Desktop
- Cursor
- Windsurf
- Zed
همان کلاینتی را که استفاده میکنید، متصل کنید
کلاینت خود را انتخاب کنید، سرور را یک‌بار اضافه کنید و دفترهایی را که میتواند به آنها دسترسی داشته باشد مجاز کنید.
Claude Code
این دستور را در ترمینال خود اجرا کنید.
Claude Code را باز کنید و برای احراز هویت /mcp را اجرا کنید. وارد Web Beancount شوید و یک دفتر یا همهٔ آنها را تأیید کنید.
یک‌بار تأیید کنید. اعتبارنامه‌ها به‌طور خودکار از اینجا تازه میشوند.
ترمینال
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcpبیش از یک دفتر دارید؟ همه را یک‌بار تأیید کنید. دستیار برای دیدن آنچه میتواند به آن دسترسی داشته باشد listLedgers را فراخوانی میکند و در هر فراخوانی نام دفتر را ذکر میکند، بنابراین یک سرور همهٔ دفترها را پوشش میدهد.
از حساب Web Beancount خود برای مجاز کردن دفترهایی که سرور میتواند به آنها دسترسی داشته باشد استفاده کنید.
حساب Web Beancount ندارید؟ در beancount.io ثبتنام کنید — دفتر کل شما فقط یک git push فاصله دارد.
کاری که هوش مصنوعی میتواند انجام دهد
سرور ابزارهای متمرکزی برای دفتر کل، کلیدهای API و اتصالات بانکی شما ارائه میدهد — فعل‌های دفتر کل در زیر نشان داده شده‌اند. هوش مصنوعی آنها را ترکیب میکند: ساختار فایل خود را کشف کنید، برای زمینه بخوانید، برای پاسخ‌ها پرس‌وجو کنید، ویرایشی پیشنهاد دهید.
ابزارهای دفتر کل، کلید API و بانک. کلاینت شما تصمیم می‌گیرد چگونه از آنها استفاده کند.
listLedgerFiles
مرور ساختار پوشه‌های مخزن دفتر کل شما.
readLedgerFiles
خواندن محتوای فایل‌های .beancount و سایر اسناد دفتر کل شما.
editLedgerFiles
ایجاد، بهروزرسانی، جایگزینی یا حذف فایلها در یک commit اتمی git.
دفتر کل شما، محافظت شده
یک هوش مصنوعی با دسترسی نوشتن به دفترهای شما از طریق طراحی اعتماد ایجاد میکند، نه وعده‌ها.
OAuth 2.1 محدودشده
شما تعیین میکنید یک اتصال به چه چیزی دسترسی داشته باشد: یک دفتر، یا همهٔ آنها. فقط دفتر شخصی خود را مجاز کنید و اتصال نمی‌تواند به دفترهای کسب‌وکار شما دست بزند — شعاع تأثیر را خودتان تعیین میکنید.
پیش‌نمایش‌های آزمایشی
editLedgerFiles از حالت dry_run پشتیبانی میکند که تغییرات دقیق را بدون نوشتن چیزی اعتبارسنجی و پیشنمایش میکند، بنابراین client شما میتواند ابتدا diff را به شما نشان دهد.
هر ویرایش یک کامیت git است
تغییرات به‌عنوان کامیت‌های واقعی ("AI edit: …") در مخزن دفتر کل شما ثبت میشوند — یک مسیر حسابرسی کامل که میتوانید با ابزارهای استاندارد git آن را بررسی و بازگردانی کنید.
سرور بدون وضعیت
سرور MCP هیچ وضعیت جلسه‌ای بین فراخوانی‌های ابزار نگه نمی‌دارد. کلاینت و مدل انتخابی شما نتایج درخواستی را دریافت میکنند؛ قبل از اتصال، سیاستهای داده آنها را بررسی کنید.
کل دفتر کل شما از قبل یک مخزن 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 شما متصل شوند.
چگونه دفتر کل خود را متصل کنم؟
نشانی سرور را به پیکربندی MCP کلاینت خود اضافه کنید. در نخستین استفاده، کلاینت پنجرهٔ مرورگر را باز میکند — با حساب Web Beancount خود وارد شوید و انتخاب کنید که به یک دفتر یا همهٔ آنها دسترسی داشته باشد. کلاینت از اینجا اعتبارنامه‌ها را به‌طور خودکار ذخیره و تازه میکند.
هوش مصنوعی واقعاً با دفتر کل من چه کاری میتواند انجام دهد؟
سرور خانوادههای ابزار متمرکزی ارائه میدهد — مانیفست کشف ماشینخوان تحت beancount.io/.well-known/ مجموعه فعلی را فهرست میکند. ابزارهای دفتر کل پرسوجوهای زبان پرسوجوی Beancount را اجرا میکنند (runBqlQuery)، مخزن را مرور میکنند (listLedgerFiles)، اسناد دفتر کل را میخوانند (readLedgerFiles)، و فایلها را در یک commit اتمی git ایجاد، بهروزرسانی یا حذف میکنند (editLedgerFiles، با حالت پیشنمایش dry_run). ابزارهای بیشتر کلیدهای API را مدیریت میکنند (فهرست، ضرب، لغو — ضرب نیاز به طرح پولی و مجوز OAuth دارد، نه کلید API) و اتصالات بانکی و واردات (مرحلهبندی، ارسال یا رد تراکنشها؛ یک بانک جدید در مرورگر پیوند میشود، نه از طریق MCP). هوش مصنوعی آنها را برای پاسخ به سوالات و پیشنهاد ویرایش ترکیب میکند.
آیا هوش مصنوعی میتواند بدون اطلاع من دفتر کل من را تغییر دهد؟
ویرایشها از طریق ابزار editLedgerFiles انجام میشوند. حالت dry_run عملیات فایل برنامهریزیشده را بدون commit کردن چیزی پیشنمایش میدهد، و اینکه آیا کلاینت شما قبل از commit واقعی بپرسد بستگی به کلاینت دارد. هر تغییر commit شده به عنوان یک commit واقعی git ثبت میشود — یک مسیر حسابرسی کامل که میتوانید با ابزارهای استاندارد git آن را برگردانید. مسیر commit میتواند پس از نوشتن خطاهای اعتبارسنجی گزارش دهد، بنابراین ابتدا پیشنمایش کنید و دفتر کل را پس از آن بررسی کنید.
آیا دادههای من به شخص ثالث ارسال میشود؟
دادههای دفتر کل شما از طریق بکاند Web Beancount عبور کرده و به عنوان نتایج ابزار به کلاینت هوش مصنوعی شما بازگردانده میشوند. مدل هوش مصنوعی که انتخاب میکنید این نتایج را دریافت میکند، بنابراین سیاستهای داده ارائهدهنده آن نیز اعمال میشود. هر جلسه مجاز به یک دفتر کل محدود میشود.
دفتر کل‌تان را به گفتگوی بعدی بیاورید.
سرور MCP Beancount امروز برای همه کاربران Web Beancount در دسترس است. دفتر کل شما فقط یک git push فاصله دارد.