MCP (Model Context Protocol) est un protocole qui permet aux LLM d’accéder à des outils et services personnalisés. Un client MCP (Cascade, dans ce cas) peut envoyer des requêtes à des serveurs MCP pour accéder aux outils qu’ils fournissent. Cascade s’intègre désormais nativement à MCP, ce qui vous permet d’utiliser votre propre sélection de serveurs MCP dans Cascade. Consultez la documentation officielle de MCP pour en savoir plus.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.
Ajouter un nouveau MCP
MCPs dans le menu en haut à droite du panneau Cascade, ou depuis
la section Windsurf Settings > Cascade > MCP Servers.
Si vous ne trouvez pas le MCP souhaité, vous pouvez l’ajouter manuellement en modifiant directement le fichier mcp_config.json.
Les MCP officiels s’affichent avec une coche bleue, indiquant qu’ils sont créés par l’entreprise à l’origine du service.
Lorsque vous cliquez sur un MCP, cliquez simplement sur Install pour rendre le serveur et ses outils accessibles à Cascade.
Installation en un clic via deeplink
- Avec
serverName: ouvre la page du registre MCP pour le serveur spécifié, où l’utilisateur peut le consulter et l’installer. - Sans
serverName: ouvre la page du MCP Marketplace.
windsurf://windsurf-mcp-registry?serverName=github-mcp-server ouvrira la page du registre du serveur MCP GitHub dans Devin Desktop.
stdio, Streamable HTTP et SSE.
Devin Desktop prend également en charge OAuth pour chaque type de transport.
Pour les serveurs http, l’URL doit correspondre à celle de l’endpoint et ressembler à https://<your-server-url>/mcp.

Configuration des outils MCP
MCPs dans le menu en haut à droite du
panneau Cascade, puis cliquez sur le MCP souhaité.

mcp_config.json
~/.codeium/windsurf/mcp_config.json est un fichier JSON qui contient une liste de serveurs auxquels Cascade peut se connecter.
Voici un exemple de configuration qui définit un seul serveur pour GitHub :
Exemples de serveurs MCP populaires
mcp_config.json.
GitHub
Gestion des dépôts, opérations sur les fichiers et intégration à l’API GitHub.
GitHub
Gestion des dépôts, opérations sur les fichiers et intégration à l’API GitHub.
Slack
Gestion des canaux et messagerie pour les espaces de travail Slack.
Slack
Gestion des canaux et messagerie pour les espaces de travail Slack.
- Créez une application Slack sur api.slack.com/apps
- Ajoutez les scopes OAuth requis (p. ex.
channels:read,chat:write,users:read) - Installez l’application dans votre espace de travail, puis copiez le Bot User OAuth Token
PostgreSQL
Accès en lecture seule à la base de données avec inspection du schéma.
PostgreSQL
Accès en lecture seule à la base de données avec inspection du schéma.
Filesystem
Opérations sécurisées sur les fichiers avec contrôles d’accès configurables.
Filesystem
Opérations sécurisées sur les fichiers avec contrôles d’accès configurables.
Brave Search
Recherche sur le Web et en local via l’API Search de Brave.
Brave Search
Recherche sur le Web et en local via l’API Search de Brave.
Memory
Système de mémoire persistante basé sur un graphe de connaissances.
Memory
Système de mémoire persistante basé sur un graphe de connaissances.
MCP HTTP distants
serverUrl ou url.
Voici un exemple de configuration pour un serveur HTTP :
Interpolation de configuration
~/.codeium/windsurf/mcp_config.json prend en charge l’interpolation de variables
dans les champs suivants : command, args, env, serverUrl, url et
headers. Cela vous permet d’éviter de coder en dur des secrets directement dans le fichier de configuration.
Deux motifs d’interpolation sont pris en charge :
${env:VAR_NAME}— remplacé par la valeur de la variable d’environnementVAR_NAME. Si la variable n’est pas définie, il est remplacé par une chaîne vide.${file:/path/to/file}— remplacé par le contenu du fichier au chemin indiqué, après suppression des espaces superflus en début et fin de contenu. Les chemins avec tilde (p. ex.~/secrets/key.txt) sont pris en charge. Si le fichier ne peut pas être lu, le motif reste inchangé.
headers :
Contrôles d’administration (Teams et Enterprise)
Registre MCP
Configuration de registres personnalisés
- Accédez aux paramètres de votre équipe
- Recherchez le paramètre MCP Registry URLs
- Ajoutez une ou plusieurs URL de registre
Liste d’autorisation MCP
MCP Team Settings
mcp_config.json de l’utilisateur.Comment fonctionne la correspondance des serveurs
- 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
Option 1 : configuration par défaut du Plugin Store (recommandée)
Laissez le champ Server Config (JSON) vide pour autoriser la configuration par défaut du Devin Desktop MCP Plugin Store.
Option 1 : configuration par défaut du Plugin Store (recommandée)
Laissez le champ Server Config (JSON) vide pour autoriser la configuration par défaut du Devin Desktop MCP Plugin Store.
- ID du serveur :
github-mcp-server - Server Config (JSON) : (laisser vide)
mcp_config.json) :Option 2 : configuration avec correspondance exacte
Fournissez la configuration exacte que les utilisateurs doivent utiliser. Les utilisateurs doivent respecter cette configuration à l’identique.
Option 2 : configuration avec correspondance exacte
Fournissez la configuration exacte que les utilisateurs doivent utiliser. Les utilisateurs doivent respecter cette configuration à l’identique.
- ID du serveur :
github-mcp-server - Server Config (JSON) :
mcp_config.json) :env peut contenir des valeurs différentes.Option 3 : motifs regex flexibles
Utilisez des motifs regex pour autoriser des variations dans les configurations utilisateur tout en maintenant les contrôles de sécurité.
Option 3 : motifs regex flexibles
Utilisez des motifs regex pour autoriser des variations dans les configurations utilisateur tout en maintenant les contrôles de sécurité.
- ID du serveur :
python-mcp-server - Server Config (JSON) :
mcp_config.json) :- La regex
/.*\\.pycorrespond à n’importe quel chemin de fichier Python, comme/home/user/my_server.py - La regex
[0-9]+correspond à n’importe quel port numérique, comme8080ou3000 - 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
envne fait pas l’objet d’une correspondance par regex et peut être configurée librement par les utilisateurs - Outils désactivés : le tableau
disabledToolsest 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
- Vérifier la correspondance exacte : assurez-vous que le motif de la liste d’autorisation correspond exactement à la configuration de l’utilisateur
- Vérifier l’échappement des regex : les caractères spéciaux peuvent devoir être échappés (p. ex.,
\.pour un point littéral) - Consulter les logs : les motifs regex non valides sont enregistrés avec un avertissement
- Tester les motifs : utilisez un testeur regex pour vérifier que vos motifs fonctionnent comme prévu
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, les ressources et les prompts d’un serveur MCP.
