Getting Started

Getting Started with Windsurf

Learn how to set up Windsurf and integrate it with MCP servers for enhanced functionality.

1. Install Windsurf

To get started, download Windsurf from the official website:

Follow the installation instructions for your operating system (macOS or Windows). If you already have Windsurf installed, make sure it's updated to the latest version.

2. Prerequisites

Before configuring the server, make sure you have Node.js installed on your system. To verify, open your terminal and run:

node --version

If Node.js is not installed, download it from nodejs.org

3. Configure the Server

To add our custom server functionality to Windsurf:

Open the Windsurf menu and select "Settings…" > "Windsurf Settings"
Click on "Cascade" in the left-hand bar and click on "Add Server" to configure a new MCP server
Click on "Add custom server"

This will create a configuration file at:

macOS:~/.codeium/windsurf/mcp_config.json

Windows:\.codeium\windsurf\mcp_config.json

If you don't already have this file, it will be created automatically and opened in your system's default text editor.

Open the configuration file in any text editor and replace its contents with the following:

{
  "mcpServers": {
    "tooldeck": {
      "serverUrl": "http://localhost:3000/servers/cm9x8da160001gftdbvph59rb/sse?token=cbbbe259-2164-4bf8-b73f-2662938af906"
    }
  }
}

Note: Replace "http://localhost:3000/servers/cm9x8da160001gftdbvph59rb/sse?token=cbbbe259-2164-4bf8-b73f-2662938af906" with the actual path to your servers page.

If you don't have a server, you can create one by visting tooldeck.io/servers