Prerequisites
- Windsurf editor installed
- A Kavio account with an active trial or subscription (no card required to start)
Setup
1
Open the MCP configuration file
Edit No
~/.codeium/windsurf/mcp_config.json:Authorization header — Windsurf discovers OAuth from the URL.2
Reload Windsurf
Reload the window so Windsurf picks up the new configuration.
3
Sign in through your browser
The first time Cascade calls a Kavio tool, Windsurf opens a browser window for the Kavio sign-in. Approve the request and Cascade continues automatically.
4
Verify the connection
Open Cascade and ask:
Bearer token fallback
Bearer token fallback
If your environment blocks the OAuth callback, use a Personal Access Token instead:Create the key from Settings > API Keys on the Kavio dashboard.

