MCP (Model Context Protocol) est un protocole qui permet aux LLM d’accéder à des outils et services personnalisés. Un client MCP (Cascade, ici) 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 les serveurs MCP de votre choix avec Cascade. Consultez la documentation officielle du MCP pour plus d’informations.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.
Ajouter un nouveau plugin MCP
Settings > Tools > Windsurf Settings > Add Server.
Si vous ne trouvez pas le plugin MCP souhaité, vous pouvez l’ajouter manuellement en cliquant sur le bouton View Raw Config, puis en modifiant le fichier mcp_config.json.
Lorsque vous sélectionnez un serveur MCP, cliquez simplement sur + Add Server pour exposer le serveur et ses outils à Cascade.

stdio, Streamable HTTP et SSE.
Cascade 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.
mcp_config.json
~/.codeium/mcp_config.json est un fichier JSON contenant une liste de serveurs auxquels Cascade peut se connecter.
Voici un exemple de configuration qui définit un seul serveur pour GitHub :
MCP HTTP distants
serverUrl ou url.
Voici un exemple de configuration pour un serveur HTTP :
Interpolation de configuration
~/.codeium/mcp_config.json gère l’interpolation des
variables d’environnement dans les champs suivants : command, args, env, serverUrl, url et
headers.
Voici un exemple de configuration qui utilise une variable d’environnement AUTH_TOKEN
dans headers.
Contrôles d’administration (Teams & Enterprises)
MCP Team Settings
Fonctionnement de la correspondance des serveurs
- Correspondance sur la chaîne entière : tous les motifs sont automatiquement ancrés (encadrés par
^(?: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 à son motif correspondant
- Longueur du tableau : le nombre d’arguments doit correspondre exactement entre la liste d’autorisation et la configuration 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 Windsurf 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 Windsurf 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 la respecter à l’identique.
Option 2 : configuration avec correspondance exacte
Fournissez la configuration exacte que les utilisateurs doivent utiliser. Les utilisateurs doivent la respecter à l’identique.
- ID du serveur :
github-mcp-server - Server Config (JSON) :
mcp_config.json) :command ou args sera bloqué. La section 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 conservant des contrôles de sécurité.
Option 3 : motifs regex flexibles
Utilisez des motifs regex pour autoriser des variations dans les configurations utilisateur tout en conservant des 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 fichiers et les ports, tandis que les admins veillent à ce que seuls des scripts Python soient 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_]+ | Alphanumérique + trait de soulignement | api_key_123 |
\\$HOME | $HOME littéral | $HOME (non développé) |
\\.py | .py littéral | script.py |
\\[cli\\] | [cli] littéral | mcp[cli] |
Remarques
Consignes de configuration d’administration
- Variables d’environnement : la section
envn’est pas comparée via des expressions régulières 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 blanche - Sensibilité à la casse : toute correspondance tient compte de la casse
- Gestion des erreurs : les motifs regex non valides seront consignés et entraîneront un refus d’accès
- Tests : testez soigneusement vos motifs regex - des motifs trop restrictifs peuvent bloquer des cas d’utilisation légitimes
Dépannage
- Vérifier la correspondance exacte : assurez-vous que le motif de la liste blanche correspond exactement à la configuration de l’utilisateur
- Vérifier l’échappement des expressions régulières : les caractères spéciaux peuvent devoir être échappés (p. ex.,
\.pour les points littéraux) - Consulter les logs : les motifs regex non valides sont consignés avec des avertissements
- Tester les motifs : utilisez un testeur regex pour vérifier que vos motifs fonctionnent comme prévu
