با Claude یا ChatGPT خودتان حسابداری کنید
هوش مصنوعی شخصیتان را یک بار به ترازیا وصل کنید. از آن به بعد با زبان عادی گزارش و تحلیل بخواهید، سند و فاکتور ثبت کنید، خروجی اکسل بگیرید یا همه اسناد نرمافزار قبلی را منتقل کنید. لازم نیست برنامهنویس باشید.
- قدم ۱
کلید بسازید
در تنظیمات API ترازیا، کلیدی با دسترسی MCP بسازید.
- قدم ۲
آدرس را وصل کنید
آدرس سرور و کلید را در Claude، ChatGPT یا Cursor وارد کنید.
- قدم ۳
بپرسید و بسپارید
به فارسی بنویسید چه میخواهید؛ بقیه کار با هوش مصنوعی است.
MCP (Model Context Protocol) استاندارد بازی است که دستیارهای هوش مصنوعی مثل Claude، ChatGPT و Cursor با آن به نرمافزارها وصل میشوند. بعد از اتصال، دستیار شما ابزارهای حسابداری ترازیا را خودش میشناسد و میداند هر کدام چه میکند.
https://tarazia.online/api/mcpانتقال: Streamable HTTP. احراز هویت: کلید API ترازیا در سرآیند Authorization: Bearer.
دستیار هوشمند داخل برنامه هم همچنان در دسترس است؛ MCP برای وقتی است که میخواهید با هوش مصنوعی خودتان، همراه با ابزارهای دیگرتان (ایمیل، تلگرام، فایلها) و خودکارسازیهای دلخواه کار کنید.
گرفتن کلید
- در ترازیا به تنظیمات ← فروش و فاکتور ← API و فروشگاه اینترنتی بروید (
https://tarazia.online/settings/api). - کلید جدید بزنید، نامی مثل «Claude من» بگذارید و دسترسی «اتصال هوش مصنوعی (MCP): گزارش و خواندن» را تیک بزنید. اگر میخواهید هوش مصنوعی ثبت هم بکند، «… ثبت سند و اطلاعات» را هم بزنید.
- کلید (با پیشوند
dk_) فقط یک بار نمایش داده میشود؛ کپی کنید.
کلید با مجوزهای نقش کاربری کار میکند که آن را ساخته؛ هوش مصنوعی هیچوقت بیشتر از آن کاربر نمیبیند یا انجام نمیدهد. این امکان به «API» در طرح اشتراک نیاز دارد.
اتصال
Claude Code
claude mcp add --transport http tarazia https://tarazia.online/api/mcp \ --header "Authorization: Bearer dk_xxxxxxxxxxxxxxxx"
Cursor، Windsurf، VS Code و برنامههایی که فایل تنظیم MCP دارند
{
"mcpServers": {
"tarazia": {
"url": "https://tarazia.online/api/mcp",
"headers": { "Authorization": "Bearer dk_xxxxxxxxxxxxxxxx" }
}
}
}Claude (وب و دسکتاپ)، ChatGPT و برنامههایی که فقط آدرس میگیرند
در Claude: Settings ← Connectors ← Add custom connector. در ChatGPT: Settings ← Connectors (حالت Developer). در این برنامهها جایی برای سرآیند نیست؛ کلید را در انتهای آدرس بگذارید:
https://tarazia.online/api/mcp/dk_xxxxxxxxxxxxxxxx
این آدرس خودش کلید است؛ آن را جایی منتشر نکنید. اگر لو رفت، کلید را در تنظیمات باطل و کلید تازه بسازید.
آزمایش با curl
curl https://tarazia.online/api/mcp \
-H "Authorization: Bearer dk_xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"cash_position","arguments":{}}}'ابزارها
هر ابزار توضیح و پارامترهای خودش را به هوش مصنوعی معرفی میکند؛ شما فقط درخواستتان را به زبان عادی بنویسید. مبالغ ریال و تاریخها شمسیاند. فقط ابزارهایی دیده میشوند که کلید و نقش کاربر اجازهشان را دارند.
| business_info | سالهای مالی، امروز و امکانات فعال |
| profit_and_loss | صورت سود و زیان هر دوره |
| trial_balance | تراز آزمایشی درختی تا شش سطح، چهار یا شش ستونی |
| account_ledger | گردش و مانده یک حساب معین |
| custom_report | گزارشساز: هر گزارش گروهبندیشده از اسناد، فروش یا خرید |
| expense_breakdown / monthly_trend | ریز هزینهها و روند ماهانه فروش، خرید و هزینه |
| cash_position / cheques_due | موجودی بانک و صندوق، چکهای سررسید |
| party_balance / receivables_aging | مانده اشخاص و سن مطالبات و بدهیها |
| sales_by_product / top_customers / low_stock | فروش کالاها، مشتریان برتر، کالاهای رو به اتمام |
| chart_of_accounts | کل جدول حسابها با نوع تفصیل هر معین |
| list_journal_entries / get_journal_entry | اسناد حسابداری با فیلتر و ریز ردیفها |
| list_invoices / search_invoices | فاکتورهای فروش و خرید با مانده |
| list_parties / list_products | اشخاص، کالاها، قیمت و موجودی با صفحهبندی |
| find_accounts / find_parties / find_details / list_money_accounts | جستجو برای ثبت سند |
| create_document | هزینه، درآمد، دریافت، پرداخت یا سند دستی؛ پیشنویس یا تأییدشده |
| create_sale_invoice | فاکتور فروش با مشتری و کالاها |
| create_parties / create_products | ثبت تکی یا دستهای تا ۲۰۰ شخص یا کالا |
| create_money_account / create_account | بانک و صندوق، حساب جدید در جدول حسابها |
| import_journal_entries | ورود دستهای تا ۲۰۰ سند، با کد حساب و نام تفصیل؛ برای انتقال از نرمافزار قبلی |
| post_journal_entries | تأیید اسناد پیشنویس بعد از بازبینی |
پرامپتهای آماده هم دارد: migrate_from_backup (انتقال از نرمافزار قبلی)، monthly_review (گزارش مدیریتی ماهانه) و record_from_receipt (ثبت از روی رسید). در Claude از منوی «+» و بخش ترازیا انتخابشان کنید.
انتقال از نرمافزار قبلی
خروجی اکسل یا بکاپ نرمافزار قبلیتان (هلو، سپیدار، محک، حسابفا، راهکاران یا هر نرمافزار دیگر) را به دستیارتان بدهید و پرامپت migrate_from_backup را اجرا کنید. دستیار:
- حسابهای قبلی را به جدول حسابهای ترازیا نگاشت میکند و قبل از ادامه از شما تأیید میگیرد.
- اشخاص، کالاها و بانکها را با همان کدهای قبلی ثبت میکند.
- اسناد را به ترتیب تاریخ و بهصورت پیشنویس وارد میکند. هر سند شماره عطف یکتا دارد، پس اگر کار نیمهکاره ماند، اجرای دوباره چیزی را تکراری ثبت نمیکند.
- تراز آزمایشی ترازیا را با نرمافزار قبلی مقایسه میکند و فقط با تأیید شما اسناد را قطعی میکند.
برای خروجی سالانه حسابفا، ابزار داخلی «تنظیمات ← پشتیبان و انتقال داده» هم هست که بدون هوش مصنوعی کار میکند.
امنیت و محدودیتها
- هر کلید فقط به دادههای یک کسبوکار و فقط در حد مجوزهای نقش سازندهاش دسترسی دارد. دسترسی خواندن و ثبت جدا داده میشود.
- اسناد پیشفرض پیشنویس ثبت میشوند و فقط اگر صریحاً بخواهید تأیید میشوند. قوانین تأیید، قفل دوره و سال مالی بسته مثل داخل برنامه اعمال میشوند. ابزار حذف وجود ندارد.
- همه ثبتها با نام کاربر سازنده کلید در گزارش رویدادها ثبت میشوند.
- حداکثر ۱۲۰ درخواست در دقیقه برای هر کلید و ۲۰۰ مورد در هر ثبت دستهای.
- اطلاعات شما به سرویس هوش مصنوعیای فرستاده میشود که خودتان انتخاب کردهاید؛ شرایط حریم خصوصی همان سرویس را بخوانید.