Personal agents
Settings → Developers → Personal Agents, buat dan kelola klien OAuth personal untuk akses MCP Entergram Anda sendiri.
Klien personal bertindak hanya atas seat Anda sendiri. Gunakan untuk agen lokal seperti Claude Desktop atau Codex, atau untuk tool terkelola seperti n8n yang aksesnya harus dibatasi pada data Anda.
Klien personal bersifat privat untuk seat Anda. Klien workspace bersama dan scope berisiko lebih tinggi ada di Klien OAuth workspace.
Membuat klien
Bagian berjudul “Membuat klien”Create client:
| Field | Catatan |
|---|---|
| Client name | Misalnya Entergram Personal Agent |
| Platform | Pilih aplikasi Anda, atau Custom |
| Token endpoint auth | none (public + PKCE), client_secret_post, atau client_secret_basic |
| Require PKCE | Wajib untuk klien publik; biarkan menyala juga untuk klien konfidensial |
| Description | Ditampilkan di layar persetujuan |
| Redirect URIs | Satu per baris. HTTPS wajib di luar localhost |
| Allowed scopes | Lihat di bawah |
Gunakan
noneuntuk klien PKCE lokal. Gunakanclient_secret_*untuk integrasi terkelola atau di sisi server yang tetap hanya bertindak atas seat Anda sendiri.
Scope yang tersedia untuk klien personal
Bagian berjudul “Scope yang tersedia untuk klien personal”Klien personal hanya bisa meminta:
- scope baca yang aman untuk seat,
- akses custom field chat sesuai pelaku (actor-scoped),
- akses offline opsional (tetap terhubung).
Anggota dibatasi lebih lanjut: “Klien milik anggota hanya bisa meminta scope baca yang aman, akses custom field chat sesuai pelaku, dan akses offline.” Admin mendapat set yang lebih luas.
Pilih minimal satu scope, atau klien tidak akan tersimpan.
Client secret
Bagian berjudul “Client secret”Klien konfidensial menerima secret yang hanya ditampilkan sekali:
One-time reveal (tampil sekali): Entergram hanya menyimpan hash dari secret ini. Setelah menutup dialog ini, Anda hanya bisa merotasinya, tidak bisa menampilkannya lagi.
Salin ke secret manager Anda sebelum menutup dialog. Jika hilang, Rotate secret menerbitkan secret baru (dan membatalkan yang lama).
Mengelola klien
Bagian berjudul “Mengelola klien”Setiap klien menampilkan Public client / Confidential client, PKCE on / PKCE off, Created, Last used, Owner, dan Active grants. Perluas untuk melihat Client details: Client ID, metode autentikasi, pratinjau secret, persyaratan PKCE, terakhir dipakai oleh, dan redirect URI.
| Tindakan | Efek |
|---|---|
| Edit | Mengubah nama, scope, redirect URI |
| Disable | ”Klien akan berhenti menerima otorisasi baru dan pembaruan token sampai Anda mengaktifkannya lagi.” |
| Enable | Mengizinkan kembali otorisasi dan pembaruan token |
| Rotate secret | Secret baru, ditampilkan sekali |
| Archive | ”Mengarsipkan akan menonaktifkan klien dan mencabut grant aktif serta refresh token Anda.” |
Status: Active, Disabled, Archived, Banned.
Aplikasi yang diotorisasi
Bagian berjudul “Aplikasi yang diotorisasi”Authorized apps, tinjau dan cabut grant OAuth MCP yang diterbitkan oleh seat Anda.
Setiap grant menampilkan kapan grant itu Granted, berapa banyak Refresh tokens yang ada, apakah PKCE diwajibkan, dan Granted scopes.
Revoke access mengakhirinya:
Mencabut grant langsung menghapus refresh token yang tersimpan untuk aplikasi itu. Klien harus menyelesaikan OAuth lagi sebelum bisa terhubung kembali.
Tampilan kosong: “Grant OAuth akan muncul di sini setelah Anda menghubungkan klien MCP lokal atau terkelola ke Entergram.”
Praktik yang baik
Bagian berjudul “Praktik yang baik”- Satu klien per tool. Mencabut Claude Desktop seharusnya tidak merusak workflow n8n Anda.
- Lewati
offline_accessuntuk apa pun yang hanya Anda pakai secara interaktif. Scope inilah yang membuat klien tetap terhubung tanpa kehadiran Anda. - Periksa Last used setiap kuartal. Klien yang tidak dipakai berbulan-bulan sebaiknya diarsipkan.
- Jangan berikan
messages.writeke agen yang masih Anda uji coba. Scope ini mengirim pesan Telegram atas nama Anda.
Terkait
Bagian berjudul “Terkait”Preferensi cookie
Kami menghormati hak privasi Anda. Pilih cookie mana yang diizinkan, pilihan Anda berlaku di seluruh situs. Kebijakan Cookie
Dibutuhkan agar situs berfungsi, termasuk mengingat pilihan privasi Anda. Selalu aktif.
Membantu kami memahami penggunaan situs dan mengaitkan pendaftaran dengan mitra referal. Opsional.