اتصال هوش مصنوعی · MCP

با Claude یا ChatGPT خودتان حسابداری کنید

هوش مصنوعی شخصی‌تان را یک بار به ترازیا وصل کنید. از آن به بعد با زبان عادی گزارش و تحلیل بخواهید، سند و فاکتور ثبت کنید، خروجی اکسل بگیرید یا همه اسناد نرم‌افزار قبلی را منتقل کنید. لازم نیست برنامه‌نویس باشید.

  1. قدم ۱

    کلید بسازید

    در تنظیمات API ترازیا، کلیدی با دسترسی MCP بسازید.

  2. قدم ۲

    آدرس را وصل کنید

    آدرس سرور و کلید را در Claude، ChatGPT یا Cursor وارد کنید.

  3. قدم ۳

    بپرسید و بسپارید

    به فارسی بنویسید چه می‌خواهید؛ بقیه کار با هوش مصنوعی است.

MCP (Model Context Protocol) استاندارد بازی است که دستیارهای هوش مصنوعی مثل Claude، ChatGPT و Cursor با آن به نرم‌افزارها وصل می‌شوند. بعد از اتصال، دستیار شما ابزارهای حسابداری ترازیا را خودش می‌شناسد و می‌داند هر کدام چه می‌کند.

آدرس سرور
https://tarazia.online/api/mcp

انتقال: Streamable HTTP. احراز هویت: کلید API ترازیا در سرآیند Authorization: Bearer.

گزارش و تحلیل
«سود خالص این فصل را با فصل قبل مقایسه کن و بگو کدام هزینه‌ها بیشتر شده‌اند.»
خروجی
«از مشتری‌هایی که بیش از ۶۰ روز بدهکارند یک فهرست اکسل بساز.»
ثبت سند
«این عکس قبض برق را از بانک ملت به‌عنوان هزینه ثبت کن.»
انتقال از نرم‌افزار قبلی
«این فایل اکسل خروجی هلو را بخوان و همه اشخاص و اسناد سال ۱۴۰۳ را به ترازیا منتقل کن.»

دستیار هوشمند داخل برنامه هم همچنان در دسترس است؛ MCP برای وقتی است که می‌خواهید با هوش مصنوعی خودتان، همراه با ابزارهای دیگرتان (ایمیل، تلگرام، فایل‌ها) و خودکارسازی‌های دلخواه کار کنید.

گرفتن کلید

  1. در ترازیا به تنظیمات ← فروش و فاکتور ← API و فروشگاه اینترنتی بروید (https://tarazia.online/settings/api).
  2. کلید جدید بزنید، نامی مثل «Claude من» بگذارید و دسترسی «اتصال هوش مصنوعی (MCP): گزارش و خواندن» را تیک بزنید. اگر می‌خواهید هوش مصنوعی ثبت هم بکند، «… ثبت سند و اطلاعات» را هم بزنید.
  3. کلید (با پیشوند 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":{}}}'

ابزارها

هر ابزار توضیح و پارامترهای خودش را به هوش مصنوعی معرفی می‌کند؛ شما فقط درخواستتان را به زبان عادی بنویسید. مبالغ ریال و تاریخ‌ها شمسی‌اند. فقط ابزارهایی دیده می‌شوند که کلید و نقش کاربر اجازه‌شان را دارند.

گزارش و تحلیلmcp:read
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فروش کالاها، مشتریان برتر، کالاهای رو به اتمام
خواندن داده‌ها و خروجیmcp:read
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جستجو برای ثبت سند
ثبت و انتقال اطلاعاتmcp:write
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 را اجرا کنید. دستیار:

  1. حساب‌های قبلی را به جدول حساب‌های ترازیا نگاشت می‌کند و قبل از ادامه از شما تأیید می‌گیرد.
  2. اشخاص، کالاها و بانک‌ها را با همان کدهای قبلی ثبت می‌کند.
  3. اسناد را به ترتیب تاریخ و به‌صورت پیش‌نویس وارد می‌کند. هر سند شماره عطف یکتا دارد، پس اگر کار نیمه‌کاره ماند، اجرای دوباره چیزی را تکراری ثبت نمی‌کند.
  4. تراز آزمایشی ترازیا را با نرم‌افزار قبلی مقایسه می‌کند و فقط با تأیید شما اسناد را قطعی می‌کند.

برای خروجی سالانه حسابفا، ابزار داخلی «تنظیمات ← پشتیبان و انتقال داده» هم هست که بدون هوش مصنوعی کار می‌کند.

امنیت و محدودیت‌ها

  • هر کلید فقط به داده‌های یک کسب‌وکار و فقط در حد مجوزهای نقش سازنده‌اش دسترسی دارد. دسترسی خواندن و ثبت جدا داده می‌شود.
  • اسناد پیش‌فرض پیش‌نویس ثبت می‌شوند و فقط اگر صریحاً بخواهید تأیید می‌شوند. قوانین تأیید، قفل دوره و سال مالی بسته مثل داخل برنامه اعمال می‌شوند. ابزار حذف وجود ندارد.
  • همه ثبت‌ها با نام کاربر سازنده کلید در گزارش رویدادها ثبت می‌شوند.
  • حداکثر ۱۲۰ درخواست در دقیقه برای هر کلید و ۲۰۰ مورد در هر ثبت دسته‌ای.
  • اطلاعات شما به سرویس هوش مصنوعی‌ای فرستاده می‌شود که خودتان انتخاب کرده‌اید؛ شرایط حریم خصوصی همان سرویس را بخوانید.