Connect Windsurf

Windsurf uses the same direct-endpoint MCP configuration as other Cascade-style clients. Add the URL entry and reload.

TransportStreamable HTTPConfigWindsurf MCP settings

How do I connect an MCP server to Windsurf?

Add the server URL under Settings → Cascade → MCP servers and refresh the server list. Windsurf connects to remote MCP endpoints directly over streamable HTTP, so no local bridge is required.

Setup

Open Windsurf → Settings → Cascade → MCP servers.
Add the entry below with your deployment URL.
Refresh the MCP server list in Windsurf.

Windsurf MCP settingsjson

{
  "mcpServers": {
    "my-server": {
      "url": "https://my-server.mcp.cloud/mcp"
    }
  }
}

Verify the connection

Open the MCP servers panel and confirm the server connects without errors.

Troubleshooting

Server stuck connecting.

Confirm the URL is reachable in a browser and ends in `/mcp`.

Windsurf MCP documentation

Connect another client

CLI

Claude Code

Add your MCP server to Claude Code from the terminal.

Desktop

Claude Desktop

Connect Claude Desktop to a remote MCP server over a stdio bridge.

Editor

Cursor

Point Cursor at a remote MCP server.

Editor

VS Code

Add a remote MCP server to VS Code.

Editor

Antigravity

Add a remote MCP server to Antigravity.

CLI

Codex

Add a remote MCP server to the Codex CLI and IDE extension.

Web

ChatGPT

Add your MCP server to ChatGPT as a custom connector.

CLI

Gemini CLI

Add a remote MCP server to the Gemini CLI.