عامل‌های شخصی
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_*استفاده کنید.
دامنه‌های در دسترس کلاینت‌های شخصی
بخش با عنوان «دامنه‌های در دسترس کلاینت‌های شخصی»کلاینت‌های شخصی فقط می‌توانند این‌ها را درخواست کنند:
- دامنه‌های خواندنی امن برای صندلی،
- دسترسی به فیلدهای سفارشی چت محدود به کنشگر،
- دسترسی آفلاین اختیاری (متصل ماندن).
اعضا محدودتر هستند: «کلاینت‌های عضو فقط می‌توانند دامنه‌های خواندنی امن، دسترسی به فیلدهای سفارشی چت محدود به کنشگر و دسترسی آفلاین را درخواست کنند.» ادمین‌ها مجموعه گسترده‌تری دریافت می‌کنند.
دست‌کم یک دامنه را انتخاب کنید وگرنه کلاینت ذخیره نمی‌شود.
راز کلاینت
بخش با عنوان «راز کلاینت»کلاینت‌های محرمانه رازی دریافت می‌کنند که فقط یک‌بار نمایش داده می‌شود:
One-time reveal، 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را اعطا نکنید به عاملی که هنوز در حال آزمایش آن هستید. این دامنه به‌جای شما پیام تلگرامی می‌فرستد.
مرتبط
بخش با عنوان «مرتبط»تنظیمات کوکی
ما به حریم خصوصی شما احترام میگذاریم. انتخاب کنید کدام کوکیها مجاز باشند, انتخاب شما در کل سایت اعمال می‌شود. سیاست کوکی
برای کارکرد سایت لازم است، از جمله بهخاطر سپردن تنظیمات حریم خصوصی شما. همیشه فعال.
به ما کمک می‌کند استفاده از سایت را درک کنیم و ثبتنامها را به شرکای ارجاع نسبت دهیم. اختیاری.