Skip to main content

Windsurf

Windsurf is an AI code editor and it has MCP support.

Steps

  1. Install Windsurf
  2. Open it up and create your account
  3. Go to Windsurf -> Settings -> Windsurf Settings (on Mac, hit cmd+,)
  4. Select Cascade, and find the "View raw config" button, as seen at the bottom of this screenshot: Windsurf Cascade MCP Config button
  5. This will drop you into an editor of the JSON config. Fill in a value for the key mcpx:
{
"mcpServers": {
"mcpx": {
"serverUrl": "https://www.mcp.run/api/mcp/sse?nonce=...."
}
}
}

You can use any Profile SSE URL here. You can add multiple too, just create new Profiles in your mcp.run Settings, and copy the SSE URL generated into this serverUrl field.

preserve existing servers

If there are any existing keys under mcpServer, don't delete them. Add mcpx to the end.

  1. Save the file.
  2. Open Cascade view and toggle from Write to Chat (small toggle on bottom of input)
  3. If everything is configured properly, you should see a small hammer icon, and clicking it should show you the configured, available MCP Servers and tool count next to a green dot. If you see something like this: Windsurf Cascade MCP Error - too many tools

You will need to remove some MCP servers installed into your mcp.run Profile. Windsurf limits how many tools within servers can be active at any moment.

  1. You're done! You can now use tools.
Up to date instructions

If you get stuck, please refer to Windsurf's guide as it should remain up to date.