Windsurf

Prerequisites

Windsurf installed
A MCPCore server with at least one tool
The config snippet from your server’s Integration tab

Step 1 — Get your config snippet

Open your server’s detail page, click the Integration tab, and select Windsurf. Copy the generated snippet.

{
  "mcpServers": {
    "your-server-code": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://your-subdomain.mcpcore.io/mcp"]
    }
  }
}

For API Key mode:

{
  "mcpServers": {
    "your-server-code": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote@latest",
        "https://your-subdomain.mcpcore.io/mcp",
        "--header", "Authorization: Bearer <your-api-key>"
      ]
    }
  }
}

Step 2 — Open the config file

macOS / Linux:

~/.codeium/windsurf/mcp_config.json

Windows:

%USERPROFILE%\.codeium\windsurf\mcp_config.json

Create the file if it doesn’t exist.

Step 3 — Merge the snippet

Paste your server entry into the mcpServers object.

Step 4 — Restart Windsurf

Save the config and restart Windsurf (or use Reload MCP from the Command Palette if available).

Step 5 — Verify

Open Windsurf’s Cascade AI panel and ask it to use one of your tools.

Troubleshooting

Problem	Solution
Tools not appearing	Check that the config file path is correct and JSON is valid
`401 Unauthorized`	Verify the `--header` argument
Tool calls fail	Check Traffic Logs

Getting Started

MCP Servers

Tools

Observability

Connect AI Clients

Prerequisites

Step 1 — Get your config snippet

Step 2 — Open the config file

Step 3 — Merge the snippet

Step 4 — Restart Windsurf

Step 5 — Verify

Troubleshooting

​Prerequisites

​Step 1 — Get your config snippet

​Step 2 — Open the config file

​Step 3 — Merge the snippet

​Step 4 — Restart Windsurf

​Step 5 — Verify

​Troubleshooting

Prerequisites

Step 1 — Get your config snippet

Step 2 — Open the config file

Step 3 — Merge the snippet

Step 4 — Restart Windsurf

Step 5 — Verify

Troubleshooting