Creare una chiave MCP

Una chiave MCP è una chiave API personale che consente a un client AI esterno, come OpenAI Agent Builder, Cursor o Claude Desktop, di connettersi a Performance Hub tramite il suo server MCP. Crei e gestisci queste chiavi in autonomia da Preferenze utente; ogni chiave appartiene al tuo account ed eredita il tuo accesso.

Prima di iniziare

Le chiavi MCP sono legate al tuo account utente, non a una singola struttura: la chiave ha lo stesso accesso che il tuo account ha già.
Il valore segreto della nuova chiave viene mostrato una sola volta, al momento della creazione. Tieni pronto un luogo sicuro in cui conservarla (un password manager o le impostazioni del tuo client MCP).
Per configurare il tuo client MCP ti servono due cose: il campo URL del server e una chiave attiva. Entrambi sono disponibili nella stessa finestra di dialogo.

Apri il gestore delle chiavi MCP

Apri Preferenze utente

Fai clic sulla tua icona del profilo in alto a destra nella barra degli strumenti per aprire il menu dell'account, quindi scegli Preferenze utente.

Menu dell'account con Preferenze utente — Figura 1: il menu dell'account - apri Preferenze utente

Apri API & MCP Keys

Nella finestra di dialogo Preferenze utente , fai clic su Chiavi API e MCP.

Esamina la finestra di dialogo Manage MCP Keys

Il Gestisci chiavi MCP si apre. La sua intestazione offre tre azioni: Crea chiave, Visualizza documenti MCP, e Scarica CSV (disponibile dopo aver creato la tua prima chiave). Quando hai almeno una chiave, in alto compare un pannello Configurazione server MCP con il campo URL del server e un promemoria a usare qualsiasi chiave attiva come chiave API.

Crea una chiave

Avvia una nuova chiave

Fai clic su Crea chiave. Compare un piccolo modulo in linea con un solo campo Etichetta .

Assegna un'etichetta

Inserisci un'etichetta Etichetta che descriva dove verrà usata la chiave, ad esempio OpenAI AgentKit. L'etichetta serve solo come tuo riferimento e puoi rinominarla in seguito. Fai clic su Crea (oppure Annulla per chiudere il modulo).

Modulo in linea per creare una chiave — Figura 4: il modulo di creazione in linea - assegna alla chiave un'etichetta descrittiva

Copia subito la chiave

La chiave viene generata immediatamente e mostrata nel pannello evidenziato Nuova chiave MCP (mostrata una sola volta) in cima all'elenco. Da qui puoi usare Copia per copiare il valore della chiave negli appunti, oppure usa CSV per scaricarla e conservarla al sicuro. Dopo aver chiuso o aggiornato la finestra di dialogo, il valore completo non può più essere recuperato: viene mostrata solo un'anteprima oscurata (ad es. phk_7Qm2…Xa9LkP).

Nuova chiave mostrata una sola volta — Figura 5: la chiave appena creata - copia o scarica subito il segreto, non verrà più mostrato

Sicurezza: Tratta una chiave MCP come una password. Non incollarla in documenti condivisi, screenshot o chat. Se una chiave viene esposta, disattivala subito (ed eliminala), quindi creane una sostitutiva.

Collega il tuo client MCP

Usa i dettagli del pannello Configurazione server MCP per configurare il tuo client AI:

Campo	Dove trovarlo	Note
URL del server	Parte superiore della finestra di dialogo Manage MCP Keys	Fai clic su Copy per copiarlo. È l'indirizzo a cui si connette il tuo client MCP.
Chiave API	Qualsiasi chiave Active nell'elenco	Usa il valore segreto che hai copiato o scaricato quando hai creato la chiave.

Per gli snippet di installazione specifici per ogni client (Cursor, Claude Desktop e altri), consulta Configurare e integrare.

Gestisci le chiavi esistenti

Ogni chiave nell'elenco mostra il suo identificatore oscurato, un badge di stato, un campo modificabile Etichetta, e i timestamp Creato (e, se usato, Ultimo utilizzo), insieme ai controlli del ciclo di vita.

Controlli di gestione delle chiavi — Figura 6: i controlli del ciclo di vita di una chiave - rinomina, disattiva, riattiva o elimina

Stati delle chiavi

Stato	Significato
Attivo	La chiave funziona e può autenticare le richieste MCP.
Disattivato	La chiave è disabilitata e verrà rifiutata. Può essere riattivata o eliminata definitivamente.

Azioni disponibili

Azione	Quando viene mostrata	Cosa fa
Label (campo modificabile)	Sempre	Rinomina una chiave direttamente nell'elenco. Un segno di spunta verde conferma Changes Saved.
Disattiva	Chiavi attive	Disabilita immediatamente la chiave. I client MCP che la usano smetteranno di funzionare.
Riattiva	Chiavi disattivate	Riattiva una chiave disabilitata in precedenza.
Elimina	Solo chiavi disattivate	Rimuove definitivamente la chiave. Una chiave deve essere disattivata prima di poter essere eliminata e l'operazione non può essere annullata.
Scarica CSV	Intestazione, dopo la creazione della prima chiave	Esporta l'elenco delle chiavi (identificatori, etichette, stato, timestamp) in un file CSV.

Per ritirare una chiave in sicurezza: usa Disattiva per prima cosa (questo blocca immediatamente qualsiasi client che la usa ancora), verifica che tutto funzioni, quindi usa Elimina se non ti serve più.

Avanti: configura e integra il tuo client