# Connettore Claude di Gradiently: design con MCP dentro Claude

[Canonical HTML page](https://gradiently.design/it/guide/design-with-claude-connector)

Claude può cercare i Mark, leggere il tuo brand e creare design veri e modificabili nel tuo spazio di lavoro. Ci sono due strade, un connettore con accesso o una chiave con ambito, e questa pagina le copre entrambe.

## The short version

- Gradiently gestisce un server MCP ospitato per Claude all'indirizzo https://gradiently.design/api/mcp.
- Nell'app Claude, Gradiently si aggiunge come connettore personalizzato con accesso OAuth; in Claude Code si aggiunge con una chiave API con ambito da Impostazioni › API e agenti.
- Una nuova chiave API parte con i permessi che servono a ogni strumento di design, e Riservare Mark resta disattivato se non lo scegli.
- Quando Claude compone un design con gli strumenti di Gradiently non spende crediti IA di Gradiently, e ogni design salvato si apre nello Studio.
- Una chiave funziona solo nello spazio di lavoro che l'ha emessa, agisce come il proprietario o l'amministratore che l'ha creata e può essere revocata subito.

Per configurare il connettore **Gradiently Claude**, punta Claude al server MCP ospitato di Gradiently su `https://gradiently.design/api/mcp`. Nell'app Claude, aggiungilo come connettore personalizzato e accedi a Gradiently. In Claude Code, aggiungilo dal terminale con una chiave API con ambito. In entrambi i casi Claude può cercare i Mark, leggere il tuo brand kit e creare design salvati nel tuo spazio di lavoro che si aprono nello Studio, con ogni parola ancora modificabile.

MCP, il Model Context Protocol, è lo standard aperto che permette a Claude di usare strumenti reali. [Cos'è MCP](https://gradiently.design/it/guide/what-is-mcp) lo spiega in modo semplice, e il protocollo stesso è documentato su [modelcontextprotocol.io](https://modelcontextprotocol.io).

## Quale strada scegliere per collegare Claude

| Dove usi Claude | Come si collega | Accesso |
| --- | --- | --- |
| L'app Claude, sul web o desktop | Connettore personalizzato | OAuth: accedi a Gradiently, scegli uno spazio di lavoro |
| Claude Code nel terminale | Server MCP remoto via HTTP | Una chiave API con ambito nell'intestazione Authorization |
| Altri client MCP | Server remoto con intestazione personalizzata | Una chiave API con ambito |

Stesso server, stessi strumenti, stessi permessi. Cambia solo il modo in cui Claude dimostra chi è.

Qualunque strada scegli, devi essere **proprietario o amministratore** dello spazio di lavoro Gradiently. Editor e lettori non possono collegare assistenti né creare chiavi.

## Collegare l'app Claude con un connettore personalizzato

1. **Apri le impostazioni dei connettori di Claude** Aggiungi un connettore personalizzato. Quali piani di Claude consentono i connettori personalizzati lo decide Anthropic, quindi controlla le pagine di aiuto di Claude se non vedi l'opzione. [I connettori di Claude](https://gradiently.design/it/guide/claude-connectors) spiega la funzione.
2. **Incolla l'indirizzo del server** Chiamalo Gradiently e usa `https://gradiently.design/api/mcp`. Scegli l'accesso OAuth.
3. **Accedi e scegli uno spazio di lavoro** Nella finestra di Gradiently, scegli lo spazio di lavoro in cui Claude deve operare e leggi i permessi sotto **Consenti a questo assistente di**.
4. **Consenti, poi verifica** Scegli **Consenti connessione**. Tornato in Claude, chiedigli di elencare i suoi strumenti Gradiently per conferma.

L'accesso si rinnova da solo fino a 30 giorni, poi ti ricolleghi. Un connettore personalizzato lo puoi usare subito; un inserimento nella directory pubblica di Claude è una cosa a parte e richiede la revisione di Anthropic.

## Collegare Claude Code con una chiave API con ambito

Claude Code usa una chiave invece dell'accesso. Creane una in Gradiently sotto **Impostazioni › API e agenti**: scegli lo spazio di lavoro, dalle un nome che dica dove vive (*Claude Code, portatile*), spunta cosa può fare e seleziona **Crea chiave**. La chiave viene mostrata una sola volta, quindi copiala subito nel tuo gestore di password.

```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 così non finisce mai nella cronologia della shell o in un file di cui fai commit. Avvia una nuova sessione e chiedi a Claude di elencare gli strumenti di Gradiently.

Gli altri client che leggono un file JSON di solito accettano lo stesso server e la stessa intestazione. Le Impostazioni mostrano uno snippet pronto sotto **Collega un client MCP**.

```json
{
  "mcpServers": {
    "gradiently": {
      "url": "https://gradiently.design/api/mcp",
      "headers": { "Authorization": "Bearer gr_live_…" }
    }
  }
}
```

La forma JSON che molti client MCP accettano. Controlla la documentazione del tuo client per il formato esatto.

## Scegliere i permessi della chiave

Ogni permesso è un ambito. Una nuova chiave parte con cinque che coprono ogni strumento di design, quindi la maggior parte delle persone non cambia nulla. Aggiungi gli altri solo quando Claude ne ha davvero bisogno.

| Permesso nelle Impostazioni | Attivo di default | Cosa consente |
| --- | --- | --- |
| Leggere i design | Sì | Leggere brand, design e caricamenti, e renderizzare i design |
| Creare e modificare i design | Sì | Creare, cambiare e ridimensionare design, caricare immagini, usare il Designer |
| Cercare i Mark | Sì | Cercare nel Mercato e leggere qualsiasi Mark pubblico |
| Leggere lo spazio di lavoro | Sì | Leggere lo spazio di lavoro e i suoi membri |
| Generare brand | Sì | Generare direzioni di brand da un nome e una descrizione |
| Modificare i brand | No | Cambiare il profilo e il Mark di un brand, creare brand |
| Riservare Mark | No | Riservare un Mark disponibile per chi ha creato la chiave |
| Invitare membri | No | Inviare inviti a unirsi allo spazio di lavoro |

Concedi solo ciò che serve al lavoro. Gli ambiti di una chiave non si possono cambiare dopo, quindi crea una nuova chiave se il lavoro cambia.

## Cosa può fare Claude una volta collegato

Claude lavora attraverso le stesse azioni che hai nel prodotto. Può cercare nel Mercato per nome, parole di colore o codice; leggere il profilo, la voce e i font del tuo brand; disegnare un design originale, guardare l'immagine renderizzata e rifinirla; compilare uno dei template di Gradiently; cambiare le parole di un design salvato; creare copie ridimensionate; e renderizzare un design in PNG o PDF. Quando Claude compone da solo il design, Gradiently **non addebita crediti IA**. Se gli chiedi di passare il lavoro al Designer di Gradiently, quello usa crediti come nello Studio.

Claude Code rende facile un tipo particolare di lavoro. Poniamo che tu tenga un blog e voglia un'immagine di anteprima per ogni articolo. Chiedi: *«Per ogni articolo in /content, crea un'anteprima link da 1200×630 nel nostro brand con il titolo dell'articolo, poi renderizzale una per una in PNG dentro /public/og.»* Claude disegna ogni immagine in Gradiently, la controlla e scrive i file dove il tuo sito li aspetta. [La dimensione dell'immagine Open Graph](https://gradiently.design/it/guide/open-graph-image-size) spiega perché 1200×630.

Un'ampia immagine di anteprima link di un blog con il titolo di un articolo di ingegneria su uno sfondo a gradiente

Un'anteprima link da 1200×630 disegnata tramite il server MCP di Gradiently e renderizzata direttamente nella cartella di un sito.

> **Consenti chiamate lunghe agli strumenti** La maggior parte degli strumenti risponde in pochi secondi, ma renderizzare e ispezionare un design può richiedere fino a tre minuti, e un lavoro passato al Designer fino a circa cinque. Se il tuo client ha un'impostazione di timeout per gli strumenti, alzala.

## Prompt che funzionano bene con Claude

- *«Leggi il profilo del nostro brand, poi crea un post LinkedIn e un post X per annunciare il nostro nuovo ufficio a Bristol.»*
- *«Trova tre Mark scuri con un materiale seta vicino al verde acqua profondo e dammi i loro codici.»*
- *«Prendi l'annuncio di ieri e fanne una storia e una miniatura YouTube.»*
- *«Cambia la data sul poster dell'evento al 14 novembre e renderizzalo in PDF.»*

Quanto migliore è il tuo brand kit, meno devi dire in ogni richiesta; [la voce del brand per l'IA](https://gradiently.design/it/guide/brand-kit-voice) mostra cosa compilare. Per altre idee sui post social, vedi [Claude per i social media](https://gradiently.design/it/guide/claude-social-media-posts), e per il quadro generale, [design con Claude](https://gradiently.design/it/guide/design-with-claude).

## Tenere al sicuro la connessione

### Una chiave può

- Lavorare nell'unico spazio di lavoro che l'ha emessa
- Fare ciò che consentono il ruolo di chi l'ha creata e i suoi ambiti
- Creare design che appartengono allo spazio di lavoro
- Mostrare quando è stata usata l'ultima volta, nelle Impostazioni

### Una chiave non può mai

- Accedere a un altro spazio di lavoro, nemmeno uno di cui fai parte
- Pagare nulla o accedere alla fatturazione
- Trasferire, mettere in vendita o rilasciare un Mark
- Creare o gestire altre chiavi

Se una chiave trapela o smetti di usarla, seleziona **Revoca** accanto a essa in **Impostazioni › API e agenti** e smette subito di funzionare. Le chiavi si fermano anche quando chi le ha create lascia lo spazio di lavoro o perde il ruolo di amministratore. Usi anche ChatGPT? [Gradiently in ChatGPT](https://gradiently.design/it/guide/design-with-chatgpt-app) ha la sua configurazione, e il riferimento completo agli strumenti è nella [documentazione per sviluppatori](https://gradiently.design/it/developers/mcp).

## FAQ

### Qual è l'indirizzo del server MCP di Gradiently per Claude?

`https://gradiently.design/api/mcp`. Nell'app Claude usalo come connettore personalizzato con OAuth; in Claude Code, aggiungilo con la tua chiave API nell'intestazione Authorization.

### Mi serve una chiave API per usare Gradiently in Claude?

Non nell'app Claude, che accede con OAuth. Claude Code e la maggior parte degli altri client MCP richiedono una chiave con ambito da Impostazioni › API e agenti.

### Claude spende i miei crediti IA di Gradiently?

Non quando compone da solo i design con gli strumenti di Gradiently. Passare un lavoro al Designer di Gradiently usa crediti.

### Claude può riservare un Mark per me?

Solo con una chiave che ha il permesso Riservare Mark, disattivato di default. Ogni riserva che richiede un pagamento va comunque completata in Gradiently.

### Perché Claude dice di non riuscire ad autenticarsi?

La chiave è stata digitata male o revocata, oppure chi l'ha creata non è più proprietario o amministratore dello spazio di lavoro. Crea una nuova chiave e aggiorna il tuo client.