Agenti personali
Settings → Developers → Personal Agents: crea e gestisci client OAuth personali per il tuo accesso MCP a Entergram.
Un client personale agisce solo sulla tua postazione. Usalo per un agente locale come Claude Desktop o Codex, oppure per uno strumento ospitato come n8n che deve restare limitato ai tuoi dati.
I client personali sono privati e legati alla tua postazione. I client condivisi dello spazio di lavoro e gli scope più rischiosi si trovano in Client OAuth dello spazio di lavoro.
Creare un client
Sezione intitolata “Creare un client”Create client:
| Campo | Note |
|---|---|
| Client name | Ad esempio Entergram Personal Agent |
| Platform | Scegli la tua app, oppure Custom |
| Token endpoint auth | none (pubblico + PKCE), client_secret_post oppure client_secret_basic |
| Require PKCE | Obbligatorio per i client pubblici; tienilo attivo anche per quelli confidenziali |
| Description | Mostrata nella schermata di consenso |
| Redirect URIs | Uno per riga. HTTPS obbligatorio al di fuori di localhost |
| Allowed scopes | Vedi sotto |
Usa
noneper i client PKCE locali. Usaclient_secret_*per le integrazioni ospitate o lato server che agiscono comunque solo sulla tua postazione.
Scope disponibili per i client personali
Sezione intitolata “Scope disponibili per i client personali”I client personali possono richiedere solo:
- scope di lettura sicuri per la postazione,
- accesso ai campi personalizzati delle chat limitato a chi agisce,
- accesso offline facoltativo (resta collegato).
I membri hanno limiti ulteriori: “Member clients can request safe read scopes, actor-scoped chat custom field access, and offline access only.” (i client dei membri possono richiedere solo scope di lettura sicuri, accesso ai campi personalizzati delle chat limitato a chi agisce e accesso offline). Gli amministratori hanno un insieme più ampio.
Seleziona almeno uno scope, altrimenti il client non viene salvato.
Il client secret
Sezione intitolata “Il client secret”I client confidenziali ricevono un secret mostrato una sola volta:
One-time reveal: Entergram conserva solo un hash di questo secret. Dopo aver chiuso questa finestra potrai solo ruotarlo, non visualizzarlo di nuovo.
Copialo nel tuo secret manager prima di chiudere. Se lo perdi, Rotate secret ne emette uno nuovo (e invalida il vecchio).
Gestire un client
Sezione intitolata “Gestire un client”Ogni client mostra Public client / Confidential client, PKCE on / PKCE off, Created, Last used, Owner e Active grants. Espandilo per vedere Client details: Client ID, metodo di autenticazione, anteprima del secret, requisito PKCE, ultimo utilizzo da parte di chi, redirect URI.
| Azione | Effetto |
|---|---|
| Edit | Modifica nome, scope, redirect URI |
| Disable | ”The client will stop receiving new authorizations and token refreshes until you enable it again.” (il client smette di ricevere nuove autorizzazioni e rinnovi dei token finché non lo riattivi) |
| Enable | Consente di nuovo autorizzazione e rinnovo |
| Rotate secret | Nuovo secret, mostrato una sola volta |
| Archive | ”Archiving disables the client and revokes your active grants and refresh tokens.” (l’archiviazione disattiva il client e revoca le autorizzazioni attive e i refresh token) |
Stati: Active, Disabled, Archived, Banned.
App autorizzate
Sezione intitolata “App autorizzate”Authorized apps: controlla e revoca le autorizzazioni OAuth MCP emesse dalla tua postazione.
Ogni autorizzazione mostra quando è stata concessa (Granted), quanti Refresh tokens esistono, se era richiesto il PKCE e i Granted scopes (scope concessi).
Revoke access la elimina:
La revoca di un’autorizzazione rimuove subito i refresh token salvati per quell’app. Il client dovrà completare di nuovo OAuth prima di potersi ricollegare.
Stato vuoto: “OAuth grants will appear here after you connect a local or hosted MCP client to Entergram.” (le autorizzazioni OAuth compariranno qui dopo che avrai collegato a Entergram un client MCP locale o ospitato).
Buone pratiche
Sezione intitolata “Buone pratiche”- Un client per strumento. Revocare Claude Desktop non dovrebbe rompere i tuoi workflow n8n.
- Evita
offline_accessper tutto ciò che usi solo in modo interattivo: è ciò che mantiene un client collegato anche quando non ci sei. - Controlla Last used ogni trimestre. Un client che non viene usato da mesi va archiviato.
- Non concedere
messages.writea un agente con cui stai ancora sperimentando. Invia messaggi Telegram a tuo nome.
Articoli correlati
Sezione intitolata “Articoli correlati”Preferenze dei cookie
Rispettiamo il tuo diritto alla privacy. Scegli quali cookie consentire, la tua scelta vale su tutto il sito. Informativa sui cookie
Indispensabili al funzionamento del sito, incluso il ricordo delle tue scelte sulla privacy. Sempre attivi.
Ci aiutano a capire l'uso del sito e ad attribuire le registrazioni ai partner di referral. Facoltativi.