Windsurf Setup

Add Memcone memory to Windsurf in under 60 seconds.

Automatic setup (recommended)

Run this in your project directory:

npx @memcone/cli link

npx @memcone/cli link

link detects Windsurf, writes .windsurf/mcp.json, and scopes memory to your project automatically. Restart Windsurf and you're done.

You need a Memcone API key from dashboard → API keys. The CLI will prompt for it on first run and save it to ~/.memcone/credentials.

Manual config

If you prefer to configure manually, open Settings → Cascade → MCP Servers → Add Server and enter:

• URL: https://memcone.com/api/mcp
• Header: Authorization: Bearer mem_live_YOUR_KEY_HERE

Or use the raw config file. Depending on your Windsurf version, create or edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "memcone": {
      "serverUrl": "https://memcone.com/api/mcp",
      "headers": {
        "Authorization": "Bearer mem_live_YOUR_KEY_HERE"
      }
    }
  }
}

{
  "mcpServers": {
    "memcone": {
      "serverUrl": "https://memcone.com/api/mcp",
      "headers": {
        "Authorization": "Bearer mem_live_YOUR_KEY_HERE"
      }
    }
  }
}

Step 2 — Restart Windsurf

Press refresh in the MCP tools view or restart Windsurf. The Memcone tools should appear in Cascade.

Using it

In any Cascade session, the AI now has access to:

• memcone.context — injects your project identity, rules, and past session memory
• memcone.remember — stores facts the AI learns about you
• memcone.recall — searches past memory on demand

You can prompt directly:

"Remember that I always want TypeScript strict mode enabled"

"What decisions have we made about the auth layer?"

Troubleshooting

Server doesn't appear in Cascade tools → Go to Settings → Cascade → MCP Servers and check if memcone shows as connected. Click refresh or restart Windsurf.

"Failed to connect" → Confirm the config uses serverUrl (not url) for Windsurf's raw config format.

401 Unauthorized → Verify your key at dashboard → API keys. It must start with mem_live_.

No memory returned → Nothing is stored yet. Tell Cascade: "Remember that this project uses Next.js and Drizzle". Confirm at dashboard → Memory.