Skip to content
Documentation hero background

Claude Code (Desktop)

Claude Code Desktop is the standalone desktop application for Claude. It has native MCP support.


Quick Setup

Step 1: Get Your Token

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

Your token looks like: fwl_a1b2c3d4...


Step 2: Configure Claude Desktop

Open or create the config file:

macOS:

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

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Linux:

~/.config/Claude/claude_desktop_config.json

Add this configuration:

{
"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 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 taskbar icon → Close window

Step 4: 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

Windows

  1. Press Win + R
  2. Type: %APPDATA%\Claude
  3. Press Enter
  4. Look for claude_desktop_config.json

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.

Claude doesn’t see Flyweel

The config file is in the wrong location or has a 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
  3. Validate 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.