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://; Claude: https:// 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.
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
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
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.
# 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"Per chiamare invece l’API, invia lo stesso header con ogni richiesta:
curl https://gradiently.design/api/marks?q=harbour \
-H "Authorization: Bearer $GRADIENTLY_API_KEY"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.