Skip to main content

​
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

Open MCP config

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

Add Civic as an MCP server

{
  "mcpServers": {
    "civic": {
      "serverUrl": "https://app.civic.com/hub/mcp"
    }
  }
}
3

Restart Windsurf

Restart Windsurf (or reload the window) to pick up the config change.
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

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.
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.
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