Windsurf MCP Config

Windsurf uses the same mcpServers JSON format as Claude Desktop. Follow this guide to add MCP servers to your Windsurf setup.

Config file location

  • macOS/Linux: ~/.codeium/windsurf/mcp_config.json
  • Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

Config format

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/you/projects"
      ]
    }
  }
}

Setup steps

  1. Open or create the config file at the path above.
  2. Add your servers inside the mcpServers object.
  3. Save and restart Windsurf.
  4. Open the MCP panel in Windsurf to confirm servers are listed.

Generate your Windsurf config

Use the builder and select "Windsurf" as the target app.

Open Config Builder →