الوكلاء الشخصيون

Settings → Developers → Personal Agents، أنشئ عملاء OAuth شخصيين وأدرهم للوصول إلى Entergram MCP الخاص بك.

يعمل العميل الشخصي على مقعدك أنت فقط. استخدم واحدًا مع وكيل محلي مثل Claude Desktop أو Codex، أو مع أداة مستضافة مثل n8n يُفترض أن تقتصر على بياناتك.

العملاء الشخصيون خاصون بمقعدك. أما عملاء مساحة العمل المشتركون والصلاحيات الأعلى خطورة فتجدهم في عملاء OAuth لمساحة العمل.

إنشاء عميل

Create client:

الحقل	ملاحظات
Client name	مثل Entergram Personal Agent
Platform	اختر تطبيقك، أو Custom
Token endpoint auth	`none` (عام + PKCE)، أو `client_secret_post`، أو `client_secret_basic`
Require PKCE	إلزامي للعملاء العامين؛ وأبقِه مفعّلًا للسريين أيضًا
Description	تظهر في شاشة الموافقة
Redirect URIs	واحد في كل سطر. HTTPS مطلوب خارج localhost
Allowed scopes	انظر أدناه

استخدم none لعملاء PKCE المحليين. واستخدم client_secret_* للتكاملات المستضافة أو العاملة على الخادم والتي تظل تعمل على مقعدك وحده.

الصلاحيات المتاحة للعملاء الشخصيين

لا يستطيع العملاء الشخصيون طلب سوى:

صلاحيات قراءة آمنة على مستوى المقعد،
وصول إلى الحقول المخصصة للمحادثات محصور بالفاعل،
ووصول دون اتصال اختياري (البقاء متصلًا).

والأعضاء مقيّدون أكثر: “يستطيع عملاء الأعضاء طلب صلاحيات القراءة الآمنة، والوصول إلى الحقول المخصصة للمحادثات المحصور بالفاعل، والوصول دون اتصال فقط.” أما المشرفون فلديهم مجموعة أوسع.

اختر صلاحية واحدة على الأقل وإلا لن يُحفظ العميل.

سر العميل

يحصل العملاء السريون على سر يُعرض مرة واحدة فقط:

كشف لمرة واحدة، لا تخزّن Entergram سوى تجزئة لهذا السر. وبعد إغلاق هذه النافذة، لن تتمكن إلا من تدويره، لا من كشفه مجددًا.

انسخه إلى مدير الأسرار لديك قبل الإغلاق. وإن فقدته، فإن Rotate secret تُصدر سرًا جديدًا (وتُبطل القديم).

إدارة عميل

يعرض كل عميل Public client / Confidential client، وPKCE on / PKCE off، وCreated، وLast used، وOwner، وActive grants. ووسّع العرض لرؤية Client details: معرّف العميل، وطريقة المصادقة، ومعاينة السر، واشتراط PKCE، وآخر من استخدمه، وعناوين إعادة التوجيه.

الإجراء	الأثر
Edit	تغيير الاسم والصلاحيات وعناوين إعادة التوجيه
Disable	”سيتوقف العميل عن تلقي أذونات جديدة وتحديث الرموز حتى تعيد تفعيله.”
Enable	إعادة السماح بالتفويض والتحديث
Rotate secret	سر جديد، يُعرض مرة واحدة
Archive	”الأرشفة تعطّل العميل وتلغي منحك النشطة ورموز التحديث.”

الحالات: Active، وDisabled، وArchived، وBanned.

التطبيقات المصرّح لها

Authorized apps، راجع منح MCP OAuth الصادرة عن مقعدك وألغِها.

تعرض كل منحة وقت Granted، وعدد Refresh tokens الموجودة، وما إذا كان PKCE مطلوبًا، وGranted scopes.

وRevoke access تنهيها:

إلغاء المنحة يزيل فورًا رموز التحديث المخزّنة لذلك التطبيق. وسيحتاج العميل إلى إتمام OAuth من جديد قبل أن يتمكن من إعادة الاتصال.

الحالة الفارغة: “ستظهر منح OAuth هنا بعد ربط عميل MCP محلي أو مستضاف بـ Entergram.”

ممارسات جيدة

عميل واحد لكل أداة. فإلغاء Claude Desktop يجب ألا يعطّل تدفقات n8n لديك.
تجاوز offline_access لأي شيء تستخدمه تفاعليًا فقط، فهو ما يُبقي العميل متصلًا في غيابك.
تحقق من Last used كل ثلاثة أشهر. فأي عميل لم يُستخدم منذ أشهر ينبغي أرشفته.
لا تمنح messages.write لوكيل ما زلت تجرّبه. فهو يرسل رسائل Telegram باسمك.