اتصال دستیار هوش مصنوعی به پرتال
Claude، ChatGPT یا هر کلاینت MCP دیگری را به پورتال مشتری وصل کنید. دستیار می‌تواند پروژه‌ها، فاکتورها، تیکت‌های پشتیبانی، وضعیت سایت و فایل‌های شما را بخواند. در پلن‌های پرو و اولترا، دستیار همچنین می‌تواند تیکت باز کند یا درخواست تغییر ثبت کند، اما فقط پس از تأیید دقیق پیش‌نمایش.
ابزارها و سقف‌ها
هر پلن محدودیت‌های خودش را دارد. سرور تعداد کلید، درخواست در دقیقه برای هر کلید و واحد ماهانه برای کل حساب را اعمال می‌کند.
پایه (Basic)
رایگانفقط خواندن. در این پلن نوشتن ممکن نیست
مشاهده پروژه‌ها، فاکتورها، تیکت‌های پشتیبانی، وضعیت سایت، فایل‌های پروژه و گزارش ماهانه.
حرفه‌ای (Pro)
۳٬۰۰۰٬۰۰۰ تومان / ماهخواندن و نوشتن با تأیید
همه ابزارهای خواندن، به‌همراه نوشتن با تأیید: باز کردن و پاسخ به تیکت‌های پشتیبانی، ارسال درخواست تغییر و پیام Farr، بارگذاری فایل، ساخت و به‌روزرسانی پیش‌نویس محتوا، و پذیرش یا رد پیشنهادها. هر نوشتن ابتدا پیش‌نمایش داده می‌شود و تنها پس از تأیید شما اعمال می‌شود.
اولترا (Ultra)
۵٬۰۰۰٬۰۰۰ تومان / ماههمه امکانات پرو، به‌همراه عملیات گروهی و وب‌هوک
همه امکانات پرو، به‌علاوه عملیات گروهی تیکت (bulk_ticket_reply، bulk_ticket_close و bulk_actions، حداکثر ۲۰ تیکت در هر فراخوانی)، وب‌هوک‌ها (webhook_list، webhook_create و webhook_delete) و گزارش‌های ماهانه زمان‌بندی‌شده (scheduled_reports و scheduled_reports_get).
امنیت: بدون عملیات پرداخت یا تغییر مالکیت
رابط دستیار هیچ ابزاری برای تسویه فاکتور، انتقال وجه، تغییر مالکیت حساب، ساخت یا لغو کلید ندارد. فاکتورها در آن فقط خوانده میشوند و پرداخت را خودتان در پرتال کارفرما انجام می‌دهید.
نحوه ساخت کلید دستیار در پرتال
ساخت کلید در پرتال کارفرما در سه مرحله انجام می‌شود.
۱. ورود به پرتال کارفرما
وارد پرتال کارفرما شوید و از منو، بخش «Assistant access» (دسترسی دستیار) را باز کنید.
۲. ساخت کلید
روی «ساخت کلید» بزنید. نامی بین ۳ تا ۶۰ نویسه وارد کنید (مثلاً «Claude Code - لپ‌تاپ»)، دسترسی‌های کلید و مدت اعتبار آن را انتخاب کنید. برای ساخت کلید باید دوباره وارد حساب خود شوید.
۳. یک‌بار کپی کنید
کلید کامل فقط یک بار و بلافاصله پس از ساخت نمایش داده می‌شود. سرور فقط هش SHA-256 بخش مخفی کلید را ذخیره می‌کند و امکان نمایش دوباره آن نیست. اگر کلید را گم کردید، آن را لغو کنید و کلید جدید بسازید.
راهنمای اتصال به Claude و ChatGPT
اتصال با پروتکل MCP از نوع Streamable HTTP، با کلید حامل (Bearer) یا با ورود از طریق OAuth.
Claude Code و سایر کلاینت‌های MCP
در ابزاری که آدرس سرور و هدر را میگیرد، مانند فایل .mcp.json در Claude Code، این بخش را اضافه کنید و جای نگهدارنده را با کلید خود عوض کنید:
{
"mcpServers": {
"sajjad-portal": {
"type": "http",
"url": "https://sajjad.blog/api/client/mcp",
"headers": {
"Authorization": "Bearer <YOUR_AGENT_KEY>"
}
}
}
}ChatGPT و سایر دستیارهای تحت وب
این نشانی را به‌عنوان کانکتور سفارشی اضافه کنید و وقتی درخواست شد با OAuth وارد شوید. در این روش به کلید نیازی نیست. نام گزینه‌ها در هر دستیار فرق دارد و ممکن است تغییر کند.
معنی «پیش‌نمایش، سپس تأیید» در عملیات نوشتن
هیچ تغییری در اولین فراخوانی اعمال نمی‌شود.
وقتی دستیار یک ابزار نوشتن را صدا می‌زند، سرور درخواست دقیق را ذخیره می‌کند و پیش‌نمایش را همراه یک توکن تأیید یک‌بارمصرف برمی‌گرداند که ۱۰ دقیقه معتبر است. تغییر فقط وقتی اعمال می‌شود که دستیار همان توکن را به ابزار تأیید بدهد، و دستورالعمل دستیار این است که فقط پس از موافقت شما این کار را کند. هر توکن یک بار، فقط برای همان کلید و حساب، و فقط با همان آرگومان‌ها کار می‌کند. هر نوشتنِ ثبت‌شده در سامانه نگه‌داری می‌شود.
فهرست ابزارهای معتبر دستیار
ابزارهای اصلی که نقطهی پایانی کلاینت ارائه می‌دهد، به‌علاوه ابزار تأیید که بعد از پیش‌نمایش به کار می‌رود. ابزاری که در پلن شما نیست با پیام plan_required رد می‌شود.
| نام ابزار | نوع دسترسی | کاربرد ابزار |
|---|---|---|
| projects_list | خواندن | فهرست حداکثر ۵۰ پروژه‌ی شما: کد، نام، وضعیت، درصد پیشرفت و تاریخ پایان. |
| invoices_list | خواندن | فهرست حداکثر ۲۵ فاکتور با تاریخ سررسید، مبلغ کل، پرداخت‌شده، مانده و وضعیت. با openOnly فقط فاکتورهای پرداخت‌نشده دیده میشوند. پیش‌نویس‌ها و لینک‌های پرداخت هرگز نمایش داده نمی‌شوند. |
| tickets_list | خواندن | فهرست حداکثر ۵۰ تیکت پشتیبانی با وضعیت، اولویت و زمان آخرین پاسخ. |
| ticket_get | خواندن | تاریخچه‌ی پیامهای یک تیکت (حداکثر ۱۰۰ پیام). یادداشت‌های داخلی نمایش داده نمی‌شوند. |
| ticket_create | نوشتن با تأیید | ثبت پیش‌نویس تیکت پشتیبانی جدید با اولویت کم یا عادی. فقط پس از تأیید شما اعمال می‌شود. |
| ticket_reply | نوشتن با تأیید | ثبت پیش‌نویس پاسخ به یک تیکت باز. به تیکت بسته نمی‌توان پاسخ داد. فقط پس از تأیید شما اعمال می‌شود. |
| change_request_create | نوشتن با تأیید | ثبت پیش‌نویس درخواست تغییر برای یکی از پروژه‌ها. فقط پس از تأیید شما اعمال می‌شود. |
| site_status | خواندن | وضعیت دامنه، بازدیدکننده و بازدید صفحه (۲۴ ساعت و ۷ روز)، درصد آپ‌تایم و تعداد خطاهای حل‌نشده‌ی سایت متصل. داده‌ها از آخرین همگام‌سازی تله‌متری می‌آیند و بررسی زنده نیستند. |
| files_list | خواندن | فهرست فایل‌های فضای ذخیره‌سازی پروژه‌ها، تا ۱۰۰ فایل در هر صفحه و در صورت تمایل داخل یک پوشه. |
| file_link | خواندن | ساخت لینک دانلود برای یک فایل. این لینک پس از ۱۵ دقیقه منقضی می‌شود. |
| report_monthly | خواندن | خلاصه‌ی یک ماه (تا ۱۲ ماه قبل): پروژه‌ها، تیکت‌های بازشده و بسته‌شده، وضعیت فعلی سایت، فاکتورهای سررسیددار و لینک PDF که پس از ۱۵ دقیقه منقضی می‌شود. |
پرسش‌های متداول
پاسخ به پرسش‌های رایج درباره دستیار هوش مصنوعی، امنیت و سقف مصرف.
آیا دستیار هوش مصنوعی می‌تواند به طور خودکار فاکتورها را پرداخت کند؟
خیر. رابط دستیار هیچ ابزاری برای پرداخت فاکتور یا انتقال وجه ندارد. فاکتورها در آن فقط خوانده میشوند و پرداخت را خودتان در پرتال کارفرما انجام می‌دهید.
اگر به سقف واحد ماهانه برسم چه می‌شود؟
هر پلن یک بودجه واحد ماهانه برای کل حساب دارد. یک خواندن ۱ واحد و پیش‌نمایش یک نوشتن ۳ واحد هزینه دارد. وقتی مصرف حساب در ماه به بودجه پلن برسد، فراخوانی‌های بعدی تا تغییر ماه تقویمی UTC یک خطای quota_exceeded درون نتیجه ابزار برمی‌گردانند (HTTP 200، نه 429).
اگر کلید دستیار لو برود چگونه آن را باطل کنم؟
در پرتال کارفرما به «Assistant access» بروید، روی «لغو کلید» بزنید و تأیید کنید. از آن لحظه هر درخواستی با آن کلید رد می‌شود. دستیارهایی که با OAuth وصل شده‌اند را هم از همان صفحه می‌توان قطع کرد.
آیا برای اتصال ChatGPT نیاز به راهاندازی سرور محلی دارم؟
خیر. نقطهی پایانی یک HTTPS ساده است: کلاینت پیامهای JSON-RPC را با POST میفرستد و پاسخ JSON میگیرد. دستیارهای ابری مستقیماً وصل میشوند و نرمافزار واسط لازم نیست.
آماده اتصال دستیار هوش مصنوعی خود هستید؟
یکی از پلن‌ها را انتخاب کنید یا وارد پرتال کارفرما شوید و کلید دستیار خود را بسازید.