Windsurf

View Source

You can use Tidewave with Windsurf. First, you must install a mcp-proxy.

Once you are done, open up your "Windsurf Settings", find the "Cascade" section, click "Add Server" and then "Add custom server". A file will open up and you can manually add Tidewave:

MCP Proxy

On macos/Linux:

{
  "mcpServers": {
    "tidewave": {
      "command": "/path/to/mcp-proxy",
      "args": ["http://localhost:$PORT/tidewave/mcp"]
    }
  }
}

On Windows:

{
  "mcpServers": {
    "tidewave": {
      "command": "/path/to/mcp-proxy.exe",
      "args": ["http://localhost:$PORT/tidewave/mcp"]
    }
  }
}

Where $PORT is the port your web application is running on.

SSE connection

Windsurf also supports MCP servers through SSE:

{
  "mcpServers": {
    "tidewave": {
      "serverUrl": "http://localhost:4000/tidewave/mcp"
    }
  }
}

Note, if you restart your dev server, you will need to refresh the MCP connection.

And you are good to go! Now Windsurf will list all tools from Tidewave available. If your application uses a SQL database, you can verify it all works by asking it to run SELECT 1 as database query. If it fails, check out our Troubleshooting guide or Windsurf's official docs.