La dichiarazione
Dichiara i server in un file.mcp.json nella root, sotto forma di mappa mcpServers. Il campo inline mcpServers del manifest accetta la stessa mappa, senza il wrapper.
Segnaposto.
${NAME} in url o headers viene compilato da chi esegue l’installazione tramite il pannello Connetti del server. ${NAME:-default} fornisce un valore di fallback quando non è stato salvato nulla. Un server di plugin legge solo i valori salvati nella propria installazione, non i segreti di sessione con lo stesso nome. Non scrivere mai un token reale in una dichiarazione: viene memorizzato così com’è.
In alternativa, un server può eseguire un comando locale (command, args, env); in tal caso non accetta nessuno dei campi di credenziale HTTP indicati sopra.
La pagina Server MCP descrive il modulo di Personalizza per un server autonomo. Il server di un plugin usa i nomi dei campi indicati sopra; URL, trasporto e intestazioni vengono mostrati in sola lettura nella riga dell’installazione.
Chi detiene la credenziale
Configurazioni
Ogni configurazione combina una voce della dichiarazione precedente con il punto in cui il plugin viene installato e la relativa modalità di distribuzione: Obbligatorio lo installa per tutti gli utenti nell’ambito, mentre Offerto consente a ciascuna organizzazione o a ciascun membro di installarlo. Entrambe le opzioni si impostano sul plugin in Personalizza.
- OAuth Per-user per tutti
Per un server che supporta OAuth, usa la voce example-mcp e installa il plugin come Obbligatorio a livello di azienda o di organizzazione.
tokenScope: "user" imposta l’Accesso predefinito su Personal, quindi ogni membro effettua l’accesso una sola volta, da Personalizza → MCPs oppure dalla prima sessione che lo richiede.
- Un account di servizio per l’organizzazione
Usa la voce example-mcp-service-account e installa il plugin a livello di organizzazione.
- L’intestazione
Authorizationcontiene un segnaposto, per cui la riga mostra Connetti. Il token viene inserito da un amministratore dell’organizzazione; i membri non lo vedono mai. - Se il server rifiuta il token (401), la riga mostra Verifica la credenziale. Se il server supporta anche OAuth, la riga aggiunge Accedi invece con OAuth.
- Per un account di servizio che accede tramite OAuth, rimuovi l’intestazione, imposta
tokenScope: "org"e collega l’accesso di quell’account.
- Una chiave per organizzazione
Inserisci la voce example-mcp-service-account in un plugin aziendale e impostalo su Offerto alle organizzazioni.
- Ogni organizzazione che lo installa è proprietaria della propria installazione, quindi il relativo amministratore valorizza
${EXAMPLE_MCP_SERVICE_ACCOUNT_TOKEN}con la chiave di quell’organizzazione. - A livello aziendale non viene connesso nulla e nessuna organizzazione può vedere la chiave delle altre.
- Un plugin aziendale Obbligatorio, invece, crea un’unica installazione di proprietà dell’azienda: una sola chiave per tutte le organizzazioni.

