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 فاصله دارد.
کاری که هوش مصنوعی میتواند انجام دهد
سرور ابزارهای مشخصی برای دفتر کل و اتصالهای بانکی شما فراهم میکند — عملیات دفتر کل در زیر آمده است. هوش مصنوعی آنها را ترکیب میکند: ساختار فایلها را کشف میکند، زمینه را می‌خواند، پاسخ‌ها را جست‌وجو میکند و ویرایشی پیشنهاد میدهد.
ابزارهای دفتر کل و بانک. کلاینت شما تصمیم می‌گیرد چگونه از آنها استفاده کند.
listLedgerFiles
مرور ساختار پوشه‌های مخزن دفتر کل شما.
readLedgerFiles
خواندن محتوای فایل‌های .beancount و سایر اسناد دفتر کل شما.
updateLedgerFiles
فایلها را در یک commit اتمی git تغییر میدهد و پیشنمایش dry_run دارد؛ createLedgerFiles و deleteLedgerFiles فایلها را اضافه و حذف میکنند.
دفتر کل شما، محافظت شده
یک هوش مصنوعی با دسترسی نوشتن به دفترهای شما از طریق طراحی اعتماد ایجاد میکند، نه وعده‌ها.
OAuth 2.1 محدودشده
شما تعیین میکنید یک اتصال به چه چیزی دسترسی داشته باشد: یک دفتر، یا همهٔ آنها. فقط دفتر شخصی خود را مجاز کنید و اتصال نمی‌تواند به دفترهای کسب‌وکار شما دست بزند — شعاع تأثیر را خودتان تعیین میکنید.
پیش‌نمایش‌های آزمایشی
ابزارهای فایل (createLedgerFiles, updateLedgerFiles, deleteLedgerFiles) و appendLedgerText از حالت dry_run پشتیبانی میکنند که تغییرات دقیق را بدون نوشتن چیزی اعتبارسنجی و پیشنمایش میکند، تا کلاینت شما بتواند ابتدا یک diff به شما نشان دهد.
هر ویرایش یک کامیت git است
تغییرات به‌عنوان کامیت‌های واقعی ("AI edit: …") در مخزن دفتر کل شما ثبت می‌شوند — یک مسیر حسابرسی کامل که می‌توانید با ابزارهای استاندارد git آن را بررسی و بازگردانی کنید.
سرور بدون وضعیت
سرور MCP هیچ وضعیت جلسه‌ای بین فراخوانی‌های ابزار نگه نمی‌دارد. کلاینت و مدل انتخابی شما نتایج درخواستی را دریافت میکنند؛ قبل از اتصال، سیاستهای داده آنها را بررسی کنید.
کل دفتر کل شما از قبل یک مخزن git است.
ببینید Git for Beancount چگونه کار میکندسوالات متداول
آنچه باید قبل از اتصال بدانید.
کنجکاو هستید چگونه ساخته شده است؟
سوالات متداول فنی را در وبلاگ بخوانیددر حال بررسی سایر سرورهای MCP حسابداری هستید؟
مقایسه Beancount MCP با QuickBooks، Xero و ExpensifyMCP چیست و چرا برای 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 Query Language را اجرا میکنند (runBqlQuery)، مخزن را مرور میکنند (listLedgerFiles)، اسناد دفتر کل را میخوانند (readLedgerFiles)، دستورها را به ترتیب تاریخ اضافه میکنند (appendLedgerText) و فایلها را در یک commit اتمی git ایجاد، تغییر یا حذف میکنند (createLedgerFiles, updateLedgerFiles, deleteLedgerFiles، هر کدام با حالت پیشنمایش dry_run). ابزارهای بانکی تراکنشهای در انتظار را دریافت، وارد یا کنار میگذارند و اتصالهای مرتبط را مدیریت میکنند؛ بانک کاملاً جدید در مرورگر متصل میشود، نه از طریق MCP. کلیدهای API و تنظیمات حساب در برنامهٔ وب Beancount.io باقی میمانند. هوش مصنوعی این ابزارها را ترکیب میکند تا به پرسشها پاسخ دهد و ویرایش پیشنهاد کند.
آیا هوش مصنوعی میتواند بدون اطلاع من دفتر کل من را تغییر دهد؟
دستورهای جدید از طریق appendLedgerText و تغییرات فایل از طریق ابزارهای فایل — createLedgerFiles, updateLedgerFiles, deleteLedgerFiles — انجام می‌شوند. حالت dry_run تغییرات برنامه‌ریزی‌شده را بدون commit کردن چیزی پیشنمایش میدهد، و اینکه کلاینت شما پیش از commit واقعی بپرسد یا نه بستگی به کلاینت دارد. هر تغییر commitشده به یک commit واقعی git تبدیل میشود — یک ردپای حسابرسی کامل که می‌توانید با ابزارهای استاندارد git آن را برگردانید. مسیر commit ممکن است خطاهای اعتبارسنجی را پس از نوشتن گزارش کند، پس ابتدا پیشنمایش را ببینید و سپس دفتر کل را بررسی کنید.
آیا دادههای من به شخص ثالث ارسال میشود؟
دادههای دفتر کل شما از طریق بکاند Web Beancount عبور میکند و بهصورت نتایج ابزار به کلاینت هوش مصنوعی شما بازمیگردد. مدل هوش مصنوعی که انتخاب میکنید این نتایج را دریافت میکند، بنابراین سیاستهای داده ارائهدهنده آن نیز اعمال میشود. یک اتصال فقط به دفترهای کلری دسترسی دارد که مجاز کردهاید: یک دفتر کل، یا همه آنها.
دفتر کل‌تان را به گفتگوی بعدی بیاورید.
سرور MCP Beancount امروز برای همه کاربران Web Beancount در دسترس است. دفتر کل شما فقط یک git push فاصله دارد.