> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Server MCP dei plugin in Devin

> Dichiara i server MCP in un plugin di Devin e decidi chi detiene la credenziale: ciascun membro, un account di servizio dell'organizzazione o l'azienda.

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.

```json theme={null}
{
  "mcpServers": {
    "example-mcp": {
      "url": "https://mcp.example.com/mcp",
      "tokenScope": "user"
    },
    "example-mcp-service-account": {
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${EXAMPLE_MCP_SERVICE_ACCOUNT_TOKEN}"
      }
    }
  }
}
```

| Campo | Tipo | Funzione |
| - | - | - |
| `url` | string | L'endpoint del server. Obbligatorio. |
| `transport` | string | Imposta `"sse"` per un endpoint SSE legacy. Omettilo per Streamable HTTP. |
| `headers` | object | Intestazioni HTTP inviate con ogni richiesta. I valori possono contenere segnaposto. |
| `oauthClientId` | string | Un client OAuth pre-registered, per i provider che non supportano la registrazione dinamica dei client. Se è impostato, il server diventa OAuth, indipendentemente dalle sue intestazioni. |
| `oauthClientSecret` | string | Non accettato da un plugin: la dichiarazione viene rifiutata. L'amministratore che esegue l'installazione inserisce il segreto nelle impostazioni del server. |
| `oauthScopes` | string\[] | Ambiti da richiedere. Richiede `oauthClientId`. |
| `oauthResource` | string | Sostituisce il parametro `resource` della RFC 8707 (predefinito: l'URL del server). `""` lo omette; qualsiasi altro valore deve identificare questo server. |
| `tokenScope` | string | **Accesso** predefinito per un'installazione a livello di organizzazione o di azienda di un server OAuth: `"user"` (ogni membro effettua l'accesso) o `"org"` (un'unica connessione condivisa). Se non è impostato, si applica l'ambito della voce del marketplace o, in sua assenza, una connessione condivisa. Un valore dichiarato viene riapplicato a ogni riconciliazione del plugin. Un'installazione personale è sempre legata all'account del membro. |
| `disabled` | boolean | Con `true` il server viene ignorato. |
| `disabledTools` | string\[] | Nomi degli strumenti di questo server nascosti a Devin. |
| `description` | string | Mostrata accanto al server in Personalizza. |

**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](https://docs.devin.ai/it/product-guides/secrets.md) 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.

> [!NOTE]
>
> La pagina [Server MCP](https://docs.devin.ai/it/work-with-devin/mcp.md#configuration-format) 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

| Installato da | La credenziale appartiene a | Chi effettua la connessione |
| - | - | - |
| Un membro (ambito personale) | Quel membro | Il membro stesso, da Personalizza → MCPs |
| Un'organizzazione | L'organizzazione (`Access: Organization`) o ciascun membro (`Access: Personal`) | Un amministratore dell'organizzazione o ciascun membro |
| L'azienda | L'azienda (`Access: Enterprise`) o ciascun membro di ogni org (`Access: Personal`) | Un amministratore aziendale o ciascun membro |

## 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](https://docs.devin.ai/it/product-guides/plugins.md#mcps).

### 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 `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.

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

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.