To connect Flyweel MCP to JetBrains AI Assistant (IntelliJ IDEA, PyCharm, WebStorm, Rider, GoLand, and the rest of the 2025.3+ IDE family), open Settings, then Tools, then AI Assistant, then Model Context Protocol, and add Flyweel as an HTTP MCP server with https://api.flyweel.co/functions/v1/mcp-server/mcp and an X-API-Key header.
RequirementsLink to this section
- JetBrains IDE version 2025.3 or later (earlier versions do not support MCP)
- AI Assistant plugin installed and signed in
Step 1: Get your API tokenLink to this section
- Go to app.flyweel.co
- Open Settings → API & MCP
- Under Advanced: use an API key instead, click Generate API key (or Create Token to name your own)
- Copy the
fwl_…key once — it won’t be shown again
Step 2: Open MCP settingsLink to this section
- Open Settings (
cmd+,on macOS,ctrl+alt+son Windows/Linux) - Navigate to Tools, then AI Assistant, then Model Context Protocol
- Click Add (the
+button)
Step 3: Configure FlyweelLink to this section
| Field | Value |
|---|---|
| Name | Flyweel |
| Type | HTTP (streamable) |
| URL | https://api.flyweel.co/functions/v1/mcp-server/mcp |
| Header name | X-API-Key |
| Header value | fwl_YOUR_TOKEN_HERE |
Click OK, then Apply.
Step 4: Restart AI AssistantLink to this section
Close and reopen the AI Assistant tool window to pick up the new server.
Step 5: Test itLink to this section
In the AI Assistant chat, ask:
What Google Ads accounts do I have connected to Flyweel?TroubleshootingLink to this section
”Model Context Protocol” option is missingLink to this section
Your IDE or AI Assistant plugin is too old.
Fix: Update the IDE to 2025.3 or later and update AI Assistant to the latest plugin version.
401 unauthorizedLink to this section
API key is wrong or the header name is mistyped.
Fix: Header name must be exactly X-API-Key (case-sensitive). Regenerate the token if needed.
Server connects but tools do not appearLink to this section
AI Assistant caches tool lists per project.
Fix: Close and reopen the project, or restart the IDE.
