Windsurf Integration Guide

Windsurf is an agentic AI coding IDE developed by Codeium. Like Cursor, it supports MCP configurations, letting you hook up Proxima's 50+ local tools to the Windsurf Cascade panel and AI workflows.

1. Editor Configuration File Setup

To configure Proxima inside Windsurf, you must append it to Windsurf's global MCP settings file, mcp_config.json:

File Path Locations

# Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json # macOS: ~/.codeium/windsurf/mcp_config.json # Linux: ~/.codeium/windsurf/mcp_config.json

JSON Configuration Block

Open the file in a text editor (or inside Windsurf itself) and paste the following server declaration:

{ "mcpServers": { "proxima": { "command": "node", "args": [ "C:/path/to/proxima/src/mcp/index.js" ] } } }

Note: Make sure you replace C:/path/to/proxima with the exact absolute directory path where your local Proxima server resides.

2. Activating in Windsurf Cascade

After saving the mcp_config.json file, follow these steps to verify connection in the editor:

1 Restart Windsurf or reload the active window (Ctrl+R or Cmd+R).

2 Open the **Cascade** chat panel on the right side.

3 Check the Cascade settings or connection icon. If successful, you will see a badge showing the active `proxima` MCP server.

4 Cascade can now call any Proxima tool automatically to help you answer prompts or write files.