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بیش از یک دفتر کل دارید؟ سرور را دوباره با نام دیگری اضافه کنید و دفتر کل دیگر را در پیام خود تأیید کنید:
claude mcp add --transport http beancount-business https://beancount.io/api-gateway/mcpاز حساب 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 شما متصل شوند.
چگونه دفتر کل خود را متصل کنم؟
URL سرور را به تنظیمات MCP client خود اضافه کنید. در اولین استفاده، client یک پنجره مرورگر باز میکند — با حساب Web Beancount خود وارد شوید و دفتر کل مورد نظر خود را برای دسترسی انتخاب کنید. client از آنجا بهطور خودکار اعتبارنامهها را ذخیره و تازهسازی میکند.
هوش مصنوعی واقعاً با دفتر کل من چه کاری میتواند انجام دهد؟
سرور خانوادههای ابزار متمرکزی ارائه میدهد — مانیفست کشف ماشینخوان تحت 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 فاصله دارد.