> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getcore.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Windsurf

> Connect your Windsurf IDE to CORE's memory system

### Prerequisites

* Windsurf IDE installed
* CORE account - [Sign up at app.getcore.me](https://app.getcore.me)

### Step 1: Add CORE MCP in Windsurf

1. Open Windsurf IDE
2. Navigate to **Windsurf Settings** → **Cascade** section
3. Open **MCP Marketplace** -> **Settings** OR **View raw config** to open the configuration file
4. Add the following to your `mcp_config.json`:

```json theme={null}
{
  "mcpServers": {
    "core-memory": {
      "serverUrl": "https://app.getcore.me/api/v1/mcp?source=windsurf"
    }
  }
}
```

5. Save the file and restart Windsurf IDE

### Step 2: Authenticate with CORE

1. After saving the config, Windsurf will open a browser window for authentication
2. Grant Windsurf permission to access your CORE memory

### Step 3: Verify Connection

1. Go to **Cascade Editor** → **Plugin Icon** -> Hit **Refresh** icon
2. Confirm **core-memory** shows as **Active** with green indicator

Add your first memory:

> "Summarise the whole project in detail and add it to CORE Memory"

***

## Alternative: Using API Key Method

If the OAuth authentication doesn't work, use the API key method instead:

### Step 1: Get Your API Key

1. Log into your CORE dashboard at [app.getcore.me](https://app.getcore.me)
2. Navigate to **Settings** (bottom left)
3. Go to **API Key** → **Generate new key** → Name it "windsurf"
4. Copy the generated key

### Step 2: Update MCP Configuration

Replace your `mcp_config.json` configuration with:

```json theme={null}
{
  "mcpServers": {
    "core-memory": {
      "serverUrl": "https://app.getcore.me/api/v1/mcp/source=windsurf",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}
```

Replace `<YOUR_TOKEN>` with the API key you copied from Step 1.

### Step 3: Restart and Verify

1. Save the file and restart Windsurf IDE
2. Go to **Cascade Editor** → **Plugin Icon** → Hit **Refresh**
3. Confirm **core-memory** shows as **Active** with green indicator

***

## Enable Automatic Memory Integration (Recommended)

Create `AGENTS.md` in your project root (or append if it already exists) and add the memory protocol from the [Memory Rules guide](/providers/memory-rules).

Use this frontmatter for AGENTS.md:

```markdown theme={null}
---
trigger: always_on
---
```

Then paste the memory protocol content below it.

## How It Works

Once connected, CORE memory integrates with Windsurf's Cascade:

* **Auto-recall**: Cascade searches your memory at conversation start
* **Auto-store**: Key insights saved automatically after conversations
* **Cross-platform**: Memory shared across Windsurf, Cursor, Claude Code, ChatGPT
* **Project continuity**: Context persists across all coding sessions

## Troubleshooting

**Connection Issues:**

* Ensure core-memory MCP is active (green indicator)
* Try toggling the MCP off and on
* Restart Windsurf IDE completely

**Authentication Problems:**

* Make sure you completed the OAuth flow in browser
* Check that your CORE account is active at app.getcore.me

**MCP Not Appearing:**

* Verify `mcp_config.json` syntax is valid JSON
* Restart Windsurf after config changes

### Need Help?

Join our [Discord community](https://discord.gg/dVTC3BmgEq) - ask in **#core-support** channel.