MercatoEsploraProvalo
Prezzi
AccediInizia
Sviluppatori

Chiavi API e permessi

Una chiave API permette a uno strumento o a un assistente IA di lavorare in uno spazio di lavoro come la persona che l’ha creata, limitata ai permessi che scegli. Trattala come una password.

Aggiornata il 4 ottobre 2026

Documentazione per sviluppatori

  • Panoramica
  • MCP e assistenti IA
  • Riferimento API
  • Chiavi API e permessi

In questa pagina

Creare una chiavePermessiRuotare una chiaveRevocare una chiaveCosa una chiave non può mai fareTenere al sicuro le chiavi

Il server accetta token di accesso OAuth e chiavi API dello spazio. Entrambi usano gli stessi permessi, licenze, crediti e limiti. Una chiave appartiene a un solo spazio di lavoro, agisce come il proprietario o l’amministratore che l’ha creata e può raggiungere solo gli endpoint consentiti dai suoi permessi. Le chiavi hanno la forma gr_live_ seguito da 43 lettere, cifre, trattini e trattini bassi.

Aggiungi un connettore personalizzato con ChatGPT: https://gradiently.design/api/mcp/chatgpt; Claude: https://gradiently.design/api/mcp e scegli l’accesso OAuth. Accedi a Gradiently, scegli uno spazio e controlla i permessi. Solo i proprietari e gli amministratori possono collegare un assistente. I collegamenti scadono dopo un’ora e si rinnovano automaticamente per un massimo di 30 giorni. Revoca un collegamento in Impostazioni › API e agenti per interrompere subito accesso e rinnovo.

Creare una chiave

  1. 1

    Apri API e agenti

    In Gradiently, vai in Impostazioni › API e agenti e scegli lo spazio di lavoro a cui è destinata la chiave. Solo i proprietari e gli amministratori di quello spazio di lavoro possono creare chiavi.

  2. 2

    Dalle un nome

    In Crea una chiave, dalle un Nome che dica dove la userai, come Claude Code o Esportazione notturna, così saprai quale revocare più avanti.

  3. 3

    Scegli cosa può fare

    In Cosa può fare, seleziona i permessi di cui ha bisogno, almeno uno. La sezione successiva li spiega uno per uno.

  4. 4

    Copiala una volta

    Seleziona Crea chiave. La chiave compare in Copia la tua chiave ora, ed è l’unica volta in cui viene mostrata. Copiala in un gestore di password o nel tuo archivio di segreti, poi seleziona L’ho salvata.

Chi ha creato una chiave riceve un’email quando viene creata e quando viene revocata, con il nome, l’inizio della chiave e i suoi permessi. L’elenco nelle Impostazioni mostra per ogni chiave attiva il nome, l’inizio della chiave, quando è stata usata l’ultima volta e quanti permessi ha.

Permessi

Un permesso (scope) consente una sola cosa. Una richiesta ha bisogno di tutti i permessi elencati dal suo endpoint, e ogni strumento MCP ha bisogno dei permessi di tutte le richieste che fa. Concedi solo ciò che serve al lavoro.

designs:read

Nelle Impostazioni

Leggere i design

Cosa consente

Leggere brand, design, miniature e caricamenti, generare i design e seguire le serie del Designer.
designs:write

Nelle Impostazioni

Creare e modificare i design

Cosa consente

Creare, modificare, duplicare, condividere ed eliminare design, caricare ed eliminare immagini, e usare il Designer.
marks:read

Nelle Impostazioni

Cercare i Mark

Cosa consente

Cercare nel Mercato, leggere i Mark e le tue bozze, costruire e verificare ricette, e leggere le versioni dei Mark.
marks:claim

Nelle Impostazioni

Riservare i Mark

Cosa consente

Riservare un Mark disponibile, o uno che un altro titolare ha messo in vendita, per chi ha creato la chiave.
brand:generate

Nelle Impostazioni

Generare brand

Cosa consente

Generare e adottare brand, salvare e modificare Mark in bozza, e gestire le versioni dei Mark.
workspaces:read

Nelle Impostazioni

Leggere il workspace

Cosa consente

Leggere lo spazio di lavoro, i suoi membri e il registro attività. Con designs:read, leggere /api/me.
personalities:write

Nelle Impostazioni

Modificare i brand

Cosa consente

Creare, rinominare ed eliminare brand, e cambiare il Mark, il profilo e lo stile di un brand.
members:write

Nelle Impostazioni

Invitare membri

Cosa consente

Inviare inviti per entrare nello spazio di lavoro.
PermessoNelle ImpostazioniCosa consente
designs:readLeggere i designLeggere brand, design, miniature e caricamenti, generare i design e seguire le serie del Designer.
designs:writeCreare e modificare i designCreare, modificare, duplicare, condividere ed eliminare design, caricare ed eliminare immagini, e usare il Designer.
marks:readCercare i MarkCercare nel Mercato, leggere i Mark e le tue bozze, costruire e verificare ricette, e leggere le versioni dei Mark.
marks:claimRiservare i MarkRiservare un Mark disponibile, o uno che un altro titolare ha messo in vendita, per chi ha creato la chiave.
brand:generateGenerare brandGenerare e adottare brand, salvare e modificare Mark in bozza, e gestire le versioni dei Mark.
workspaces:readLeggere il workspaceLeggere lo spazio di lavoro, i suoi membri e il registro attività. Con designs:read, leggere /api/me.
personalities:writeModificare i brandCreare, rinominare ed eliminare brand, e cambiare il Mark, il profilo e lo stile di un brand.
members:writeInvitare membriInviare inviti per entrare nello spazio di lavoro.

Parti dai permessi predefiniti

