Agent cá nhân
Settings → Developers → Personal Agents, tạo và quản lý các OAuth client cá nhân cho quyền truy cập MCP Entergram của riêng bạn.
Một personal client chỉ hoạt động trên seat của chính bạn. Hãy dùng nó cho agent cục bộ như Claude Desktop hoặc Codex, hoặc cho một công cụ được lưu trữ như n8n mà bạn muốn giới hạn trong dữ liệu của mình.
Personal client là riêng tư với seat của bạn. Workspace client dùng chung và các scope rủi ro cao hơn nằm trong Workspace OAuth clients.
Tạo client
Phần tiêu đề “Tạo client”Create client:
| Trường | Ghi chú |
|---|---|
| Client name | Ví dụ Entergram Personal Agent |
| Platform | Chọn ứng dụng của bạn, hoặc Custom |
| Token endpoint auth | none (public + PKCE), client_secret_post hoặc client_secret_basic |
| Require PKCE | Bắt buộc với public client; với confidential client cũng nên giữ bật |
| Description | Hiển thị trên màn hình xin cấp quyền |
| Redirect URIs | Mỗi dòng một URI. Bắt buộc HTTPS ngoài localhost |
| Allowed scopes | Xem bên dưới |
Dùng
nonecho client PKCE cục bộ. Dùngclient_secret_*cho tích hợp được lưu trữ hoặc phía máy chủ mà vẫn chỉ hoạt động trên seat của chính bạn.
Scope dành cho personal client
Phần tiêu đề “Scope dành cho personal client”Personal client chỉ có thể yêu cầu:
- scope đọc an toàn cho seat,
- quyền truy cập trường tùy chỉnh chat giới hạn theo người thực hiện,
- offline access tùy chọn (duy trì kết nối).
Thành viên còn bị giới hạn thêm: “Member clients can request safe read scopes, actor-scoped chat custom field access, and offline access only.” (Client của thành viên chỉ có thể yêu cầu scope đọc an toàn, quyền truy cập trường tùy chỉnh chat giới hạn theo người thực hiện và offline access.) Quản trị viên có bộ scope rộng hơn.
Hãy chọn ít nhất một scope, nếu không client sẽ không lưu được.
Client secret
Phần tiêu đề “Client secret”Confidential client nhận một secret chỉ hiển thị một lần:
One-time reveal (hiển thị một lần): Entergram chỉ lưu hash của secret này. Sau khi đóng hộp thoại, bạn chỉ có thể xoay vòng secret, không thể xem lại.
Hãy sao chép secret vào trình quản lý secret trước khi đóng. Nếu bạn làm mất, Rotate secret sẽ cấp một secret mới (và vô hiệu hóa secret cũ).
Quản lý client
Phần tiêu đề “Quản lý client”Mỗi client hiển thị Public client / Confidential client, PKCE on / PKCE off, Created, Last used, Owner và Active grants. Mở rộng để xem Client details: Client ID, phương thức xác thực, bản xem trước secret, yêu cầu PKCE, người dùng gần nhất, redirect URI.
| Thao tác | Tác dụng |
|---|---|
| Edit | Đổi tên, scope, redirect URI |
| Disable | ”The client will stop receiving new authorizations and token refreshes until you enable it again.” (Client sẽ ngừng nhận ủy quyền mới và làm mới token cho đến khi bạn bật lại.) |
| Enable | Cho phép lại việc ủy quyền và làm mới token |
| Rotate secret | Secret mới, chỉ hiển thị một lần |
| Archive | ”Archiving disables the client and revokes your active grants and refresh tokens.” (Lưu trữ sẽ vô hiệu hóa client và thu hồi các grant cùng refresh token đang hoạt động của bạn.) |
Trạng thái: Active, Disabled, Archived, Banned.
Ứng dụng đã được cấp quyền
Phần tiêu đề “Ứng dụng đã được cấp quyền”Authorized apps, xem lại và thu hồi các grant MCP OAuth do seat của bạn cấp.
Mỗi grant cho biết thời điểm được cấp (Granted), số Refresh tokens hiện có, PKCE (PKCE) có được yêu cầu hay không, và các Granted scopes (scope đã cấp).
Revoke access sẽ chấm dứt grant đó:
Thu hồi một grant sẽ xóa ngay các refresh token đã lưu của ứng dụng đó. Client sẽ phải hoàn tất OAuth lại trước khi có thể kết nối lại.
Trạng thái trống: “OAuth grants will appear here after you connect a local or hosted MCP client to Entergram.” (Các grant OAuth sẽ xuất hiện ở đây sau khi bạn kết nối một MCP client cục bộ hoặc được lưu trữ với Entergram.)
Thực hành tốt
Phần tiêu đề “Thực hành tốt”- Mỗi công cụ một client. Thu hồi Claude Desktop không nên làm hỏng các workflow n8n của bạn.
- Bỏ qua
offline_accessvới những gì bạn chỉ dùng tương tác, vì chính scope này giữ cho client kết nối khi bạn không có mặt. - Kiểm tra Last used mỗi quý. Client nào không được dùng trong nhiều tháng thì nên được lưu trữ (archive).
- Đừng cấp
messages.writecho một agent bạn vẫn đang thử nghiệm. Nó gửi tin nhắn Telegram dưới danh nghĩa bạn.
Liên quan
Phần tiêu đề “Liên quan”Tùy chọn cookie
Chúng tôi tôn trọng quyền riêng tư của bạn. Hãy chọn cookie muốn cho phép, lựa chọn của bạn áp dụng cho toàn bộ trang web. Chính sách cookie
Cần thiết để trang web hoạt động, gồm cả việc ghi nhớ lựa chọn riêng tư của bạn. Luôn bật.
Giúp chúng tôi hiểu cách trang web được sử dụng và ghi nhận lượt đăng ký cho đối tác giới thiệu. Tùy chọn.