Windsurf

Last updated: April, 2026

TL;DR Edit one JSON file, restart Windsurf, OAuth on first use.

Prerequisites

• Windsurf installed

• Personal Access Token created on the Memory Studio

Setup

For remote http mcp connections, windsurf only allows with Personal Access Tokens (PATs).

Read more here on how to create one from Memory Studio.

1. Edit (or create) the raw mcp config file

   • macOS: ~/.codeium/windsurf/mcp_config.json

   • Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

{
  "mcpServers": {
    "plurality-memory": {
      "disabled": false,
      "headers": {
        "Authorization": "Bearer plur_pat_xxx"
      },
      "serverUrl": "https://app.plurality.network/mcp"
    }
  }
}

1. Restart Windsurf.

2. Open the Cascade panel (agent sidebar). The Plurality tools become available to the AI agent.

3. On first use, Windsurf opens your browser for OAuth login.

Verify

In Cascade, ask: "List my Plurality memory buckets."

If the agent calls get_user_memory_buckets and returns results, you're connected.

Troubleshoot

Tools missing in Cascade. Confirm the JSON key is serverUrl (not url) — Windsurf is picky about this.

OAuth completes but no response. Restart Windsurf fully and try again.

Personal Access Token was correct. Make sure the header name is exactly Authorization and the value is Bearer <your access token starting with plur_pat_>