MercatoEsploraProvalo
Prezzi
AccediInizia

Gradiently per sviluppatori

Crea con Gradiently

Usa l’API e il server MCP di Gradiently per permettere al tuo codice, o al tuo assistente IA, di cercare Mark e creare design che si aprono nello Studio.

Aggiornata il 4 ottobre 2026

Documentazione per sviluppatori

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

In questa pagina

Cosa puoi fareMCP o l’APIPer iniziareCome agisce una chiaveIl resto della documentazione

Gradiently offre un’API HTTP e un server MCP ospitato. Collega un assistente con OAuth o una chiave API limitata a uno spazio. Il server accetta token di accesso OAuth e chiavi API dello spazio. Entrambi usano gli stessi permessi, licenze, crediti e limiti.

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.

Cosa puoi fare

  • Cercare nel Mercato e leggere la ricetta completa di qualsiasi Mark pubblico.
  • Generare proposte di brand da un nome e una descrizione, poi adottarne una: un Mark in bozza, un brand e tre design iniziali in un solo passaggio.
  • Creare design con il Designer di Gradiently, con il motore di impaginazione o da un modello, e ricevere un link che si apre nello Studio.
  • Modificare i design salvati elemento per elemento, cambiarne le parole, salvarne copie in altri formati e metterci sopra un altro Mark.
  • Generare un design salvato in PNG o PDF, oppure pubblicarne un link di visualizzazione.
  • Forgiare ricette di Mark da un’intenzione, verificarne colore e leggibilità, e conservare le versioni delle tue bozze.

I permessi decidono cosa funziona

Ogni chiave ha dei permessi (scope), e ogni strumento ed endpoint ne richiede alcuni in particolare. Una nuova chiave parte con i cinque che servono alla maggior parte degli strumenti, e puoi aggiungere o togliere uno qualsiasi degli otto. Chiavi API e permessi li elenca tutti, e ogni strumento in MCP e assistenti IA indica i permessi di cui ha bisogno.

MCP o l’API

Server MCP

  • Per gli assistenti IA che supportano server MCP remoti.
  • Un solo indirizzo: https://gradiently.design/api/mcp.
  • Gli strumenti trovano il tuo brand, salvano i design e ti restituiscono i link allo Studio.
  • Ideale quando vuoi chiedere un lavoro a parole.

API

  • Per script, back end e automazioni.
  • JSON su HTTPS sotto https://gradiently.design/api.
  • Scegli tu il brand, invii il documento del design e gestisci ogni risposta.
  • Ideale quando ti serve un controllo preciso e ripetibile.

Gli strumenti MCP sono costruiti sull’API. Una chiamata a uno strumento fa le stesse richieste che farebbe il tuo codice, con la stessa chiave, quindi conta sugli stessi limiti e fallisce con gli stessi messaggi.

Per iniziare

  1. 1

    Crea una chiave

    In Gradiently, apri Impostazioni › API e agenti, scegli lo spazio di lavoro, dai alla chiave il nome del posto in cui la userai, scegli cosa può fare e seleziona Crea chiave. Copia la chiave quando compare: viene mostrata una sola volta. Solo proprietari e amministratori possono creare chiavi.

  2. 2

    Collega il tuo assistente

    In Claude Code, aggiungi Gradiently come server MCP remoto con la tua chiave nell’header Authorization (il comando è qui sotto). Gli altri client sono descritti in MCP e assistenti IA.

bash
# Paste your key when asked. It stays hidden and out of your shell history.
read -rs GRADIENTLY_API_KEY && export GRADIENTLY_API_KEY

claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
  --header "Authorization: Bearer $GRADIENTLY_API_KEY"
Tieni la chiave in una variabile d’ambiente o in un gestore di segreti, mai in un file di cui fai commit.

Per chiamare invece l’API, invia lo stesso header con ogni richiesta:

bash
curl https://gradiently.design/api/marks?q=harbour \
  -H "Authorization: Bearer $GRADIENTLY_API_KEY"
Per cercare nel Mercato serve una chiave con il permesso Cercare i Mark (marks:read).

Come agisce una chiave

Una chiave agisce come la persona che l’ha creata, dentro l’unico spazio di lavoro per cui è stata creata. Non può mai raggiungere un altro spazio di lavoro, nemmeno uno di cui fa parte chi l’ha creata. Funziona solo finché chi l’ha creata è ancora proprietario o amministratore di quello spazio di lavoro e il suo account è attivo; se viene rimosso, retrocesso o disattivato, la chiave smette di funzionare.

  • Design, brand e caricamenti creati da una chiave appartengono allo spazio di lavoro, esattamente come se chi l’ha creata li avesse fatti nell’app.
  • I Mark riservati da una chiave appartengono a chi l’ha creata, mai allo spazio di lavoro, e ogni licenza resta sua.
  • Il lavoro del Designer avviato da una chiave consuma i crediti IA dello spazio di lavoro, come il Designer nello Studio.
  • Una chiave non può gestire chiavi, modificare l’account, accedere alla fatturazione o cedere un Mark. Chiavi API e permessi elenca cosa non può mai fare.

Il resto della documentazione

  • MCP e assistenti IA: come collegare Claude Code e altri client, ogni strumento con i suoi input e permessi, ed esempi di prompt.
  • Riferimento API: l’URL di base, l’autenticazione, ogni endpoint che una chiave può chiamare, gli errori, i limiti di frequenza e la paginazione.
  • Chiavi API e permessi: creare, ruotare e revocare le chiavi, cosa consente ogni permesso e come tenere le chiavi al sicuro.
  • Non conosci MCP? Cos’è MCP lo spiega a parole semplici, e modelcontextprotocol.io ha la specifica.

Qualcosa non va, o ti manca ciò che ti serve? Inviaci una richiesta e ti risponderà una persona.

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