Skip to content

Windsurf

Windsurf Setup

Windsurf is an AI-powered code editor that supports MCP servers.

How to Find the Configuration File

The configuration file location depends on your operating system:

Windows

Using PowerShell: 

notepad "$env:APPDATA\Windsurf\mcp.json"

Manual Navigation: 1. Press Win + R 2. Type: %APPDATA%\Windsurf 3. Press Enter 4. Create mcp.json if it doesn't exist

macOS

Using Terminal: 

open -a TextEdit ~/Library/Application\ Support/Windsurf/mcp.json

Manual Navigation: 1. Open Finder 2. Press Cmd + Shift + G 3. Paste: ~/Library/Application Support/Windsurf 4. Create mcp.json if it doesn't exist

Linux

Using Terminal: 

nano ~/.config/Windsurf/mcp.json

Manual Navigation: 1. Open file manager 2. Navigate to: ~/.config/Windsurf 3. Create mcp.json if it doesn't exist

Configuration

Add the following configuration to your Windsurf MCP settings file:

{
  "mcpServers": {
    "akashic-mcp": {
      "serverUrl": "https://akashic-mcp.com/mcp"
    }
  }
}

Configure your MCP token in the client (e.g. Authorization: Bearer).

Steps

  1. Locate or create the configuration file at the path above
  2. Add the configuration JSON
  3. Configure your MCP token (Bearer) in the client
  4. Save the file
  5. Restart Windsurf completely
  6. Authenticate when prompted on first tool use

Troubleshooting

  • Configuration not loading: Check JSON syntax and file location
  • Connection issues: Verify the endpoint URL is accessible
  • Authentication required: Complete the OAuth flow when prompted