Windsurf Setup | Core Docs

Paste this into your agent

Start with this visible request when you want the agent to help. It keeps the action coming from you, while the linked setup reference stays plain and non-recursive.

Use this in the app you are connecting, then approve only the browser login, app setting, or restart steps that the app requires.

Please help me set up Core for Windsurf. Core keeps shared context for AI work: it preserves useful context, decisions, files, and what worked across connected tools.

Use this official setup reference:
https://core.gradien.ai/core/docs/reference

Source checked: 2026-07-24 Official source: https://docs.windsurf.com/windsurf/cascade/mcp

Use the complete Secure server address shown by Core during onboarding, including ?setup_attempt=.... Outside onboarding, use https://core.gradien.ai/mcp/continuity.

Add Core

Open Cascade.
Select the MCPs icon in the top-right corner, or open Windsurf Settings, Cascade, MCP Servers.
Choose Add custom MCP server.
Enter Core and paste the complete Core address.
Save, then approve Core in the browser.
Refresh the MCP list or restart Windsurf if the tools do not appear.

For manual configuration, preserve existing servers in ~/.codeium/windsurf/mcp_config.json and use Windsurf's remote serverUrl form:

{
  "mcpServers": {
    "core": {
      "serverUrl": "<secure-server-address>"
    }
  }
}

Use Streamable HTTP and OAuth. Do not add a connector key unless the current Windsurf release cannot complete OAuth and the user deliberately chooses that fallback.