Skip to content
Documentation hero background

Claude Desktop

Claude Desktop is the standalone desktop application for Claude. It has native MCP support, making it one of the easiest ways to use Flyweel’s AI tools.

Quick Setup

Get Your API Key

  1. Go to app.flyweel.co
  2. Click Settings → API Tokens
  3. Click Create New Token
  4. Name it (e.g., “Claude Desktop”)
  5. Click Generate and copy it immediately

Your key looks like: fwl_a1b2c3d4...

Open Your Config File

Open or create the Claude Desktop config file at:

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Linux:

~/.config/Claude/claude_desktop_config.json

Not sure how to find it? See Finding the Config File below.

Add the Flyweel MCP Configuration

Paste the following into your config file:

{
  "mcpServers": {
    "flyweel": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.flyweel.co/functions/v1/mcp-server/mcp",
        "--header",
        "X-API-Key: YOUR_API_KEY"
      ]
    }
  }
}

Replace YOUR_API_KEY with the key you copied from your Flyweel dashboard.

Windows users

If you get a 'C:\Program' is not recognized error after restarting, don’t worry — this is a common Windows issue unrelated to Flyweel. See the Windows fix below.

Restart Claude Desktop

Important: Fully quit Claude Desktop (don’t just close the window), then reopen it.

  • macOS: Right-click dock icon → Quit, or Cmd+Q
  • Windows: Right-click system tray icon → Quit
  • Linux: Close the app and relaunch

Test It

Ask Claude:

What Google Ads accounts do I have connected to Flyweel?

If you see your accounts listed, you’re connected!

Finding the Config File

macOS

  1. Open Finder
  2. Press Cmd + Shift + G
  3. Paste: ~/Library/Application Support/Claude/
  4. Look for claude_desktop_config.json — if it doesn’t exist, create it

Windows

  1. Press Win + R
  2. Type: %APPDATA%\Claude
  3. Press Enter
  4. Look for claude_desktop_config.json — if it doesn’t exist, create it

Linux

  1. Open a terminal
  2. Navigate to ~/.config/Claude/
  3. Open or create claude_desktop_config.json

Troubleshooting

Windows: 'C:\Program' is not recognized

This is a common Windows bug. It happens because npx resolves to a path with spaces (like C:\Program Files\...) and Windows can’t handle it. It has nothing to do with your API key or Flyweel.

Fix it in 4 steps:

Find your Windows username

Open File Explorer → This PC → Local Disk (C:) → Users. One of the folders is your username — remember it.

Check that npx.cmd exists

Navigate to:

C:\Users\YOUR_USERNAME\AppData\Roaming\npm\
Can't see AppData?

It’s a hidden folder. In File Explorer, click View at the top and tick Hidden items. Then try again.

Look for a file called npx.cmd. If it’s there, continue to the next step.

Update your config

In your claude_desktop_config.json, find this line:

"command": "npx",

Replace it with the full path to npx.cmd:

"command": "C:\\Users\\YOUR_USERNAME\\AppData\\Roaming\\npm\\npx.cmd",

Replace YOUR_USERNAME with your actual Windows username from Step 1.

Your full config should look like this:

{
  "mcpServers": {
    "flyweel": {
      "command": "C:\\Users\\YOUR_USERNAME\\AppData\\Roaming\\npm\\npx.cmd",
      "args": [
        "mcp-remote",
        "https://api.flyweel.co/functions/v1/mcp-server/mcp",
        "--header",
        "X-API-Key: YOUR_API_KEY"
      ]
    }
  }
}

Restart Claude Desktop

Close it fully (right-click system tray icon → Quit) and open it again. Flyweel should now connect.

Using Claude Code in Desktop App? Ask Claude to fix it for you

Paste this prompt into Claude Code and let it handle the config update automatically:

Flyweel MCP isn't connecting. The error says 'C:\Program' is not recognized.
This is a Windows path issue — the npx command resolves to a path with spaces
(C:\Program Files\...). Find npx.cmd at a path without spaces (check
%APPDATA%\npm\npx.cmd) and update my Claude Desktop config at
%APPDATA%\Claude\claude_desktop_config.json to use the full path instead of
just "npx".

“Authentication Error”

Your API key is invalid or has been deleted.

Fix: Generate a new key at app.flyweel.co → Settings → API Tokens.

”No accounts found”

You haven’t connected ad accounts to Flyweel yet.

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

Claude doesn’t see Flyweel

The config file is in the wrong location or has a JSON syntax error.

Fix:

  1. Verify the file is named exactly claude_desktop_config.json
  2. Check it’s in the correct folder for your OS (see Finding the Config File)
  3. Validate your JSON syntax at jsonlint.com
  4. Fully restart Claude Desktop (quit and reopen, not just close the window)

Next Steps

Ready to get started?

Start optimizing your ad spend today with Flyweel.

Start Free