Skip to main content

​
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.
Windsurf Cascade panel with MCPCore tool call

​
Troubleshooting

ProblemSolution
Tools not appearingCheck that the config file path is correct and JSON is valid
401 UnauthorizedVerify the --header argument
Tool calls failCheck Traffic Logs