Skip to main content

Configure Windsurf

Windsurf reads MCP servers from a per-user JSON config file.

Locate the config file​

OSPath
macOS / Linux~/.codeium/windsurf/mcp_config.json
Windows%USERPROFILE%\.codeium\windsurf\mcp_config.json

You can also reach the file from inside Windsurf via the MCPs icon in the Cascade panel → Configure.

Add the server​

Create or edit the config file:

{
  "mcpServers": {
    "onesource": {
      "command": "npx",
      "args": ["-y", "@one-source/mcp@latest"],
      "env": { "ONESOURCE_API_KEY": "sk_…" }
    }
  }
}

Restart Cascade​

In Windsurf, open the Cascade panel and click the refresh icon next to the MCP servers list. New servers and changed env vars require this refresh (or a full Windsurf restart).

Verify​

Open Cascade and prompt: "Call 1s_setup_check." Expected: tool card with Status: Configured (API key).

Per-tool toggling​

Windsurf lets you enable or disable individual tools within an MCP server from the Cascade MCP panel: useful if you want, say, only the blockchain data tools and not 1s_report_bug.

Next​