Windsurf

Windsurf supports MCP servers via its mcp_config.json. The Part3 server connects over HTTP — no extension or wrapper required.

Locate the config file

OS	Path
macOS	`~/.codeium/windsurf/mcp_config.json`
Windows	`%USERPROFILE%\.codeium\windsurf\mcp_config.json`
Linux	`~/.codeium/windsurf/mcp_config.json`

If the file doesn't exist, create it with {} as the initial content. You can also reach it from Windsurf: click the MCPs icon in the top-right of the Cascade panel, or go to Settings → Cascade → MCP Servers, then open the raw config.

Add the MCP server

{
  "mcpServers": {
    "part3": {
      "serverUrl": "https://mcp.part3.io"
    }
  }
}

Use the serverUrl field — Windsurf's name for a remote streamable-HTTP endpoint. No header, no secret. Windsurf detects that the server requires auth, discovers the OAuth endpoints automatically, and opens a browser on first use to sign in and approve access.

Prime-only access

MCP is currently limited to users who are a Project Prime on at least one project, plus super-duper-admins. Non-Primes will see an access-denied page on the consent screen.

Refresh

Open the MCPs panel (top-right icon in the Cascade panel) and click the refresh control, or reload Windsurf. part3 should appear in the server list with its tool count.

Verify

Open Cascade chat and ask:

Using Part3, list my active projects.

Troubleshooting

See the Claude Code troubleshooting section — the causes and fixes apply to Windsurf as well.