Cómo añadir servidores MCP a Windsurf (mcp_config.json)

Configura servidores MCP locales y remotos para el agente Cascade de Windsurf en mcp_config.json: ubicación del archivo, serverUrl para servidores remotos y cómo desactivar herramientas.

1. Abre mcp_config.json

En el panel de Cascade, haz clic en el menú … (Actions) arriba a la derecha y elige Open MCP config file en la sección MCPs. Según la documentación actual, el archivo está en ~/.config/devin/mcp_config.json en macOS y Linux y en %APPDATA%\devin\mcp_config.json en Windows (Windsurf forma ahora parte de Devin Desktop; las versiones anteriores de Windsurf usaban ~/.codeium/windsurf/mcp_config.json). Si lo abres desde el menú, siempre obtendrás el archivo correcto.

2. Añade un servidor local (stdio)

Añade una entrada en mcpServers, con la misma forma que usan Claude Desktop y Cursor:

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

3. Añade un servidor remoto

Los servidores HTTP remotos usan serverUrl (o url) en lugar de un comando. Ejemplo con el servidor gratuito de Socketlist:

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

Añade un objeto headers si el servidor necesita una clave de API.

4. Saca los secretos del archivo

La configuración admite ${env:VAR_NAME} y ${file:/path/to/file} en command, args, env, serverUrl, url y headers.

5. Activa o desactiva servidores y herramientas

La sección MCPs del menú Actions muestra cada servidor con un interruptor. Para ocultar herramientas concretas, añade "disabledTools": ["tool_name"] a la entrada del servidor. Cascade puede usar como máximo 100 herramientas a la vez.

Notas

Esto se aplica al agente Cascade. El agente más reciente, Devin Local, guarda los servidores MCP en la configuración de Devin CLI. Fuente: la documentación oficial de MCP de Cascade.