> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adclear.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Adclear to your AI assistant

> Use Adclear from Claude, ChatGPT or Cursor to find promotions, read feedback and upload new promotions.

MCP (Model Context Protocol) is the standard that AI assistants use to connect to other apps. When you connect Adclear, your assistant can find promotions, read feedback from Adclear AI and reviewers, upload promotions and read dashboard metrics.

The assistant acts as you. It can see and do only what you can in the Adclear app, in the organisation you choose when you sign in.

<Warning>
  MCP is in closed beta. To get access, contact your Adclear account manager.
</Warning>

## What you can ask

Ask in your own words. The assistant chooses the tools. For example:

* "Which of my promotions got new comments this week?"
* "Summarise what Adclear AI found on the latest version of my summer savings promotion."
* "Upload this PDF as a new promotion and tell me what Adclear AI finds."
* "Pre-check this email copy before I upload it."
* "How many promotions did we approve last month?"

For the full list of actions and the permissions each one needs, see [Tools and permissions](/mcp/tools-and-permissions).

## Before you start

You need:

* **A client ID.** Your Adclear account manager gives it to you when your organisation joins the beta. Keep it inside your organisation.
* **An Adclear account** with access to at least one workspace.
* **Network access to `files.adclear.ai`**, to upload files from your computer. Some assistants run code in a sandbox that blocks unknown sites. If uploads fail, ask your IT team to allow `files.adclear.ai`. Without it, you can still upload from a public link.

The server URL is:

```text theme={null}
https://mcp.adclear.ai/mcp
```

## Connect your assistant

<Tabs>
  <Tab title="Claude">
    Claude Team and Enterprise plans only. A Claude Owner adds Adclear once. Then each person connects their own Adclear account.

    <Steps>
      <Step title="Add Adclear (Claude Owner, once)">
        Open **Organization settings** > **Connectors**, choose **Add**, then **Custom** > **Web**. Enter `Adclear` as the name and the server URL. For authentication, choose **Use your own OAuth client**. Enter the client ID and leave the client secret empty. Choose **Add**.
      </Step>

      <Step title="Connect your account (each person)">
        Open **Customize** > **Connectors**, find **Adclear** and choose **Connect**. Sign in to Adclear, choose your organisation and click **Allow access**.
      </Step>

      <Step title="Turn it on in a chat">
        In a chat, open the **+** menu, choose **Connectors** and turn on **Adclear**.
      </Step>
    </Steps>
  </Tab>

  <Tab title="ChatGPT">
    ChatGPT Business, Enterprise and Edu workspaces only. A workspace admin adds Adclear once. Then each person signs in with their own Adclear account.

    <Steps>
      <Step title="Turn on developer mode (admin, once)">
        Open **Workspace settings** > **Permissions & roles** and turn on **Developer mode**.
      </Step>

      <Step title="Create the app (admin, once)">
        Open **Workspace settings** > **Apps** and choose **Create**. Enter `Adclear` as the name and the server URL. Under authentication, open **Advanced settings**, choose **User-defined OAuth client** and enter the client ID. Leave the secret empty.
      </Step>

      <Step title="Send the callback URL to Adclear (admin, once)">
        Copy the callback URL that ChatGPT shows and send it to your Adclear contact. Save the app when Adclear confirms that it is ready.
      </Step>

      <Step title="Sign in (each person)">
        In a chat, choose **Adclear** from your apps. The first time, sign in to Adclear, choose your organisation and click **Allow access**.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Cursor">
    <Steps>
      <Step title="Open your MCP settings">
        Open the command palette, search for **Open MCP settings** and click **Add custom MCP**. Cursor opens `mcp.json`.
      </Step>

      <Step title="Add Adclear">
        Add this server, with your client ID:

        ```json theme={null}
        {
          "mcpServers": {
            "adclear": {
              "url": "https://mcp.adclear.ai/mcp",
              "auth": { "CLIENT_ID": "<your-client-id>" }
            }
          }
        }
        ```
      </Step>

      <Step title="Sign in">
        Reload Cursor. Sign in to Adclear when Cursor asks. Choose your organisation and click **Allow access**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Check that it works

Ask your assistant: "Who am I signed in as in Adclear?"

The answer shows your name, your organisation and role, and the workspace your requests use.

## Change workspace

If your organisation has more than one workspace, ask: "List my Adclear workspaces", then "Switch to the Brand workspace".

Adclear keeps your choice for later conversations until you choose a different one. If you lose access to that workspace, requests go to your organisation's default workspace.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Adclear is not in my list of connectors or apps">
    In Claude and ChatGPT, an admin must add Adclear first. Ask your Claude Owner or ChatGPT workspace admin.
  </Accordion>

  <Accordion title="Sign-in fails">
    Check that the client ID is the one your Adclear contact gave you, with no extra spaces. In ChatGPT, also check that Adclear confirmed your callback URL.
  </Accordion>

  <Accordion title="How do I use a different organisation?">
    The connection is tied to the organisation you chose at sign-in. Disconnect Adclear in your assistant, connect again and choose the other organisation.
  </Accordion>

  <Accordion title="The assistant says I have no workspace">
    Your account has no access to a workspace in this organisation. Ask your Adclear admin to give you access.
  </Accordion>

  <Accordion title="The assistant cannot do something I can do in the app">
    The assistant gets only the tools your role allows, and it loads the list when it connects. If your role changed, disconnect Adclear and connect again so the assistant loads the new list.
  </Accordion>

  <Accordion title="Uploads from my computer fail">
    Your assistant probably cannot reach `files.adclear.ai`. Ask your IT team to allow it, or give the assistant a public link to the file.
  </Accordion>

  <Accordion title="The connection stopped working">
    Disconnect Adclear in your assistant and connect again. If it still fails, contact Adclear support. Include the time of the error and the correlation ID if the assistant shows one.
  </Accordion>
</AccordionGroup>


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