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

# Serveurs MCP des modules d’extension dans Devin

> Déclarez des serveurs MCP dans un module d’extension Devin et choisissez qui détient les informations d’identification : chaque membre, un compte de service de l’organisation ou l’Enterprise.

Un module d’extension peut inclure des serveurs MCP (par exemple un outil de suivi des tickets) : toutes les personnes qui l’installent disposent ainsi de la même configuration de serveur, sans devoir la recréer de zéro. Une fois le module installé, vous fournissez les informations d’identification requises par le serveur, comme une clé d’API ou une connexion OAuth. Une connexion peut être personnelle ou partagée, selon l’endroit où le module d’extension est installé et le paramètre **Access** de l’installation.

## La déclaration

Déclarez les serveurs dans un fichier `.mcp.json` placé à la racine, sous la forme d'une map `mcpServers`. Le champ `mcpServers` défini en ligne dans le manifeste accepte la même map, sans l'objet englobant.

```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}"
      }
    }
  }
}
```

| Champ | Type | Rôle |
| - | - | - |
| `url` | string | L'endpoint du serveur. Obligatoire. |
| `transport` | string | Définissez `"sse"` pour un endpoint utilisant l'ancien SSE. Omettez-le pour Streamable HTTP. |
| `headers` | object | En-têtes HTTP envoyés avec chaque requête. Les valeurs peuvent contenir des espaces réservés. |
| `oauthClientId` | string | Un client OAuth préenregistré, pour les fournisseurs qui ne prennent pas en charge l'enregistrement dynamique de clients. S'il est défini, le serveur est traité comme un serveur OAuth, quels que soient ses en-têtes. |
| `oauthClientSecret` | string | Refusé dans un module d’extension : la déclaration est rejetée. L'administrateur qui installe le module saisit le secret dans les paramètres du serveur. |
| `oauthScopes` | string\[] | Étendues à demander. Nécessite `oauthClientId`. |
| `oauthResource` | string | Remplace le paramètre `resource` de la RFC 8707 (par défaut : l'URL du serveur). `""` l'omet ; toute autre valeur doit identifier ce serveur. |
| `tokenScope` | string | **Access** par défaut pour l'installation d'un serveur OAuth au niveau de l'organisation ou de l'Enterprise : `"user"` (chaque membre se connecte) ou `"org"` (une seule connexion partagée). S'il n'est pas défini, le périmètre de l'entrée de la place de marché s'applique ; à défaut, une connexion partagée est utilisée. Une valeur déclarée est réappliquée à chaque réconciliation du module d’extension. Une installation personnelle utilise toujours la connexion propre du membre. |
| `disabled` | boolean | `true` ignore le serveur. |
| `disabledTools` | string\[] | Noms des outils de ce serveur masqués pour Devin. |
| `description` | string | Affichée avec le serveur dans Personnaliser. |

**Espaces réservés.** `${NAME}` dans `url` ou `headers` est renseigné par la personne qui installe le module, depuis le volet Connect du serveur. `${NAME:-default}` fournit une valeur de fallback lorsqu'aucune valeur n'est enregistrée. Un serveur de module d’extension lit uniquement les valeurs enregistrées sur son installation, et non les [secrets de session](https://docs.devinenterprise.com/fr/product-guides/secrets.md) portant le même nom. N'écrivez jamais de vrai token dans une déclaration : il est stocké tel quel.

Un serveur peut aussi exécuter une commande locale (`command`, `args`, `env`) ; il n'accepte alors aucun des champs d'identification HTTP ci-dessus.

> [!NOTE]
>
> La page [serveurs MCP](https://docs.devinenterprise.com/fr/work-with-devin/mcp.md#configuration-format) décrit le formulaire Personnaliser pour un serveur autonome. Le serveur d'un module d’extension utilise les noms de champs ci-dessus, et son URL, son transport et ses en-têtes s'affichent en lecture seule sur la ligne de l'installation.

## Qui détient les informations d’identification

| Installé par | Titulaire des informations d’identification | Qui se connecte |
| - | - | - |
| Un membre (portée personnelle) | Ce membre | Le membre, depuis Personnaliser → MCPs |
| Une organisation | L’organisation (`Access: Organization`) ou chaque membre (`Access: Personal`) | Un administrateur d’organisation ou chaque membre |
| L’Enterprise | L’Enterprise (`Access: Enterprise`) ou chaque membre de chaque organisation (`Access: Personal`) | Un administrateur d’Enterprise ou chaque membre |

## Configurations

Chaque configuration associe une entrée de la déclaration ci-dessus à l’emplacement où le module d’extension est installé et à son mode de distribution : **Obligatoire** l’installe pour tous les utilisateurs du périmètre, **Proposé** permet à chaque organisation ou membre de l’installer. Ces deux options se définissent au niveau du module d’extension, dans [Personnaliser](https://docs.devinenterprise.com/fr/product-guides/plugins.md#mcps).

### OAuth par utilisateur pour tout le monde

Pour un serveur qui prend en charge OAuth, utilisez l’entrée `example-mcp` et installez le module d’extension avec le statut **Obligatoire** au niveau de l’Enterprise ou de l’organisation.

Avec `tokenScope: "user"`, Access est défini sur **Personnel** par défaut : chaque membre se connecte donc une seule fois, depuis Personnaliser → MCPs ou lors de la première session qui en a besoin.

### Un compte de service d’organisation

Utilisez l’entrée `example-mcp-service-account` et installez le module d’extension au niveau de l’organisation.

* L’en-tête `Authorization` contient un espace réservé ; la ligne affiche donc **Connect**. Un administrateur d’organisation saisit le token ; les membres ne le voient jamais.
* Si le serveur rejette le token (401), la ligne affiche **Check the information d’identification**. Si le serveur annonce également la prise en charge d’OAuth, la ligne propose en plus **Sign in with OAuth instead**.
* Pour un compte de service qui se connecte via OAuth, supprimez l’en-tête, définissez `tokenScope: "org"` et connectez l’identifiant de ce compte.

### Une clé par organisation

Placez l’entrée `example-mcp-service-account` dans un module d’extension Enterprise et définissez-le sur **Proposé aux organisations**.

* Chaque organisation qui l’installe est propriétaire de son installation : son administrateur renseigne donc `${EXAMPLE_MCP_SERVICE_ACCOUNT_TOKEN}` avec la clé de cette organisation.
* Aucune connexion n’est établie au niveau de l’Enterprise, et aucune organisation ne voit la clé d’une autre.
* À l’inverse, un module d’extension Enterprise **Obligatoire** crée une seule installation appartenant à l’Enterprise : une seule clé pour toutes les organisations.

### Les deux dans un seul module d’extension

Fournissez les deux entrées, comme dans la déclaration ci-dessus, puis proposez le module d’extension. Chaque organisation qui l’installe dispose alors de deux lignes : l’une à laquelle les membres se connectent individuellement, l’autre que l’administrateur d’organisation connecte. Grâce à des noms de serveur distincts, les skills du module d’extension peuvent indiquer quel serveur utiliser.


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