Skip to content
Documentation hero background

Cursor

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


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, 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
  2. Go to Settings (gear icon) → MCP
  3. Click Add Server
  4. Enter:
    • Name: Flyweel
    • URL: https://api.flyweel.co/functions/v1/mcp-server/mcp
  5. Save. Cursor opens your browser to sign in to Flyweel and approve access.

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
  2. Click SettingsAPI & MCP
  3. Under Advanced: use an API key instead, click Generate API key (or Create Token to name your own)
  4. 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

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

”Authentication Error”

Your token is invalid or deleted.

Fix: Generate a new token at app.flyweel.co → Settings → API & MCP. Or reconnect via OAuth by re-adding the server in Settings → 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.

Cursor doesn’t see Flyweel

The MCP server isn’t configured correctly.

Fix:

  1. Go to Settings → MCP and verify Flyweel is listed
  2. Check the URL is exactly: https://api.flyweel.co/functions/v1/mcp-server/mcp
  3. If using OAuth, re-add the server and approve access again
  4. If using the API-key fallback, verify your token is correct in ~/.cursor/mcp.json
  5. Restart Cursor completely

Next Steps

Ready to get started?

Start optimizing your ad spend today with Flyweel.