Windsurf MCP Integration

Connect Your Team's Knowledge Base to Windsurf

Name: Contextium
Author: Contextium

Windsurf’s Cascade agent supports MCP. Connect Contextium and Cascade works from your team’s documented standards and project state — shared with every other AI tool your team runs.

Terminal

npx @contextium/mcp-server@latest setup

Get Started Free Full MCP Guide

Free plan available · 60-second setup · No credit card required

60s

Setup time

Command to run

Config files to maintain

∞

Docs Windsurf can access

How the Windsurf Integration Works

Build Your Knowledge Base in Contextium

Document what Cascade can’t infer: conventions, architecture decisions, API standards, project phases. One workspace, versioned and shared.

Coding standards and conventions
Architecture and design decisions
Project phases and tasks
API and infrastructure documentation

Add the MCP Server to Windsurf

Run the setup command, or register Contextium in Windsurf’s MCP configuration:

~/.codeium/windsurf/mcp_config.json

// ~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "contextium": {
      "command": "npx",
      "args": ["-y", "@contextium/mcp-server@latest"]
    }
  }
}

Cascade Works From Your Context

Cascade searches your Contextium workspace and grounds its plans and edits in your team’s actual knowledge — consistent with what every teammate’s tools see.

Relevant docs load into Cascade automatically
Same source of truth across editors and vendors
Memories stay personal; shared truth stays shared

Windsurf Memories Are Personal. Team Truth Isn’t.

Rules and memories steer one editor — your knowledge should reach them all.

Windsurf alone

✕Rules files maintained per project
✕Memories are per-user — teammates can’t inherit them
✕Knowledge stops at the editor boundary
✕Other tools (Claude Code, Copilot) see none of it

With Contextium

One knowledge base Cascade loads on demand
Every teammate’s Windsurf sees the same truth
Same context in Claude Code, Cursor, and Copilot
Versioned, with who-changed-what history

Built for Windsurf Teams

60-Second Setup

One command configures the MCP connection automatically. No JSON editing, no manual config.

Team-Wide Context

Every developer's AI gets the same knowledge base. Consistent assistance across the whole team.

Instant Updates

Update a doc in Contextium and it's live in every teammate's next session immediately.

Version Control

Full history for every doc with visual diffs and one-click rollback.

Private & Secure

Workspace-scoped MCP connections with OAuth 2.0. Access is gated by workspace roles.

Semantic Search

The AI finds the right docs for each query automatically — not just keyword matching.

Windsurf Integration — Common Questions

How do I connect Contextium to Windsurf?

Run npx @contextium/mcp-server@latest setup, or add the Contextium MCP server to ~/.codeium/windsurf/mcp_config.json under mcpServers. Cascade can then search and load your workspace context.

Does this replace Windsurf rules and memories?

No — it complements them. Keep rules for Windsurf-specific behaviour and let memories handle personal recall; Contextium carries the shared team knowledge every tool needs.

Can my Windsurf and Claude Code teammates share context?

Yes. Contextium serves the same workspace context to any MCP-compatible tool, so mixed-editor teams work from one source of truth.

Is the Windsurf integration free?

Yes. MCP integration is included in all Contextium plans, including the free plan.

Give Cascade Your Team’s Context

Free plan available. 60-second setup. No credit card required.

Start Free Full MCP Guide →