How to Add an MCP to Windsurf IDE

A step-by-step guide on adding MCP settings to your Windsurf IDE for better functionality.

Sat Mar 29 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

BrowserTools MCP REPOSITORY Link

Codeium Cascade MCP Documentation

The BrowserTools MCP can enable the AI to read your console error messages, allowing it to fix them without the need to copy and paste error messages from the browser developer tools. This has significantly saved me time debugging.

How to Add an MCP to Windsurf IDE

Enhance your Windsurf IDE experience by following this step-by-step guide to configure your MCP settings.

Step 1: Open Windsurf IDE

  • Launch the Windsurf IDE application on your device.

Step 2: Access Settings

  • Click on Settings in the top menu.

Step 3: Navigate to Windsurf Settings

  • From the settings dropdown menu, click on Windsurf Settings.

Windsurf Settings

Step 4: Add MCP Server

  • Locate and click on the Add Custom Server+ button as shown below.

Add MCP Server

Step 5: Update mcp_config.json

  • Open your mcp_config.json file and copy and paste the following code into it:
{
  "mcpServers": {
    "browser-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@agentdeskai/browser-tools-mcp@1.0.11"
      ]
    }
  }
}

Step 6: Test MCP Functionality

  • Ask Windsurf if it can read your console log error messages. You should receive a response of YES.