> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sevalla.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Windsurf

> Connect Windsurf to the Sevalla MCP server using the MCP UI or manual JSON configuration.

Use this guide to connect Windsurf to the Sevalla MCP server at `https://mcp.sevalla.com/mcp`.

After setup, Cascade can call Sevalla MCP tools like `search` and `execute`.

## Quick setup (MCP UI + OAuth)

OAuth is the recommended authentication method.

Windsurf does not currently provide a dedicated MCP CLI flow. Use the MCP UI for the fastest setup:

1. Open Cascade and click the **MCPs** icon.
2. Add a new custom MCP server.
3. Set:
   * Name: `sevalla`
   * URL: `https://mcp.sevalla.com/mcp`
4. Click install, then complete the browser OAuth flow when prompted.

## Manual configuration (`mcp_config.json`)

Edit `~/.codeium/windsurf/mcp_config.json`:

```json theme={null}
{
  "mcpServers": {
    "sevalla": {
      "serverUrl": "https://mcp.sevalla.com/mcp"
    }
  }
}
```

If you need API key auth instead of OAuth:

```json theme={null}
{
  "mcpServers": {
    "sevalla": {
      "serverUrl": "https://mcp.sevalla.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SEVALLA_API_KEY}"
      }
    }
  }
}
```

## Configuration scope

Windsurf MCP configuration is user-level through `~/.codeium/windsurf/mcp_config.json`.

If your team uses Windsurf admin allowlists, server entries must also match team policy.

## Uninstall

Delete the `sevalla` entry from `~/.codeium/windsurf/mcp_config.json`.

## Reference

* Sevalla MCP endpoint: `https://mcp.sevalla.com/mcp`
* Sevalla MCP repository: [github.com/sevalla-hosting/mcp](https://github.com/sevalla-hosting/mcp)