Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cometly.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Prerequisites

  • A Cometly workspace and a Space you have Use Public API permission in.
  • ChatGPT Desktop app with Developer Mode → MCP Connectors enabled.
  • Your numeric Space ID — copy it from the ID row at the bottom of the dashboard sidebar, or from Space Settings → Space Details. See Finding your Space ID for step-by-step instructions.
MCP support in ChatGPT is rolling out gradually and may require an enabled Developer Mode preview on your account. The connect surface looks slightly different depending on whether you’re on Plus, Pro, or Business — the steps below are for the standard Developer Mode connector flow.

​
Add the connector

In ChatGPT Desktop, open Settings → Connectors → Add MCP server (under Developer Mode). Fill in:
FieldValue
NameCometly
TransportStreamable HTTP
URLhttps://app.cometly.com/mcp/{your-space-id}/public-api
Click Save.

​
Authorize

ChatGPT will open your browser to the Cometly authorization page on first use. Log in, confirm the Space, and click Approve. 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 with gpt-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

You’re not on a build that supports MCP yet, or Developer Mode is off. Update ChatGPT Desktop and toggle on Settings → Beta features → Developer Mode. If that toggle isn’t present, your account doesn’t have access yet.
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.
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 a correlation_id only; no PII from arguments is digested into our audit log.