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:

HTTP connection

Windsurf also supports MCP servers through HTTP:

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

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

MCP Proxy

See the MCP proxy documentation.

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.

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 MCP Troubleshooting guide or Windsurf's official docs.