Skip to main content

Behavry Integration — Windsurf

Windsurf (by Codeium) speaks MCP over Streamable HTTP via ~/.codeium/windsurf/mcp_config.json. It connects to Behavry's unified MCP gateway (/mcp/v1) with the agent's client credentials as an HTTP Basic header, using the same mcpServers shape as Cursor and Claude Desktop.

Prerequisites​

  • A running Behavry instance (your control-plane URL, or http://localhost:8000 for a local stack)
  • Windsurf installed
  • An enrolled agent (gives you the client_id / client_secret)

1. Enroll the agent​

In the dashboard: Agents → Enroll Agent → Windsurf. Behavry provisions the agent and gives you a one-line installer command that patches the config, plus the raw block below.

2. Config file location​

~/.codeium/windsurf/mcp_config.json

3. Config block​

Merge under the mcpServers key:

{
  "mcpServers": {
    "behavry": {
      "url": "https://<your-behavry-host>/mcp/v1",
      "headers": {
        "Authorization": "Basic <base64(client_id:client_secret)>"
      }
    }
  }
}

Verify​

  1. Open Windsurf → Cascade panel — behavry should be connected
  2. Ask Cascade to list or read files
  3. The tool call appears in the dashboard → Live Activity

Troubleshooting​

MCP tools not available in Cascade — Confirm the config file exists and contains the mcpServers.behavry entry with a url ending in /mcp/v1:

cat ~/.codeium/windsurf/mcp_config.json

Server unavailable — Check the backend: curl https://<your-behavry-host>/health.

401 Unauthorized — Credentials wrong or agent revoked. Re-enroll and paste the fresh block.