Skip to main content

Behavry Integration — Windsurf

Windsurf (by Codeium) supports MCP servers via ~/.codeium/windsurf/mcp_config.json. The configuration format uses the same mcpServers key as Cursor and Claude Code.

Prerequisites​

  • Behavry stack running (make dev or docker compose up)
  • Windsurf installed
  • Python 3.11+

Config File Location​

~/.codeium/windsurf/mcp_config.json

(Same path on macOS, Linux, and Windows.)

Quick Setup​

make setup

This detects Windsurf (checks ~/.codeium/windsurf/), provisions a windsurf-local agent, and merges the config into ~/.codeium/windsurf/mcp_config.json — all in one step.

To connect only Windsurf:

cd backend && poetry run python ../demos/setup/create_dev_agent.py --client windsurf

Verify​

  1. Open Windsurf → Cascade panel — the Behavry servers should be connected
  2. Ask Cascade to list or read files
  3. Check http://localhost:5173 → Live Activity for the event

Token Refresh​

Tokens expire in ~8 hours. Refresh all enrolled editors at once:

make tokens

Windsurf typically picks up config changes without a restart.

Troubleshooting​

MCP tools not available in Cascade

Confirm the config file exists and contains the correct structure:

cat ~/.codeium/windsurf/mcp_config.json

Servers showing as unavailable

Confirm the backend is up: curl http://localhost:8000/health

Token expired

Re-run python mcp_config.py --apply-windsurf.