Prerequisites
- A Cometly workspace and a Space you are a member of.
- A ChatGPT plan that includes custom MCP servers. On an individual account they live behind Developer mode; in a Business, Enterprise or Edu workspace an admin or owner adds them for the workspace. Which plans include custom servers, and whether they may run write actions, is set by OpenAI and changes over time: check Connecting custom MCP servers in ChatGPT for your plan before you start.
On a plan that limits custom servers to read actions, ChatGPT won’t run Cometly’s three
update_* tools. Everything else on this page works the same.Add the connector
The server URL is the same on every plan:Individual account (Developer mode)
In ChatGPT on the web, open Settings → Apps & Connectors → Advanced settings and turn on Developer mode, then under Developer mode click Create and fill in:
Click Create.
Business, Enterprise or Edu workspace
A workspace admin or owner (or a member the admins have allowed to create plugins) opens Plugins → Add custom MCP server, enters the same name, URL and OAuth authentication, tests the connection privately, then publishes it for the workspace. Members then enable Cometly from the tools menu in a chat./mcp/chatgpt is the same server as https://app.cometly.com/mcp, published on a second path so ChatGPT can read the tool list before you link your account. Use https://app.cometly.com/mcp for every other client.Authorize
ChatGPT opens the Cometly authorization page while it sets up the connector. Log in, choose which Spaces to grant (all of yours or specific ones, with a default) and click Approve, then wait for ChatGPT’s tool scan to finish before you start a chat. The token is saved inside ChatGPT’s connector store — you can revoke it at any time from the same Connectors screen.Verify
Start a new chat withgpt-5 or higher selected (smaller models occasionally hallucinate MCP tool calls). Ask:
Using the Cometly connector, show my purchase volume by source for the last 7 days.You should see a
query_ad_metrics tool call followed by a real response.
Troubleshooting
No Developer mode or Create option
No Developer mode or Create option
Developer mode lives under Settings → Apps & Connectors → Advanced settings on the web. If it isn’t there, your plan doesn’t include custom connectors, or you’re in a workspace where an admin has to add the server (see the note above).
OAuth flow opens but redirects fail
OAuth flow opens but redirects fail
ChatGPT’s connector layer occasionally races on the OAuth callback. Restart the app, remove the connector, and add it again — the second attempt is usually clean.
Tools are visible but every call errors with 401
Tools are visible but every call errors with 401
The token is missing or stale. Open the connector settings, click Reconnect, and walk the OAuth flow again.
Privacy note
ChatGPT logs prompts and tool calls per OpenAI’s data policy. The MCP server itself never sees your prompt — only the tool name and validated arguments your client sends. Errors are logged with acorrelation_id only; no PII from arguments is digested into our audit log.