Save the file and reload Windsurf. A remote server uses serverUrl. A field named url is ignored.
Hosted server
Streamable HTTP
{
"mcpServers": {
"mcp-reference-server": {
"serverUrl": "https://your-app.onrender.com/mcp"
}
}
}
Local npx
stdio. Windsurf does not document a working directory, so npx is the entry that does not depend on one.
{
"mcpServers": {
"mcp-reference-server": {
"command": "npx",
"args": ["-y", "mcp-reference-server"],
"env": { "MCP_MODE": "stdio" }
}
}
}
Code Engine uses the hosted block with https://your-app.xxxx.ca-tor.codeengine.appdomain.cloud/mcp.