Skip to main content
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: 
{
  "mcpServers": {
    "sevalla": {
      "serverUrl": "https://mcp.sevalla.com/mcp"
    }
  }
}
If you need API key auth instead of OAuth: 
{
  "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