Vai al contenuto principale
Un plugin può includere server MCP (ad esempio un sistema di tracciamento dei problemi), così chiunque lo installi ottiene la stessa configurazione del server senza doverla impostare da zero. Dopo l’installazione, fornisci le credenziali richieste dal server, come una chiave API o un accesso tramite OAuth. Una connessione può essere personale o condivisa, a seconda di dove è installato il plugin e dell’impostazione Accesso dell’installazione.

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.

  1. 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.

  1. Un account di servizio per l’organizzazione

Usa la voce example-mcp-service-account e installa il plugin a livello di organizzazione.
  • L’intestazione Authorization contiene 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.

  1. 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.

  1. Entrambi in un unico plugin

Includi entrambe le voci, come nella dichiarazione precedente, e rendi disponibile il plugin. Ogni organizzazione che lo installa ottiene due righe: una a cui accedono i membri e una che collega l’amministratore dell’organizzazione. Grazie a nomi di server distinti, le skill del plugin possono indicare quale server usare.