Windsurf Setup

Configure MCP for Codeium's Windsurf IDE to enable AI-assisted component management.

Automatic Setup (Recommended)

Run this single command to automatically configure Windsurf:

npx archyra init --client windsurf

If you prefer to configure manually, follow these steps:

1Locate your configuration file

Windsurf stores its MCP configuration at:

~/.codeium/windsurf/mcp_config.json

If the directory doesn't exist, create it first.

2Create the configuration file

Create the file with this content:

{
  "mcpServers": {
    "archyra": {
      "command": "npx",
      "args": ["-y", "archyra@latest", "serve"]
    }
  }
}

3Create directory if needed

If the directory doesn't exist, create it:

mkdir -p ~/.codeium/windsurf

4Restart Windsurf

Close and reopen Windsurf to load the new MCP configuration. The server will start automatically when Windsurf launches.

After restarting Windsurf, open the AI chat (Cascade) and try these prompts:

You

"List all archyra components"

You

"What UI components are available?"

You

"Add the DataProcessing component to my project"

If Cascade responds with component information, your setup is complete!

Problem

MCP server not connecting

Solution: Verify the mcp_config.json file exists at ~/.codeium/windsurf/mcp_config.json and contains valid JSON.

Problem

Cascade doesn't recognize MCP tools

Solution: Make sure you fully restarted Windsurf after adding the configuration (not just reloaded the window).

Problem

npx command fails

Solution: Ensure Node.js 18+ is installed and in your PATH. Run: node --version to check.

Problem

Directory doesn't exist

Solution: Create the directory manually: mkdir -p ~/.codeium/windsurf

Learn all available CLI commands

Explore all available components