> ## 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.

# ChatGPT

> Connect the Cometly MCP server to ChatGPT as a custom connector so you can ask it about your marketing data.

## 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](https://help.openai.com/en/articles/12584461-connecting-custom-mcp-servers-in-chatgpt) for your plan before you start.

> [!NOTE]
>
> 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:

```text theme={null}
https://app.cometly.com/mcp/chatgpt
```

### 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:

| Field | Value |
| - | - |
| Name | `Cometly` |
| MCP server URL | `https://app.cometly.com/mcp/chatgpt` |
| Authentication | `OAuth` |

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.

> [!NOTE]
>
> `/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 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

> [accordion] 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).

> [accordion] 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.

> [accordion] 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 a `correlation_id` only; no PII from arguments is digested into our audit log.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.