عامل‌های شخصی

Settings → Developers → Personal Agents، ساخت و مدیریت کلاینت‌های OAuth شخصی برای دسترسی MCP خودتان به Entergram.

یک کلاینت شخصی فقط روی صندلی خودتان عمل می‌کند. از آن برای یک عامل محلی مانند Claude Desktop یا Codex، یا برای ابزاری میزبانی‌شده مانند n8n که باید به داده‌های شما محدود بماند، استفاده کنید.

کلاینت‌های شخصی خصوصیِ صندلی شما هستند. کلاینت‌های مشترک فضای کاری و دامنه‌های پرریسک‌تر زیر کلاینت‌های OAuth فضای کاری قرار دارند.

ساختن یک کلاینت

Create client:

فیلد	توضیح
Client name	برای مثال Entergram Personal Agent
Platform	برنامه خود را انتخاب کنید یا Custom
Token endpoint auth	`none` (public + PKCE)، `client_secret_post` یا `client_secret_basic`
Require PKCE	برای کلاینت‌های عمومی اجباری است؛ برای کلاینت‌های محرمانه هم روشن نگه دارید
Description	در صفحه رضایت نمایش داده می‌شود
Redirect URIs	هر خط یکی. خارج از localhost استفاده از HTTPS الزامی است
Allowed scopes	پایین‌تر را ببینید

برای کلاینت‌های محلی PKCE از none استفاده کنید. برای یکپارچه‌سازی‌های میزبانی‌شده یا سمت سرور که همچنان فقط روی صندلی خودتان عمل می‌کنند از client_secret_* استفاده کنید.

دامنه‌های در دسترس کلاینت‌های شخصی

کلاینت‌های شخصی فقط می‌توانند این‌ها را درخواست کنند:

دامنه‌های خواندنی امن برای صندلی،
دسترسی به فیلدهای سفارشی چت محدود به کنشگر،
دسترسی آفلاین اختیاری (متصل ماندن).

اعضا محدودتر هستند: «کلاینت‌های عضو فقط می‌توانند دامنه‌های خواندنی امن، دسترسی به فیلدهای سفارشی چت محدود به کنشگر و دسترسی آفلاین را درخواست کنند.» ادمین‌ها مجموعه گسترده‌تری دریافت می‌کنند.

دست‌کم یک دامنه را انتخاب کنید وگرنه کلاینت ذخیره نمی‌شود.

راز کلاینت

کلاینت‌های محرمانه رازی دریافت می‌کنند که فقط یک‌بار نمایش داده می‌شود:

نمایش یک‌باره، Entergram فقط یک هش از این راز ذخیره می‌کند. پس از بستن این پنجره فقط می‌توانید آن را بچرخانید، نه اینکه دوباره ببینید.

پیش از بستن پنجره آن را در مدیر رازهای خود کپی کنید. اگر آن را گم کنید، Rotate secret یک راز جدید صادر می‌کند (و راز قدیمی را باطل می‌کند).

مدیریت یک کلاینت

هر کلاینت این موارد را نشان می‌دهد: Public client / Confidential client، PKCE on / PKCE off، Created، Last used، Owner و Active grants. برای دیدن Client details آن را باز کنید: شناسه کلاینت، روش احراز هویت، پیش‌نمایش راز، الزام PKCE، آخرین استفاده‌کننده و redirect URIها.

اقدام	اثر
Edit	تغییر نام، دامنه‌ها و redirect URIها
Disable	«کلاینت تا زمانی که دوباره فعالش کنید مجوز جدید و تازه‌سازی توکن دریافت نمی‌کند.»
Enable	اجازه دوباره برای مجوزدهی و تازه‌سازی
Rotate secret	راز جدید، با نمایش یک‌باره
Archive	«آرشیو کردن کلاینت را غیرفعال می‌کند و مجوزهای فعال و توکن‌های تازه‌سازی شما را باطل می‌کند.»

وضعیت‌ها: Active، Disabled، Archived، Banned.

برنامه‌های مجازشده

Authorized apps، مرور و لغو مجوزهای OAuth مربوط به MCP که صندلی شما صادر کرده است.

هر مجوز نشان می‌دهد چه زمانی Granted شده، چند Refresh token وجود دارد، آیا PKCE الزامی بوده و چه Granted scopes دارد.

Revoke access آن را از بین می‌برد:

لغو یک مجوز بلافاصله توکن‌های تازه‌سازی ذخیره‌شده آن برنامه را حذف می‌کند. کلاینت باید پیش از اتصال دوباره، فرایند OAuth را دوباره کامل کند.

حالت خالی: «مجوزهای OAuth پس از اتصال یک کلاینت MCP محلی یا میزبانی‌شده به Entergram اینجا ظاهر می‌شوند.»

رویه خوب

برای هر ابزار یک کلاینت. لغو Claude Desktop نباید جریان‌های کاری n8n شما را خراب کند.
از offline_access صرف‌نظر کنید برای هر چیزی که فقط به‌صورت تعاملی استفاده می‌کنید؛ همین است که یک کلاینت را بدون حضور شما متصل نگه می‌دارد.
هر فصل Last used را بررسی کنید. کلاینتی که ماه‌هاست استفاده نشده باید آرشیو شود.
messages.write را اعطا نکنید به عاملی که هنوز در حال آزمایش آن هستید. این دامنه به‌جای شما پیام تلگرامی می‌فرستد.