Skip to main content

​
Quick Install

uvx zenable-mcp install windsurf --global
Requires UV. See the CLI command reference for more options.
That’s it! You’re all set. Restart Windsurf and start using Zenable’s conformance checking in your AI coding assistant. This installs both the MCP server and Windsurf hooks for real-time code checking.
The below is a minimal example which may need to be merged with your existing configuration. Consider using the quick install command to handle this automatically.
Place the following configuration:
{
  "mcpServers": {
    "zenable": {
      "serverUrl": "https://mcp.zenable.app/"
    }
  }
}
In this file location:
~/.codeium/windsurf/mcp_config.json
We only recommend this manual approach if your host doesn’t have uv or uvx installed and you’d like to avoid installing it. Otherwise, the installer is much safer and can handle configuration upgrades over time, handles merges with existing configs, performs backups and logging in case of issues, and more.
Hooks run automatically after file writes to check for conformance issues. The quick install command sets this up for you.
Place the following configuration in .windsurf/hooks.json (project) or ~/.codeium/windsurf/hooks.json (global):
{
  "hooks": {
    "post_write_code": [
      {
        "command": "uvx zenable-mcp@latest hook",
        "show_output": true
      }
    ]
  }
}
This uses Windsurf’s post_write_code hook to run conformance checks after each file write made by Cascade.