---
title: Windsurf MCP Setup Guide | Flyweel Docs
description: Connect Flyweel MCP to Windsurf IDE
url: "https://www.flyweel.co/docs/mcp/windsurf"
type: static
generatedAt: "2026-10-08T05:30:40.229Z"
---

![Documentation hero background](https://astro-flyweel-docs.vercel.app/vision-hero.webp)
# Windsurf

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

---

## Quick Setup[Link to this section](#quick-setup)

### Step 1: Get Your Token[Link to this section](#step-1-get-your-token)

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

Your token looks like: `fwl_a1b2c3d4...`

---

### Step 2: Configure Windsurf[Link to this section](#step-2-configure-windsurf)

**Option A: Via Settings UI**

 1. Open Windsurf
 1. Go to **Settings** → **MCP Servers**
 1. Click **Add Server**
 1. Enter:
 - **Name:** Flyweel
 - **URL:** `https://api.flyweel.co/functions/v1/mcp-server/mcp`
 - **Header Name:** `X-API-Key`
 - **Header Value:** Your token
 1. 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[Link to this section](#step-3-restart-windsurf)

Close and reopen Windsurf for the configuration to take effect.

---

### Step 4: Test It[Link to this section](#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[Link to this section](#troubleshooting)

### ”Authentication Error”[Link to this section](#authentication-error)

Your token is invalid or deleted.

**Fix:** Generate a new token at [app.flyweel.co](https://app.flyweel.co) → Settings → API & MCP.

### ”No accounts found”[Link to this section](#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[Link to this section](#windsurf-doesnt-see-flyweel)

The MCP server isn’t configured correctly.

**Fix:**

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

---

## Next Steps[Link to this section](#next-steps)

 - [What can you ask?](/docs/mcp/setup#what-can-you-ask)
 - [Technical reference](/docs/mcp/setup#technical-reference)
 - [Request a feature](/docs/mcp/setup#request-a-feature)

### Ready to get started?

Start optimizing your ad spend today with Flyweel.
  [Start Free](https://signup.flyweel.co/?variant=control)