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 Tokens
Click Create New Token
Name it (e.g., “Windsurf”)
Click Generate and copy it immediately

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/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": {
      "url": "https://api.flyweel.co/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 Tokens.

”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/mcp-server/mcp
Verify your token is correct
Restart Windsurf completely

Windsurf