Autorizzi capacità, non un nuovo ruolo nello spazio di lavoro.
OAuth permette a Claude, Codex o ChatGPT di agire come l’utente HumanDesign.ai autenticato. Non crea accessi, non modifica l’appartenenza e non concede a un agente la proprietà di uno spazio di lavoro.
Significato della selezione dello spazio di lavoro
La schermata di consenso chiede «Dove dovrebbe lavorare Claude?» perché un account a pagamento può avere una libreria personale e uno o più spazi di lavoro di team o aziendali. La scelta definisce il limite dei dati, non è un’autorizzazione di appartenenza aggiuntiva. Ogni chiamata controlla comunque l’appartenenza, il ruolo, le concessioni di capacità, la proprietà e le autorizzazioni del prodotto. L’autorizzazione di Builder si applica ai progetti idonei entro tale limite; i progetti non richiedono concessioni OAuth separate.
Account Free e Individual: non dispongono di un selettore dello spazio di lavoro. La connessione è limitata all’account personale e al grafico principale dell’utente; Individual include anche l’utilizzo dell’account. Per i grafici di altre persone e gli strumenti più ampi della piattaforma è necessario Personal o Pro.
Per mantenere chiaro il consenso, Personal e Pro mostrano un’unica autorizzazione combinata Grafici e libreria invece di caselle sovrapposte per «il tuo grafico» e «libreria». Nel limite Personal include il grafico principale e la libreria consentita; in uno spazio di lavoro selezionato si limita ai grafici e ai compositi ammessi al suo interno.
Ambiti di identità e concessioni di capacità
Il protocollo OAuth richiede solo ambiti di identità e sessione come email, profilee offline_access. Dopo l’accesso, HumanDesign.ai ricava le seguenti concessioni interne di capacità dal limite dell’account selezionato, dall’appartenenza, dal ruolo, dalla proprietà e dalle autorizzazioni. Sono etichette di applicazione delle regole, non ambiti OAuth aggiuntivi che un client può richiedere per aggirare l’appartenenza.
| Concessione di capacità | Consente di |
|---|---|
charts:read | Leggere record di grafici autorizzati |
charts:generate | Creare il grafico principale dell’utente connesso dopo anteprima e conferma |
library:read | Cercare e recuperare elementi consentiti della libreria |
library:organize | Gestire cartelle e collocazione degli elementi |
reports:read | Leggere modelli, report e stato di generazione |
builder:read | Leggere progetti ed esecuzioni Builder autorizzati |
builder:write | Annullare un’esecuzione Builder attiva quando consentito |
account:usage | Leggere saldi, quota e riepiloghi di utilizzo |
Cosa viene mostrato nell’agente
tools/list viene filtrato in base alle concessioni di capacità correnti dell’utente autenticato, all’appartenenza, al ruolo nello spazio di lavoro, alla proprietà e alle autorizzazioni. Gli upgrade, i downgrade, le modifiche del ruolo e le concessioni revocate diventano effettivi dopo la riconnessione o il rinnovo del token. Anche lo stato e l’annullamento dell’operazione ricontrollano la capacità che ha autorizzato l’operazione originale, quindi la rimozione di un permesso non può lasciare un vecchio processo accessibile tramite gli strumenti operativi.
Conferma ed effetti esterni
Quando uno strumento offre un’anteprima o una conferma, questa è vincolata all’attore, al limite, all’azione, agli argomenti, alla destinazione, all’addebito massimo e alla scadenza. La modifica di uno di questi dettagli la invalida. La creazione del grafico principale richiede un’anteprima da un’unità e una conferma; anche l’eliminazione di una cartella della libreria richiede conferma. L’annullamento di operazioni e di esecuzioni Builder viene eseguito direttamente solo se lo stato corrente lo consente. Le azioni di pubblicazione e consegna a rischio più elevato restano indisponibili in questa versione.
Revoca dell’accesso
Disconnetti HumanDesign.ai nelle impostazioni del connettore del client oppure cancella l’autenticazione MCP. La revoca termina la connessione delegata; non elimina i dati HumanDesign.ai né modifica l’appartenenza.