Ajouter des serveurs MCP à Windsurf (mcp_config.json)

Configurez des serveurs MCP locaux et distants pour l’agent Cascade de Windsurf dans mcp_config.json : emplacement du fichier, serverUrl pour les serveurs distants et désactivation d’outils.

1. Ouvrir mcp_config.json

Dans le panneau Cascade, cliquez sur le menu … (Actions) en haut à droite et choisissez Open MCP config file dans la section MCPs. D’après la documentation actuelle, le fichier se trouve dans ~/.config/devin/mcp_config.json sous macOS et Linux et dans %APPDATA%\devin\mcp_config.json sous Windows (Windsurf fait désormais partie de Devin Desktop ; les anciennes versions utilisaient ~/.codeium/windsurf/mcp_config.json). En passant par le menu, vous ouvrez toujours le bon fichier.

2. Ajouter un serveur local (stdio)

Ajoutez une entrée sous mcpServers, au même format que Claude Desktop et Cursor :

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

3. Ajouter un serveur distant

Les serveurs HTTP distants utilisent serverUrl (ou url) au lieu d’une commande. Exemple avec le serveur gratuit de Socketlist :

{
  "mcpServers": {
    "socketlist": {
      "serverUrl": "https://socketlist.pages.dev/mcp"
    }
  }
}

Ajoutez un objet headers si le serveur exige une clé d’API.

4. Garder les secrets hors du fichier

La configuration accepte ${env:VAR_NAME} et ${file:/path/to/file} dans command, args, env, serverUrl, url et headers.

5. Activer ou désactiver serveurs et outils

La section MCPs du menu Actions liste chaque serveur avec un interrupteur. Pour masquer des outils précis, ajoutez "disabledTools": ["tool_name"] à l’entrée du serveur. Cascade peut utiliser au maximum 100 outils à la fois.

Remarques

Ceci concerne l’agent Cascade. Le nouvel agent Devin Local enregistre les serveurs MCP dans la configuration de Devin CLI. Source : la documentation MCP officielle de Cascade.