MCP di Gradiently: collega Claude, ChatGPT o qualsiasi client MCP

Per usare il server MCP di Gradiently, crea una chiave API in Impostazioni › API e agenti, poi aggiungi l’endpoint ospitato https://gradiently.design/api/mcp al tuo client MCP con l’intestazione Authorization: Bearer <la tua chiave>. La connessione è tutta qui. Da quel momento un assistente come Claude può cercare Mark, leggere il tuo brand, creare design e modificarli, e ogni design che crea si apre nel tuo Studio come qualsiasi altro.

MCP, il Model Context Protocol, è uno standard aperto che permette agli assistenti IA di usare strumenti reali. Se l’idea ti è nuova, cos’è MCP la spiega in parole semplici, e il sito del protocollo, modelcontextprotocol.io, contiene la specifica. Il riferimento tecnico completo del server di Gradiently si trova nella documentazione per sviluppatori.

Cosa ti serve prima di iniziare

• Un account Gradiently e uno spazio di lavoro di cui sei proprietario o amministratore. Solo proprietari e amministratori possono creare o revocare le chiavi.
• Un client MCP in grado di collegarsi a un server remoto via HTTP e di inviare un’intestazione Authorization personalizzata. Claude Code ci riesce; lo fanno anche molti client desktop e per editor.
• Un posto sicuro per la chiave, come un gestore di password o l’archivio dei segreti del tuo client. Viene mostrata una sola volta.

Passo 1: crea una chiave API con permessi limitati

1. 1

   Apri Impostazioni › API e agenti

   Scegli con il selettore in alto lo spazio di lavoro in cui deve operare l’assistente. Una chiave agisce sempre e solo nello spazio di lavoro che l’ha emessa.

2. 2

   Dagli il nome del posto in cui verrà usata

   «Claude Desktop» oppure «Agente marketing». Il nome è ciò che ti dirà quale revocare più avanti.

3. 3

   Seleziona solo ciò che serve

   I permessi sono elencati qui sotto. Quattro sono selezionati di default; Riservare i Mark no.

4. 4

   Crea, poi copiala subito

   La chiave compare una sola volta, per intero. Copiala nel tuo gestore di password prima di chiudere la finestra. Dopo, Impostazioni mostra solo i suoi primi caratteri, quando è stata usata l’ultima volta e quanti permessi ha.

Passo 2: aggiungi l’endpoint al tuo client

La stessa pagina mostra uno snippet pronto sotto Collega un client MCP, con un pulsante per copiarlo. I client che leggono una configurazione JSON lo accettano così com’è; metti la tua chiave al posto di YOUR_KEY.

{
  "mcpServers": {
    "gradiently": {
      "url": "https://gradiently.design/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

In Claude Code, aggiungi il server dal terminale. Tieni la chiave in una variabile d’ambiente invece di digitarla nella cronologia della shell.

claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
  --header "Authorization: Bearer $GRADIENTLY_API_KEY"

Altri assistenti, compreso ChatGPT, possono collegarsi dove l’app, il piano e le impostazioni dello spazio di lavoro consentono un server MCP remoto personalizzato con un’intestazione di autorizzazione. Il supporto differisce da client a client e cambia nel tempo, quindi controlla le pagine di aiuto del tuo client; creare design in linea con il brand da ChatGPT spiega a cosa fare attenzione. Una volta collegato, chiedi all’assistente di elencare i suoi strumenti Gradiently per confermare che ha funzionato.

Cosa può fare il tuo assistente una volta collegato

Il server espone le stesse azioni che hai nel prodotto, con gli stessi permessi. Raggruppate per compito, sono così:

Le richieste semplici funzionano meglio. L’assistente le passa al Designer, che legge il profilo del tuo brand e il Mark del brand prima di comporre qualsiasi cosa. Come nello Studio, il lavoro del Designer si misura in crediti IA.

• «Crea sei post per il lancio d’autunno nel nostro brand, verticali per Instagram.»
• «Prendi l’annuncio di ieri e ricavane una storia e un’intestazione per X.»
• «Trova tre Mark scuri con un materiale in seta e dimmi i loro codici.»
• «Aggiorna il profilo del nostro brand: abbiamo un tono calmo e preciso, mai promozionale.»

Per una guida più completa specifica per Claude, vedi progettare con Claude tramite Gradiently. Se vuoi che l’assistente resti in linea con il brand, linee guida del brand che il tuo assistente IA sa seguire mostra come scrivere il profilo del brand che legge.

Tenere al sicuro la connessione

Alcune garanzie valgono qualunque cosa faccia il client. Una chiave funziona solo nello spazio di lavoro che l’ha emessa. Agisce con le stesse regole della persona che l’ha creata, quindi non può fare nulla che il suo ruolo non possa fare. Una chiave non trasferisce mai la proprietà di un Mark allo spazio di lavoro o a qualcun altro. I design privati restano privati: un link di sola visualizzazione esiste solo quando lo chiedi. E se la persona che ha creato una chiave viene rimossa dallo spazio di lavoro o perde il ruolo di amministratore, anche le sue chiavi smettono di funzionare.