/mcp",
"headers": {
"API_KEY": "Bearer ${env:AUTH_TOKEN}"
}
}
}
}
```
Voici un exemple montrant comment lire une API key à partir d’un fichier :
```json theme={null}
{
"mcpServers": {
"my-server": {
"command": "node",
"args": ["server.js"],
"env": {
"API_KEY": "${file:~/.secrets/api_key.txt}"
}
}
}
}
```
## Contrôles d’administration (Teams et Enterprise)
Les administrateurs d’une Team peuvent activer ou désactiver l’accès MCP pour leur Team, ainsi qu’autoriser, via une liste d’autorisation, les serveurs MCP approuvés que leur Team peut utiliser :
### Registre MCP
Les Teams Enterprise peuvent configurer des registres MCP personnalisés pour remplacer la MCP Marketplace par défaut de Devin Desktop utilisée par le [Local Agent de Devin](/fr/desktop/devin-local). Les Teams peuvent associer les URL de leurs propres registres pour contrôler quels MCP sont accessibles à leurs utilisateurs. Cascade ne dispose d’aucune marketplace : les registres ne modifient donc pas ce que voient les utilisateurs de Cascade ; utilisez la [liste d’autorisation MCP](#mcp-allowlist) pour restreindre les serveurs Cascade.
Les registres sont l’approche privilégiée pour gérer l’accès aux MCP, même si les listes d’autorisation fonctionnent également.
#### Configuration de registres personnalisés
1. Accédez aux paramètres de votre équipe
2. Recherchez le paramètre **MCP Registry URLs**
3. Ajoutez une ou plusieurs URL de registre
Lorsque plusieurs URL de registre sont configurées, Devin Desktop utilise l’**union** de tous les registres : les utilisateurs voient les MCP de toutes les sources configurées, regroupés en un seul ensemble. Le marketplace MCP de l’équipe récupère alors les données depuis ces registres internes plutôt que depuis le registre Devin Desktop par défaut.
Les registres personnalisés doivent respecter le [schéma officiel du registre MCP](https://modelcontextprotocol.io/). Cela garantit la compatibilité et des définitions de serveur normalisées.
### Liste d’autorisation MCP
Paramètres MCP configurables pour votre Team.
Le lien ci-dessus ne fonctionnera que si vous disposez des droits d’administration pour votre Team.
Par défaut, les utilisateurs d’une Team peuvent configurer leurs propres serveurs MCP. Cependant, dès que vous ajoutez ne serait-ce qu’un seul serveur MCP à la liste d’autorisation, **tous les serveurs qui n’y figurent pas seront bloqués** pour votre Team.
L’ID du serveur dans la liste d’autorisation doit correspondre exactement, en respectant la casse, au nom de clé utilisé dans le `mcp_config.json` de l’utilisateur.
### Comment fonctionne la correspondance des serveurs
Lorsque vous placez un serveur MCP sur la liste d’autorisation, le système utilise la **correspondance par motifs regex** selon les règles suivantes :
* **Correspondance sur l’intégralité de la chaîne** : tous les motifs sont automatiquement ancrés (entourés de `^(?:pattern)$`) afin d’empêcher les correspondances partielles
* **Champ de commande** : doit correspondre exactement ou selon votre motif regex
* **Tableau d’arguments** : chaque argument est comparé individuellement au motif correspondant
* **Longueur du tableau** : le nombre d’arguments doit correspondre exactement entre la liste d’autorisation et la configuration de l’utilisateur
* **Caractères spéciaux** : des caractères comme `$`, `.`, `[`, `]`, `(`, `)` ont une signification particulière en regex et doivent être échappés avec `\` si vous voulez une correspondance littérale
### Options de configuration
**Configuration de la liste d’autorisation Admin :**
* **ID du serveur :** `github-mcp-server`
* **Server Config (JSON) :** *(laisser vide)*
```json theme={null}
{}
```
**Configuration utilisateur correspondante (`mcp_config.json`) :**
```json theme={null}
{
"mcpServers": {
"github-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GITHUB_PERSONAL_ACCESS_TOKEN",
"ghcr.io/github/github-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
}
}
}
}
```
Cela permet aux utilisateurs d’installer le serveur MCP GitHub avec toute configuration valide, à condition que l’ID du serveur corresponde.
**Configuration de la liste d’autorisation Admin :**
* **ID du serveur :** `github-mcp-server`
* **Server Config (JSON) :**
```json theme={null}
{
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GITHUB_PERSONAL_ACCESS_TOKEN",
"ghcr.io/github/github-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": ""
}
}
```
**Configuration utilisateur correspondante (`mcp_config.json`) :**
```json theme={null}
{
"mcpServers": {
"github-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GITHUB_PERSONAL_ACCESS_TOKEN",
"ghcr.io/github/github-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
}
}
}
}
```
Les utilisateurs doivent utiliser cette configuration exacte : tout écart dans la commande ou les arguments sera bloqué. La section `env` peut contenir des valeurs différentes.
**Configuration de la liste d’autorisation Admin :**
* **ID du serveur :** `python-mcp-server`
* **Server Config (JSON) :**
```json theme={null}
{
"command": "python3",
"args": ["/.*\\.py", "--port", "[0-9]+"]
}
```
**Configuration utilisateur correspondante (`mcp_config.json`) :**
```json theme={null}
{
"mcpServers": {
"python-mcp-server": {
"command": "python3",
"args": ["/home/user/my_server.py", "--port", "8080"],
"env": {
"PYTHONPATH": "/home/user/mcp"
}
}
}
}
```
Cet exemple offre de la flexibilité aux utilisateurs tout en maintenant la sécurité :
* La regex `/.*\\.py` correspond à n’importe quel chemin de fichier Python, comme `/home/user/my_server.py`
* La regex `[0-9]+` correspond à n’importe quel port numérique, comme `8080` ou `3000`
* Les utilisateurs peuvent personnaliser les chemins de fichier et les ports, tandis que les admins s’assurent que seuls des scripts Python sont exécutés
### Motifs regex courants
| Pattern | Correspond à | Exemple |
| - | - | - |
| `.*` | N’importe quelle chaîne | `/home/user/script.py` |
| `[0-9]+` | N’importe quel nombre | `8080`, `3000` |
| `[a-zA-Z0-9_]+` | Caractères alphanumériques + underscore | `api_key_123` |
| `\\$HOME` | `$HOME` littéral | `$HOME` (non étendu) |
| `\\.py` | `.py` littéral | `script.py` |
| `\\[cli\\]` | `[cli]` littéral | `mcp[cli]` |
## Notes
### Consignes de configuration pour les administrateurs
* **Variables d’environnement** : la section `env` ne fait pas l’objet d’une correspondance par regex et peut être configurée librement par les utilisateurs
* **Outils désactivés** : le tableau `disabledTools` est traité séparément et ne fait pas partie de la correspondance avec la liste d’autorisation
* **Sensibilité à la casse** : toute correspondance est sensible à la casse
* **Gestion des erreurs** : les motifs regex non valides seront consignés dans les journaux et entraîneront un refus d’accès
* **Tests** : testez soigneusement vos motifs regex - des motifs trop restrictifs peuvent bloquer des cas d’usage légitimes
### Dépannage
Si des utilisateurs signalent que leurs serveurs MCP ne fonctionnent pas après leur ajout à la liste d’autorisation :
1. **Vérifier la correspondance exacte** : assurez-vous que le motif de la liste d’autorisation correspond exactement à la configuration de l’utilisateur
2. **Vérifier l’échappement des regex** : les caractères spéciaux peuvent devoir être échappés (p. ex., `\.` pour un point littéral)
3. **Consulter les logs** : les motifs regex non valides sont enregistrés avec un avertissement
4. **Tester les motifs** : utilisez un testeur regex pour vérifier que vos motifs fonctionnent comme prévu
N’oubliez pas : dès que vous ajoutez un serveur à la liste d’autorisation, **tous les autres serveurs sont automatiquement bloqués** pour les membres de votre Team.
### Informations générales
* Comme les appels d’outils MCP peuvent invoquer du code écrit par n’importe quel implémenteur de serveur, nous déclinons toute responsabilité
en cas d’échec des appels d’outils MCP. En d’autres termes :
* Nous prenons actuellement en charge les [outils](https://modelcontextprotocol.io/docs/concepts/tools), les [ressources](https://modelcontextprotocol.io/docs/concepts/resources) et les [prompts](https://modelcontextprotocol.io/docs/concepts/prompts) d’un serveur MCP.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.