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 1 ottobre 2026

Gradiently ti offre due vie d’accesso. Il server MCP permette a un assistente IA come Claude Code di usare gli strumenti di Gradiently mentre gli parli. L’API permette al tuo codice di chiamare direttamente gli stessi endpoint. Entrambi si autenticano con una chiave API che appartiene a un solo spazio di lavoro, ed entrambi passano per gli stessi controlli dell’app: ruoli nello spazio di lavoro, licenze dei Mark, crediti IA e limiti di frequenza.

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.

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.

  3. 3

    Chiedi qualcosa

    Prova «Genera tre direzioni di brand per una piccola panetteria chiamata Hearth, calma e accogliente, poi adotta la prima.» L’assistente chiama generate_brand e adopt_brand, e ottieni nel tuo spazio di lavoro un nuovo brand con il suo Mark in bozza e i design iniziali.

bash
export GRADIENTLY_API_KEY="gr_live_…"

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