How Do I Install An MCP Server In Windsurf?

The UI path is the least error-prone for most users because Windsurf surfaces the server settings and auth flow. The raw-file path is better when you want to version or inspect the configuration directly.

{
  "mcpServers": {
    "aescut": {
      "command": "npx",
      "args": ["-y", "@aeptus/aescut", "--skip-install"]
    }
  }
}

Windsurf’s current docs explicitly note that Cascade is limited to one hundred accessible tools at a time. That makes tool curation part of installation. If you add several servers indiscriminately, the agent experience degrades before you notice the security implications.

Windsurf supports stdio, Streamable HTTP, and SSE, and the docs note OAuth support across those transports. That is useful when you want a hosted server rather than a local process, but it also means the server may be receiving account-scoped data far beyond your current repository.