Client Configuration Guide

How to Configure MCP in Windsurf

Windsurf / Cascade MCP setup. The legacy file layout below has not been revalidated against the redirected vendor documentation.

Client config-copy leaderboard
Official Windsurf Docs

macOS

~/.codeium/windsurf/mcp_config.json

Windows

%USERPROFILE%\.codeium\windsurf\mcp_config.json

Linux

~/.codeium/windsurf/mcp_config.json

Setup and verification

Configuration: mcp_config.json / mcpServers / JSON

Current file layout not independently revalidated. Consult the vendor documentation for your installed version.

  1. Open the MCP settings in your installed Windsurf version and follow its current vendor instructions.

Legacy reference only: mcp_config.json and these paths are not a current compatibility certification. No newly reviewed Windsurf templates are published here.

Review every command and requested permission. Merge only the relevant server entries; do not overwrite unrelated settings. Keep credentials out of version control.

Reviewed configurations for Windsurf

0 servers with a documentation-reviewed configuration for at least one platform. Check the platform selector before copying.

No reviewed configurations for this client are published yet. Other clients' server lists are not evidence of compatibility. Use the official setup guide.

Windsurf config-copy leaderboard

Config copies (30d). 0 of 0 matching entries have evidence. Showing up to 10; equal values use title and slug as stable tie-breakers.

View full leaderboard

Only successful clipboard reports for this exact client count. These approximate 30-day site interactions are not installations, unique users or security reviews.

No measured rankings yet. No synthetic scores are substituted.

Measurement and privacy details