---
title: Cursor MCP Setup Guide | Flyweel Docs
description: Connect Flyweel MCP to Cursor IDE
url: "https://www.flyweel.co/docs/mcp/cursor"
type: static
generatedAt: "2026-09-18T05:57:35.759Z"
---

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

Cursor is an AI-powered code editor with built-in MCP support and OAuth.

---

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

The fastest way to connect. No API key needed — you sign in to Flyweel in your browser and approve access.

On the Flyweel [API & MCP settings page](https://app.flyweel.co/settings/api-tokens), click the one-click **Add to Cursor** button. Cursor adds the server for you — approve access in the browser when prompted, and you’re connected.
    Prefer to add it by hand?
 1. Open Cursor
 1. Go to **Settings** (gear icon) → **MCP**
 1. Click **Add Server**
 1. Enter:
 - **Name:** Flyweel
 - **URL:** `https://api.flyweel.co/functions/v1/mcp-server/mcp`
 1. Save. Cursor opens your browser to sign in to Flyweel and approve access.

---

## Fallback: Connect with an API Key[Link to this section](#fallback-connect-with-an-api-key)

Only needed if OAuth isn’t available for you. Instead of signing in through the browser, you paste an API key into a config file.
    Show API-key setup
**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 immediately — it won’t be shown again

Your token looks like: `fwl_a1b2c3d4...`
   Managing tokens
Toggle a key off to deactivate it, or use the trash icon to delete it.

**Step 2: Add the config**

Open or create `~/.cursor/mcp.json`:

**

```
{  "mcpServers": {    "flyweel-mcp-server": {      "type": "http",      "url": "https://api.flyweel.co/functions/v1/mcp-server/mcp",      "headers": {        "Authorization": "Bearer fwl_YOUR_TOKEN_HERE"      }    }  }}
```

Replace `fwl_YOUR_TOKEN_HERE` with your actual token.
   Header alternative
`Authorization: Bearer fwl_…` is preferred. If your client only accepts a custom header, use `X-API-Key: fwl_…` instead.

**Step 3: Restart Cursor**

Close and reopen Cursor for the configuration to take effect.

---

## Test It[Link to this section](#test-it)

In Cursor’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. Or reconnect via OAuth by re-adding the server in Settings → 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.

### Cursor doesn’t see Flyweel[Link to this section](#cursor-doesnt-see-flyweel)

The MCP server isn’t configured correctly.

**Fix:**

 1. Go to Settings → MCP and verify Flyweel is listed
 1. Check the URL is exactly: `https://api.flyweel.co/functions/v1/mcp-server/mcp`
 1. If using OAuth, re-add the server and approve access again
 1. If using the API-key fallback, verify your token is correct in `~/.cursor/mcp.json`
 1. Restart Cursor 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)