نصب / پیشنیازها
- Beancount.io
- پشتیبانیشده، مشاهدهشده: نصب bea 0.1.0; بدون حساب برای دستورات محلی
- hledger
- پشتیبانیشده: یک باینری واحد از طریق مدیر بسته یا Docker (1.52.3)
راهنمای حسابداری عامل ۲۰۲۶
پنج ابزار. هفت معیار گردش کار. با جایی که دفترهای شما در آنجا هستند و کاری که عامل شما باید انجام دهد شروع کنید.
این ترتیب اولویت را به ایجنتهایی میدهد که تغییرات دفتر کل را پیشنویس میکنند: پیشنمایش مشاهدهشده و واردکردنهای تکرارپذیر، سپس گردشکارهای مستندشده، سپس دسترسی ابری و ابزارهای پیشفرض فقط-خواندنی. گزینه مناسب دفترهای خود را انتخاب کنید.
هستهٔ رایگان · فایلهای محلی، بدون نیاز به حساب
کتابهای محلی با متن ساده و دفتر دوطرفه با یک رابط خط فرمان ساختهشده برای عاملها: پیشنمایش قبل از اعمال، واردات تکرار-ایمن، و تنها اجرای مشاهدهشدهٔ سرتاسری در این صفحه.
سازندگان عامل که میخواهند هر تغییر دفتر کل بهصورت متن پیشنمایش و قبل از اعمال تأیید شود.
رایگان، متنباز
حسابداری محلی با متن ساده و گردش کار خشک-اجرا و واردات ایدمپوتنت مستند، که از سال ۲۰۰۷ نگهداری میشود.
کهنهکاران اسکریپتنویسی متن ساده که میخواهند دفتر دوطرفهٔ محلی بدون یک پلتفرم جدید داشته باشند.
دفتر کل ابری · نیاز به حساب توسعهدهنده و OAuth
یک سرور Remote MCP میزبانیشده و بهطور کلی در دسترس، بههمراه یک سرور محلی متنباز، CLI و SDK ایجنتی — ابزارهای خواندن و نوشتن محدودشده با مجوزهای OAuth در برابر سازمان Xero شما.
عاملهایی که در یک سازمان Xero موجود فعالیت میکنند.
دفتر کل ابری · ورود Intuit یا اپ توسعهدهنده
کانکتور میزبانیشده QuickBooks از Intuit برای Claude (آمریکا) و ChatGPT، بههمراه یک سرور MCP رسمی متنباز با CRUD کامل موجودیتها و گزارشهای مالی.
عاملهایی که در یک شرکت QuickBooks Online موجود فعالیت میکنند.
دفتر کل ابری · کانکتور MCP، پیشفرض فقط-خواندنی
دسترسی MCP فقط-خواندنی به یک شرکت Puzzle بهطور پیشفرض، با نوشتنهای تأییدشده بهعنوان یک بتای اختیاری — ابتدا پنجره پرسشوپاسخ، نه یک بکاند دفترداری.
پرسشهای گفتگویی روی یک شرکت Puzzle در Claude، ChatGPT، Cursor یا Codex.
هر ابزار بر اساس معیارهای یکسان ارزیابی میشود. «تأییدنشده» به این معناست که منابع به آن نپرداختهاند؛ نه اینکه ویژگی وجود ندارد.
| آنچه اهمیت دارد | Beancount.io | hledger | Xero | QuickBooks Online | Puzzle |
|---|---|---|---|---|---|
| نصب / پیشنیازها | پشتیبانیشده، مشاهدهشده: نصب bea 0.1.0; بدون حساب برای دستورات محلی | پشتیبانیشده: یک باینری واحد از طریق مدیر بسته یا Docker (1.52.3) | Remote MCP میزبانیشده: نیازی به نصب نیست، اپ توسعهدهنده طرح Core؛ سرور محلی و CLI: Node 18+ و اطلاعات اعتبارنامه API | کانکتور میزبانیشده: بدون نصب، اشتراک QuickBooks Online آمریکا؛ سرور محلی: کلون، بیلد، اپ توسعهدهنده Intuit | بدون نصب: حساب Puzzle، کلاینت MCP و URL کانکتور |
| احراز هویت | هیچ نیازی به صورت محلی نیست؛ اعتبارنامههای میزبانی فقط برای bea ask | هیچ نیازی نیست: فایلهای محلی، بدون حساب | Xero OAuth 2.0: PKCE برای Remote MCP و CLI، یا یک اتصال سفارشی برای سرور محلی | میزبانیشده: ورود Intuit و اعطای مجوز؛ محلی: دستدهی اپ OAuth2، محیط تولید به HTTPS عمومی نیاز دارد | OAuth Puzzle برای شرکتهای انتخابشده؛ در صورت استفاده هر ۳۰ روز یکبار وارد سیستم میماند |
| دامنهٔ خواندن / نوشتن | خواندن و نوشتن، مشاهدهشده: پرسوجو، گزارش، واردات پیشنمایش-سپس-اعمال | خواندن از طریق گزارشها؛ نوشتن با افزودن و از طریق واردات | Remote MCP: ۱۸ ابزار خواندن و ۲۱ ابزار ایجاد، بهروزرسانی، مجوزدهی و باطلکردن، محدودشده با مجوزهای OAuth | میزبانیشده: گزارشها، فاکتورها، برآوردها، مشتریان، واردکردن تراکنشها؛ محلی: CRUD و جستجوی کامل، نوشتن قابل غیرفعالسازی است | پیشفرض فقط-خواندنی؛ بتای نوشتن برای هر اتصال: دستهبندی، صورتحسابها، فاکتورها، اسناد روزنامه، تطبیق |
| دادهٔ محلی در برابر ابری | محلی: فایلهای دفتر کل متن ساده | محلی: ژورنال متن ساده | ابر: میزبانی توسط Xero یا اجرا بهصورت محلی؛ دفتر کل در سازمان Xero قرار دارد | ابر: کانکتور میزبانیشده یا زیرفرایند stdio محلی؛ دفتر کل در شرکت QBO قرار دارد | ابر: نقطه پایانی MCP میزبانیشده روی دادههای شرکت Puzzle |
| پیشنمایش / اعتبارسنجی | مشاهدهشده: پیشنمایش ۳ آماده / ۰ نوشتهشده؛ بررسی معتبر؛ نوشتن نامتوازن رد شد | مستند: خشک-اجرای واردات؛ ورودیها متوازن و اعتبارسنجیشده؛ دستور بررسی | Remote MCP V1 تأییدی نمیخواهد (Xero توصیه به افزودن آن میکند)؛ CLI ورودی فایل را اعتبارسنجی میکند؛ اجرای آزمایشی تأیید نشده | میزبانیشده: اقدامات مخرب به تأیید نیاز دارند؛ محلی: اعتبارسنجی طرحواره؛ اجرای آزمایشی تأیید نشده | با فعال بودن نوشتن، هر تغییر پیش از اعمال تأیید میشود؛ اجرای آزمایشی تأیید نشده |
| خروجی ساختاریافته | مشاهدهشده: پاکتهای JSON با ردیفها و ستونها، کدهای خروجی، BQL | گزارش به ترمینال، HTML، CSV، JSON یا SQL | حالتهای خروجی JSON، CSV و TOON | نتایج ابزار MCP بههمراه دانلود PDF فاکتور | تأیید نشده: پاسخهای گفتگویی در کلاینت MCP؛ پوشش پاکت نتیجه مشخص نیست |
| واردهای مکرر | مشاهدهشده ایمن برای تکرار: وارد مجدد ۰ مینویسد، بایتها حفظ میشوند | مستند شده وارد مجدد یکسان از طریق فایلهای وضعیت پنهان | در منابع بررسیشده تأیید نشده | در منابع بررسیشده تأیید نشده | تأیید نشده: هیچ مسیر واردکردنی مستند نشده است |
Beancount.io تنها ابزار این صفحه است که پشتوانه آن یک اجرای مشاهدهشده عامل با رویکرد پیشنمایشمحور است: عامل ۳ ردیف آماده را پیشنمایش میکند، ۳ سند را اعمال میکند و اعمال مکرر ۰ ثبت میکند در حالی که بایتهای دفتر کل حفظ میشوند. hledger نیز همین شکل جریان کاری — واردسازی آزمایشی بههمراه واردسازی مجدد خودتوان — را در راهنمای رسمی خود مستند کرده است. Xero و QuickBooks Online ابزارهای رسمی خواندن و نوشتن را در پشت تنظیمات OAuth ابری خود در اختیار عاملها قرار میدهند که برای عاملهای فعال درون یک سازمان ابری موجود مناسب است.
Beancount.io و hledger. در Beancount.io این رفتار مشاهده شد: اعمال مکرر یکسان گزارش ۰ آماده با ۳ تکراری دقیق میدهد، ۰ سند مینویسد و بایتهای دفتر کل را بدون تغییر میگذارد. hledger واردسازی خودتوان را در راهنمای خود مستند کرده و وضعیت را در یک فایل پنهان .latest نگه میدارد تا اجرای مجدد فقط تراکنشهای جدید را اضافه کند. برای Xero، QuickBooks Online و Puzzle، آنچه واردسازی مکرر انجام میدهد در منابع بررسیشده تأیید نشده است. عاملها دوباره تلاش میکنند، بنابراین این را پیش از اجازه دادن به واردسازی بدون نظارت آزمایش کنید.
خیر. دستورهای واردسازی، پرسوجو، گزارش و بررسی محلی Beancount.io روی فایلهای متنی ساده و بدون حساب اجرا میشوند؛ فقط bea ask به اعتبارنامه میزبانیشده نیاز دارد. hledger اصلاً به حساب نیاز ندارد. Xero، QuickBooks Online و Puzzle دفتر کل را در ابر نگه میدارند، بنابراین عامل ابتدا به حساب آن سرویس و یک مجوز OAuth نیاز دارد، چه از طریق یک سرور MCP میزبانیشده متصل شود چه یک ابزار محلی.
Beancount.io این صفحه را منتشر میکند و خود یکی از پنج ابزار مقایسهشده است. خانههای Beancount.io به یک اجرای مشاهدهشده و قابل بازتولید پیوند دارند؛ خانههای رقبا به مستندات رسمی بررسیشده در ۲۰۲۶-۰۹-۱۰ ارجاع میدهند، و جزئیات Xero، QuickBooks Online و Puzzle در ۲۰۲۶-۱۱-۰۱ دوباره بررسی شد. هیچ رقیبی در اینجا در زمان اجرا آزمایش نشد، هیچ حساب پرداختی استفاده نشد، و موارد نامعلوم بهجای تلقی شدن بهعنوان نقص، «تأییدنشده» برچسب خوردهاند.

bea را نصب کنید، یک وظیفه به عامل خود بدهید و نتیجه را خودتان بررسی کنید. دفترهای محلی نیازی به حساب ندارند.