Most people should install the Flyweel app from the ChatGPT app directory: it takes one click and no configuration. This page covers the manual alternative: adding the raw MCP server URL as a custom connector. Turn on Developer mode under Apps & Connectors, add Flyweel as a connector, paste https://api.flyweel.co/functions/v1/mcp-server/mcp, set Authentication to OAuth, then sign in and approve. Flyweel shows up in the tool menu in any chat. ChatGPT connectors are OAuth-only; there is no API-key option.
Use the app instead unless you have a reason not to. The Flyweel app for ChatGPT is live in the directory, installs in one click, and needs no Developer mode. The manual connector below is for self-managed workspaces and testing against a non-production endpoint.
RequirementsLink to this section
- ChatGPT Plus, Pro, Business, Enterprise, or Edu (free tier does not support custom MCP connectors)
- Developer mode enabled (see Step 1)
- A Flyweel account at app.flyweel.co with at least one ad account connected
Custom MCP connectors are gated behind Developer mode, available on Plus/Pro and up. On Business/Enterprise/Edu workspaces an admin may need to enable it first.
Step 1: Enable Developer modeLink to this section
- Click your profile, then Settings
- Go to Apps & Connectors, then Advanced settings
- Toggle Developer mode on
See OpenAI’s guide: Developer Mode and full MCP connectors in ChatGPT (beta).
Step 2: Add the connectorLink to this section
- Back in Apps & Connectors, click Create
- Fill in:
| Field | Value |
|---|---|
| Name | Flyweel |
| Description | Ad performance data (Google, Meta, TikTok) plus Pipedrive CRM |
| URL | https://api.flyweel.co/functions/v1/mcp-server/mcp |
| Authentication | OAuth |
- Click Create
Step 3: Sign in and approveLink to this section
ChatGPT opens Flyweel in a browser window. Sign in and approve access — the connection is authorized automatically, with no token to manage.
Step 4: Test itLink to this section
- Open any chat
- Type
@Flyweelto invoke the connector, or ask naturally:
What Google Ads accounts do I have connected to Flyweel?Screenshots coming.
TroubleshootingLink to this section
”Create” option is missingLink to this section
Developer mode is not enabled.
Fix: Go back to Step 1. On Business/Enterprise/Edu you may need a workspace admin to enable it.
Flyweel does not appear in the tool menuLink to this section
The connector is saved but inactive.
Fix: In Settings, then Apps & Connectors, toggle Flyweel off and back on.
401 / “Authentication error”Link to this section
Your OAuth session expired or was revoked.
Fix: In Settings, then Apps & Connectors, remove the Flyweel connector and re-add it (Step 2), then sign in and approve again.
”No accounts found”Link to this section
You have not connected any ad accounts in Flyweel yet.
Fix: Go to app.flyweel.co, then Settings, then Connections, and link Google Ads, Meta, or TikTok.
