Windsurf

Windsurf is Codeium's AI-powered IDE that supports MCP servers. Connect it to RouterMCP to enhance its AI capabilities with your tools.

Prerequisites

Windsurf installed
RouterMCP CLI installed or Cloud project configured

Setup with RouterMCP CLI

Open Windsurf Settings

Navigate to Settings → AI Features → MCP Servers

Add Stdio Server

Add a new server with these settings:

Setting	Value
Name	`routermcp`
Type	`stdio`
Command	`routermcp`
Working Directory	Path to your project

Configure and Save

Save the configuration and restart Windsurf if prompted.

Setup with RouterMCP Cloud

Open Settings

Navigate to Settings → AI Features → MCP Servers

Add HTTP Server

Setting	Value
Name	`routermcp`
Type	`http` or `streamable-http`
URL	`https://gateway.routermcp.com/v1/mcp/your-project/request`
Headers	`Authorization: Bearer your_api_key`

Test Connection

Use the AI assistant to verify tools are available.

Configuration File

Windsurf may store MCP configuration in its settings file. The format is similar to other editors:

{
  "mcp": {
    "servers": {
      "routermcp": {
        "type": "stdio",
        "command": "routermcp",
        "args": [],
        "cwd": "/path/to/project"
      }
    }
  }
}

For HTTP transport:

{
  "mcp": {
    "servers": {
      "routermcp": {
        "type": "streamable-http",
        "url": "https://gateway.routermcp.com/v1/mcp/my-project/request",
        "headers": {
          "Authorization": "Bearer rmc_your_key"
        }
      }
    }
  }
}

Troubleshooting

Server not responding?

Verify RouterMCP is installed: routermcp --version
Check the working directory has routermcp.jsonc
Test manually: cd /project && routermcp --http

Check Windsurf's documentation for the latest MCP configuration format, as it may vary between versions.

Windsurf IDE Integration with RouterMCP