Windsurf is an AI-native IDE by Codeium with built-in MCP support.

Quick Setup

Step 1: Get Your Token

Go to app.flyweel.co
Click Settings → API & MCP
Under Advanced: use an API key instead, click Generate API key (or Create Token to name your own)
Copy it once — it won’t be shown again

Your token looks like: fwl_a1b2c3d4...

Step 2: Configure Windsurf

Option A: Via Settings UI

Open Windsurf
Go to Settings → MCP Servers
Click Add Server
Enter:
- Name: Flyweel
- URL: https://api.flyweel.co/functions/v1/mcp-server/mcp
- Header Name: X-API-Key
- Header Value: Your token
Click Save

Option B: Via Config File

Open or create ~/.windsurf/mcp.json:

{
  "mcpServers": {
    "flyweel-mcp-server": {
      "url": "https://api.flyweel.co/functions/v1/mcp-server/mcp",
      "headers": {
        "X-API-Key": "fwl_YOUR_TOKEN_HERE"
      }
    }
  }
}

Replace fwl_YOUR_TOKEN_HERE with your actual token.

Step 3: Restart Windsurf

Close and reopen Windsurf for the configuration to take effect.

Step 4: Test It

In Windsurf’s AI chat, ask:

What Google Ads accounts do I have connected to Flyweel?

If you see your accounts, you’re connected.

Troubleshooting

”Authentication Error”

Your token is invalid or deleted.

Fix: Generate a new token at app.flyweel.co → Settings → API & MCP.

”No accounts found”

You haven’t connected ad accounts to Flyweel.

Fix: Go to Settings → Connections in Flyweel and connect your Google Ads or Meta Ads.

Windsurf doesn’t see Flyweel

The MCP server isn’t configured correctly.

Fix:

Go to Settings → MCP Servers and verify Flyweel is listed
Check the URL is exactly: https://api.flyweel.co/functions/v1/mcp-server/mcp
Verify your token is correct
Restart Windsurf completely

Windsurf