Una nuova chiave parte con designs:read, designs:write, marks:read, brand:generate e workspaces:read, che bastano per progettare con un assistente IA. Aggiungi marks:claim, personalities:write o members:write solo se la chiave deve riservare Mark, modificare brand o invitare persone.

Le nuove chiavi partono con Leggere i design, Creare e modificare i design, Cercare i Mark, Generare brand e Leggere il workspace già selezionati. Riservare i Mark resta disattivato finché non lo scegli, perché una riserva rende te, che hai creato la chiave, il titolare di un Mark.

Ruotare una chiave

Le chiavi non scadono, e il nome e i permessi di una chiave non si possono cambiare dopo la creazione. Per ruotare una chiave, o per cambiare cosa può fare, sostituiscila:

  1. 1

    Crea la nuova chiave

    Crea una chiave con i permessi che vuoi, con un nome che la distingua da quella vecchia.

  2. 2

    Passa i tuoi strumenti alla nuova chiave

    Metti la nuova chiave in ogni posto in cui usavi quella vecchia: il tuo client MCP, l’archivio di segreti o le impostazioni di deploy.

  3. 3

    Revoca la vecchia chiave

    Quando la data usata della vecchia chiave smette di cambiare nell’elenco, revocala.

Revocare una chiave

In Impostazioni › API e agenti, seleziona Revoca accanto alla chiave e conferma con Revoca chiave. Tutto ciò che la usa smette subito di funzionare, e non si può annullare. I proprietari e gli amministratori dello spazio di lavoro possono revocare qualsiasi sua chiave.

Una chiave smette di funzionare anche da sola quando chi l’ha creata lascia lo spazio di lavoro, scende sotto il ruolo di amministratore o ha l’account disattivato. Le chiavi create da una persona vengono revocate quando viene rimossa dallo spazio di lavoro o retrocessa.

Cosa una chiave non può mai fare

Alcune cose richiedono sempre una persona che ha eseguito l’accesso a Gradiently, qualunque siano i permessi della chiave:

  • Creare, elencare o revocare chiavi.
  • Modificare l’account: profilo, email, password, sessioni di accesso, o eliminarlo.
  • Accedere alla fatturazione: piani, checkout, pagamenti, ricariche di crediti IA, Saldo e pagamenti ricevuti. Una riserva o un acquisto che richiede un pagamento si ferma e chiede di completare il checkout in Gradiently.
  • Cedere un Mark: trasferirlo a qualcun altro, rilasciarlo, metterlo in vendita, rinnovarlo o pubblicarlo.
  • Spostare su uno spazio di lavoro la titolarità o la licenza di un Mark. I Mark riservati da una chiave appartengono a chi l’ha creata, e ogni licenza resta sua.
  • Cambiare chi fa parte dello spazio di lavoro o i ruoli, rinominare, trasferire o eliminare lo spazio di lavoro. Con members:write può solo inviare inviti.
  • Raggiungere uno spazio di lavoro diverso dal suo, nemmeno uno di cui fa parte chi l’ha creata.
  • Usare l’amministrazione di Gradiently.

Tenere al sicuro le chiavi

Da evitare

  • Fare commit di una chiave in un repository o incollarla in un file di configurazione condiviso.
  • Mettere una chiave in una pagina web, in un’app mobile o in qualsiasi cosa che giri sul dispositivo di qualcun altro.
  • Condividere una chiave tra persone o strumenti.
  • Inviare una chiave via email o in chat.
  • Lasciare attivo Riservare i Mark su una chiave che non riserva.

Da fare

  • Crea una chiave per ogni strumento o assistente, con il suo nome.
  • Concedi il minor numero di permessi che basta per il lavoro.
  • Tieni le chiavi in un gestore di password, in un archivio di segreti o in una variabile d’ambiente.
  • Revoca una chiave appena sospetti che sia trapelata, poi creane una nuova.
  • Controlla ogni tanto le date di ultimo utilizzo, e revoca le chiavi che nessuno usa.

Gradiently conserva solo un hash di ogni chiave e il suo inizio da mostrare, quindi una chiave persa non si può mostrare di nuovo: revocala e creane un’altra. Se pensi che una chiave sia stata usata in modo improprio, revocala e diccelo.

Ti serve una mano?

Inviaci una richiesta con l’argomento API e MCP, e ti risponderà una persona.

Invia una richiesta

Trova lo stile che è solo tuo.

Ogni Mark è uno sfondo vivo con un solo proprietario. Prova un Mark ancora disponibile e riserva il tuo quando ti senti pronto.

Inizia a progettareVedi l’offerta di lancio

Mark ancora da riservare

50su 1000

950 riservati finoraTrova il tuo

Verifica un certificato

Scrivi il numero di un certificato o il codice di un Mark per scoprire di chi è.

Funziona con ChatGPT e Claude

Chiedi un design alla tua AI. Lo crea nel tuo Mark, pronto da modificare.

ChatGPTClaude
Come collegarla

Prodotto

  • Mercato
  • Esplora
  • Prezzi
  • Pacchetti di lancio
  • Certificati

Scopri

  • Guida pratica
  • Centro assistenza
  • Novità

Sviluppatori

  • Panoramica
  • ChatGPT e Claude
  • Riferimento API
  • Chiavi API

Azienda

  • Chi siamo
  • Contattaci
  • Accedi

Note legali

  • Termini
  • Privacy
  • Rimborsi
  • Protezione dei Mark
  • Cookie
  • Tutte le policy
Passa sopra le lettere. Ognuna indossa un vero Mark.Tocca una lettera per vedere il suo Mark.Un nome. Dieci Mark al suo interno.
© 2026 Gradiently