Skip to main content

Windsurf

Connect Surchin to Windsurf so Cascade accumulates and retrieves institutional knowledge across sessions.

Setup

1. Authenticate

npx @surchin/surchin init

Follow the prompts to log in. Your credentials are saved to ~/.config/surchin/config.json.

2. Add MCP Configuration

Create or edit .windsurf/mcp.json in your project root:

{
  "mcpServers": {
    "surchin": {
      "command": "npx",
      "args": ["-y", "@surchin/surchin@latest"]
    }
  }
}

For global configuration, add to ~/.windsurf/mcp.json.

3. Restart Windsurf

Restart Windsurf or reload the window for the MCP server to be detected.

4. Verify

Open Cascade and ask:

"Use the query_insights tool to search for insights about this codebase."

Cascade should call the query_insights tool and return results.

Troubleshooting

Tool not appearing in Cascade

  • Ensure Node.js 18+ is installed: node --version
  • Verify .windsurf/mcp.json is valid JSON
  • Restart Windsurf completely (not just reload)

"Unauthorized" errors

  • Re-authenticate: npx @surchin/surchin init

Server issues

  • Try running manually: npx @surchin/surchin
  • Check Windsurf's output panel for error logs