> ## 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's Desktop app (and any other MCP-aware OpenAI client) so you can ask GPT-5 about your marketing data.

## 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**](https://app.cometly.com/space/settings) → **Space Details**. See [Finding your Space ID](/mcp/overview#finding-your-space-id) for step-by-step instructions.

<Note>
  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.
</Note>

## Add the connector

In ChatGPT Desktop, open **Settings → Connectors → Add MCP server** (under Developer Mode).

Fill in:

| Field     | Value                                            |
| --------- | ------------------------------------------------ |
| Name      | `Cometly`                                        |
| Transport | `Streamable HTTP`                                |
| URL       | The endpoint below, with your Space ID filled in |

Copy the endpoint URL and replace `{your-space-id}` with your numeric Space ID:

```text theme={null}
https://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

<AccordionGroup>
  <Accordion title="No 'Add MCP server' button">
    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.
  </Accordion>

  <Accordion title="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>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

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