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

# Claude Desktop

> Install the Cometly MCP server in Claude Desktop and ask Claude about your marketing data in plain English.

> [!TIP]
>
> **Claude web also works out of the box.** If you prefer to use Cometly in the [claude.ai](https://claude.ai) web interface or mobile app, add the connector there instead — `claude.ai` and `claude.com` work out of the box. The steps are the same: paste the MCP endpoint URL (`https://app.cometly.com/mcp`) and approve access on first use.

## Prerequisites

* A Cometly workspace and a Space you are a member of.
* Claude Desktop (latest — MCP support is in all current builds).

## Add the server

In Claude Desktop, open **Settings → Connectors** (or **Settings → MCP** depending on your build).

Click **Add custom connector** and fill in:

| Field | Value |
| - | - |
| Name | `Cometly` |
| URL | `https://app.cometly.com/mcp` |

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

Click **Save**.

> [!NOTE]
>
> Claude Desktop's `claude_desktop_config.json` only starts local (stdio) servers, so a remote URL can't go in that file directly. Connectors are the supported way to add Cometly. On a plan without connectors, bridge it with the `mcp-remote` proxy instead:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "cometly": {
>       "command": "npx",
>       "args": ["-y", "mcp-remote", "https://app.cometly.com/mcp"]
>     }
>   }
> }
> ```
>
> Save the file and restart Claude Desktop; the proxy opens the same Cometly authorization page in your browser.

## Authorize

The first time Claude tries to call a Cometly tool, it'll open your browser to the Cometly authorization page. Log in, choose which Spaces to grant (all of yours or specific ones, with a default) and click **Approve**.

You'll see a green dot next to `Cometly` in the connectors list once the handshake succeeds.

## Verify

Open a new chat and ask:

> Using the Cometly connector, list my conversion events from the last 7 days.

You should see Claude call the `list_events` tool and respond with real data. The first response is sometimes a little slower (cold connection); subsequent calls are fast.

## Troubleshooting

> [accordion] Claude Desktop doesn't see the server
>
> Make sure you fully quit and reopened Claude Desktop after editing `claude_desktop_config.json` — it only reads the config at startup.

> [accordion] OAuth window doesn't open
>
> Older Claude Desktop builds occasionally swallow the OAuth URL. Re-add the connector via the **Connectors** UI instead of the config file; the UI flow is more reliable.

> [accordion] 401 on every call, or every tool answers with an authorization error
>
> Your access token is missing or wrong, or it no longer covers the Space. Remove the connector, restart Claude Desktop, and add it back — you'll re-walk the OAuth flow.

## What you can ask

* *"Show me purchases attributed to Facebook over the last 14 days with linear attribution."*
* *"Compare CPA between Google and Meta this month vs last month."*
* *"Find every contact created this week where Customer Plan is Premium."*
* *"Pull a full journey for contact 8231 and summarize it."*

Claude will pick the right tool ([`query_ad_metrics`](https://docs.cometly.com/mcp/tools/query-ad-metrics), [`list_events`](https://docs.cometly.com/mcp/tools/list-events), [`list_contacts`](https://docs.cometly.com/mcp/tools/list-contacts), [`get_contact`](https://docs.cometly.com/mcp/tools/get-contact)…) automatically and refer to your custom fields by their configured labels in its response.


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