Windsurf
Windsurf is an AI code editor and it has MCP support.
Steps
- Install Windsurf
- Open it up and create your account
- Go to
Windsurf
->Settings
->Windsurf Settings
(on Mac, hitcmd+,
) - Select
Cascade
, and find the "View raw config" button, as seen at the bottom of this screenshot: - 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.
- Save the file.
- Open
Cascade
view and toggle fromWrite
toChat
(small toggle on bottom of input) - 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:
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.
- 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.