Skip to main content

Windsurf Setup

Prerequisites​

Windsurf

Download and install Windsurf by Codeium

Civic Account

Create a free account and configure your tools at app.civic.com

Setup​

Windsurf supports remote MCP servers natively via Streamable HTTP — no local bridge required.

  1. 1
    Open MCP config

    Open or create ~/.codeium/windsurf/mcp_config.json

  2. 2
    Add Civic as an MCP server
    {
      "mcpServers": {
        "civic": {
          "serverUrl": "https://app.civic.com/hub/mcp"
        }
      }
    }
  3. 3
    Restart Windsurf

    Restart Windsurf (or reload the window) to pick up the config change.

  4. 4
    Authorize

    On first use, Cascade will prompt you to authenticate with Civic. Complete the OAuth flow in your browser, then return to Windsurf.

Test Your Connection​

Open Cascade and try:

"What MCP tools do I have available?"
"List my GitHub repositories"
"Check my Google Calendar for today"

Troubleshooting​

MCP server not appearing in Cascade

Check that the config file is valid JSON and saved at the correct path (~/.codeium/windsurf/mcp_config.json). Restart Windsurf after any config change.

Authentication fails

Remove the server entry, restart Windsurf, re-add it, and retry the auth flow. Make sure your browser isn't blocking the Civic OAuth popup.

Tools not available after connecting

Visit app.civic.com to confirm your toolkit has MCP servers configured. An empty toolkit will result in no tools being available.

Need Help?​

Troubleshooting

Common connection issues and solutions

Get Help

Ask in our developer Slack