ربط مساعد الذكاء الاصطناعي الخاص بك
ربط Claude أو ChatGPT أو أي عميل MCP آخر ببوابة العميل. يمكن للمساعد قراءة مشاريعك وفواتيرك وتذاكر الدعم وحالة الموقع وملفاتك. في خطتي Pro وUltra يمكنه أيضًا فتح تذاكر أو إرسال طلبات تغيير، لكن فقط بعد تأكيدك المعاينة الدقيقة.
الأدوات والحدود
لكل خطة حدودها الخاصة. يفرض الخادم عدد المفاتيح، والطلبات في الدقيقة لكل مفتاح، والوحدات الشهرية على الحساب كله.
الأساسية (Basic)
مجانيقراءة فقط. لا كتابة في هذه الخطة
قراءة المشاريع والفواتير وتذاكر الدعم وحالة الموقع وملفات المشروع والتقرير الشهري.
المتقدمة (Pro)
3,000,000 تومان / شهريًاقراءة وكتابة مع التأكيد
كل أدوات القراءة، بالإضافة إلى الكتابة المؤكدة: فتح تذاكر الدعم والرد عليها، وإرسال طلبات التغيير ورسائل Farr، ورفع الملفات، وإنشاء مسودات المحتوى وتحديثها، وقبول الاقتراحات أو رفضها. تُعرض كل عملية كتابة معاينةً أولاً ولا تُطبَّق إلا بعد موافقتك.
ألترا (Ultra)
5,000,000 تومان / شهريًاكل ما في Pro، مع الإجراءات الجماعية والويب هوكات
كل ما في Pro، إضافةً إلى إجراءات التذاكر الجماعية (bulk_ticket_reply وbulk_ticket_close وbulk_actions، حتى 20 تذكرة في كل استدعاء)، والويب هوكات (webhook_list وwebhook_create وwebhook_delete)، والتقارير الشهرية المجدولة (scheduled_reports وscheduled_reports_get).
الأمان: لا عمليات دفع أو نقل ملكية
لا يحتوي API المساعد على أي أداة لدفع الفواتير أو نقل الأموال أو تغيير ملكية الحساب أو إنشاء أو إلغاء المفاتيح. الفواتير للقراءة فقط، وتتم عملية الدفع بنفسك عبر بوابة العملاء.
كيفية إنشاء مفتاح المساعد
أنشئ مفتاحاً في بوابة العملاء خلال ثلاث خطوات.
١. تسجيل الدخول إلى البوابة
سجل الدخول إلى بوابة العملاء وافتح قسم وصول المساعد من القائمة.
٢. إنشاء المفتاح
انقر على "إنشاء مفتاح". أدخل اسماً بين ٣ و ٦٠ حرفاً (مثلاً "Claude Code - كمبيوتر محمول")، وحدد الصلاحيات ومدة الصلاحية. يتطلب إنشاء المفتاح تأكيد الدخول.
٣. نسخ المفتاح مرة واحدة
يظهر المفتاح الكامل مرة واحدة فقط فور إنشائه. يخزن الخادم تجزئة SHA-256 للقسم السري فقط ولا يمكن إظهاره مجدداً. إذا فقدته، قم بإلغائه وأنشئ مفتاحاً جديداً.
كيفية ربط Claude و ChatGPT
اتصل عبر بروتوكول MCP بتقنية Streamable HTTP، باستخدام مفتاح حامل أو عبر تسجيل الدخول بواسطة OAuth.
Claude Code وعملاء MCP الآخرون
في أي أداة تقبل عنوان URL للخادم وترويسات، مثل ملف .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 ينتهي بعد ۱۵ دقيقة. |
الأسئلة الشائعة
أسئلة شائعة حول المساعدين والأمان وحدود الاستخدام.
هل يمكن لمساعد الذكاء الاصطناعي إجراء الدفع أو تسوية الفواتير تلقائياً؟
لا. لا يحتوي API المساعد على أداة لدفع الفواتير أو نقل الأموال. يمكن قراءة الفواتير هناك، وتقوم أنت بالدفع بنفسك عبر بوابة العملاء.
ماذا يحدث عند استهلاك حصة الوحدات الشهرية؟
لكل خطة ميزانية وحدات شهرية للحساب كله. القراءة تكلف وحدة واحدة ومعاينة الكتابة تكلف 3 وحدات. عندما يبلغ استخدام الحساب في الشهر ميزانية الخطة، ترجع الاستدعاءات اللاحقة خطأ quota_exceeded داخل نتيجة الأداة (HTTP 200، لا 429) حتى يتغير شهر UTC التقويمي.
كيف يمكنني إلغاء مفتاح المساعد إذا تعرض للاختراق؟
افتح وصول المساعد في بوابة العملاء، واختر إلغاء المفتاح وأكد ذلك. يُرفض أي طلب لاحق بهذا المفتاح فوراً. يمكن فصل المساعدين المتصلين عبر OAuth من نفس الصفحة.
هل أحتاج إلى تشغيل جسر محلي لربط ChatGPT؟
لا. نقطة النهاية هي رابط HTTPS قياسي: يرسل العميل رسائل JSON-RPC عبر POST ويستقبل ردود JSON. تتصل المساعدات السحابية مباشرة دون الحاجة لبرامج محلية.
جاهز لبدء استخدام مساعدك؟
اختر خطة للبدء، أو افتح بوابة العملاء وأنشئ مفتاح مساعد.