Windsurf

Add the server

Edit the Windsurf MCP config and add the remote server entry, then restart the editor.

{
  "mcpServers": {
    "mcp-ads": {
      "url": "https://mcp-ads.com/mcp-slim"
    }
  }
}

Authorise

The first tool call opens a browser window for the one-time OAuth authorisation. You sign in on mcp-ads.com, approve the grant, and return to the editor; nothing about your ad accounts is stored in the config file.

1. Restart Windsurf and check the server list

   Cascade reads the config at startup. Open the MCP panel in Cascade after restarting and confirm mcp-ads is listed with a tool count rather than an error.

2. Trigger the sign-in

   Ask Cascade anything that needs a tool. The browser opens on mcp-ads.com; approve the grant and close the tab when told you can return.

3. Verify it works

   The first real tool call should return the platforms connected in your MCP Ads dashboard and the accounts on each. An empty list means the server is reachable but nothing is connected yet.

   Try this firstCopy

   Using mcp-ads, list the platforms I have connected and
   the accounts on each.

Troubleshooting

• The server is not listed after a restart: the file is in the wrong place or is not valid JSON. The path is ~/.codeium/windsurf/mcp_config.json, and the codeium directory is hidden; on macOS use Cmd+Shift+G in the file dialog or open it from the terminal.
• The OAuth window is blocked: Windsurf opens the system browser, and a popup blocker or a locked-down browser profile can swallow it. The authorisation URL is printed in Cascade's MCP output; open it manually in any browser.
• "A server with this URL already exists": the same URL appears twice, usually under two different names after an edit. Keep one entry and restart.
• The wrong config path was edited: Windsurf also has a settings UI for MCP that writes to the same file. If you edited a file under ~/.windsurf instead, Cascade will not see it; move the entry to the path above.

Go further

Cursor

Same entry, different config path.

Tool reference

Every tool available once connected.