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

# Connect Adriel MCP

> How to add Adriel MCP to Claude or ChatGPT and sign in with an Adriel account.

Adriel MCP connects to an AI assistant as a remote MCP server. Add the server URL to the assistant, then sign in with an Adriel account. For what Adriel MCP can do and how access is scoped, see [Adriel MCP](https://docs.adriel.com/automate-and-ai/adriel-mcp/overview.md).

## Before you connect

* **An Adriel account.** Adriel MCP is available on all Adriel plans. Each person signs in with their own account; access can't be shared.
* **At least one teamspace with data sources assigned to it.** Adriel MCP returns only data from teamspaces the member belongs to. See [Teamspace settings](https://docs.adriel.com/workspace-and-access/teamspace-settings.md).
* **An AI assistant plan that supports custom MCP connectors.** Each AI assistant sets its own limits on which plans can add custom connectors and how many. Check the plan details for each assistant under [Connect Adriel MCP](#connect-adriel-mcp).
* **Admin approval on team or enterprise plans only.** On organization plans such as Claude Team or Enterprise and ChatGPT Business, Enterprise, or Edu, an owner or admin may need to add or allow the connector first. Individual plans, such as Claude Pro or Max, don't need this step.

Server URL:

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

> [!NOTE]
>
> Adriel MCP is added as a **custom connector** in both Claude and ChatGPT. Each person connects with their own Adriel account, and the connection only returns data that account can access in Adriel.

## Connect Adriel MCP

> [tab] Claude
>
> Custom connectors are available on Claude Free, Pro, Max, Team, and Enterprise plans; Free plans are limited to one custom connector ([Claude Help Center](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp)).
>
> Add Adriel MCP **one** of two ways. Both connect to the same server, so there's no need to do both:
>
> * **In the Claude app.** Add it as a custom connector in claude.ai or Claude Desktop. When Claude Code is signed in with the same Claude account, the connector is also available there ([Claude Code docs](https://code.claude.com/docs/en/mcp#use-mcp-servers-from-claude-ai)).
> * **From the terminal, in Claude Code.** Add it with one command, or ask Claude Code to add it. A server added this way is available in Claude Code only.
>
> ### In the Claude app: Pro and Max plans
>
> **1. Open Connectors**
>
> In Claude, go to **Settings** > **Customize** > **Connectors**.
>
> **2. Add a custom connector**
>
> Click **+ Add**, then **Add custom connector**.
>
> **3. Enter the server details**
>
> In the **Add custom connector** dialog, enter a name, for example `Adriel MCP`, and `https://mcp.adriel.com/mcp` as the server URL. Click **Continue**.
>
> ![Claude's Add custom connector dialog with the name Adriel MCP and the server URL https://mcp.adriel.com/mcp filled in](https://mintcdn.com/adriel-4619f3a7/ueKiJSA-Zsm0V0kx/images/adriel-mcp-claude-add-custom-connector.png?fit=max\&auto=format\&n=ueKiJSA-Zsm0V0kx\&q=85\&s=6c9759069a505566e063e6e893284863)
>
> **4. Confirm authentication**
>
> Keep the detected OAuth settings and finish adding the connector.
>
> **5. Sign in to Adriel**
>
> Click **Connect** and sign in with an Adriel account.
>
> ### In the Claude app: Team and Enterprise plans
>
> An organization owner adds the connector once for the whole organization. Each member then signs in with their own Adriel account.
>
> **1. Add the connector (owner)**
>
> Go to **Organization settings** > **Connectors** and click **Add**. Hover over **Custom**, select **Web**, and enter a name, for example `Adriel MCP`, and `https://mcp.adriel.com/mcp` as the server URL. Keep the detected OAuth settings and click **Add**.
>
> **2. Connect (each member)**
>
> In Claude, go to **Settings** > **Customize** > **Connectors**, find the Adriel connector the owner added, and click **Connect**. Sign in with an Adriel account.
>
> ### From the terminal, in Claude Code
>
> If Adriel MCP was already added in the Claude app, it may already be listed: run `/mcp` in Claude Code to check.
>
> **1. Add the server**
>
> Run the following in a terminal. `adriel` is the server name and can be anything.
>
> ```bash theme={null}
> claude mcp add --transport http adriel https://mcp.adriel.com/mcp
> ```
>
> Alternatively, ask Claude Code to do it, for example: "Add the Adriel MCP server at [https://mcp.adriel.com/mcp](https://mcp.adriel.com/mcp)."
>
> **2. Sign in to Adriel**
>
> Run `/mcp` inside Claude Code, select the Adriel server, and follow the sign-in prompt with an Adriel account.

> [tab] ChatGPT
>
> Custom MCP servers can be added on **ChatGPT web only** (chatgpt.com), not in the ChatGPT mobile app ([OpenAI Help Center](https://help.openai.com/en/articles/12584461-connecting-custom-mcp-servers-in-chatgpt)).
>
> Which ChatGPT plans can add a custom MCP server:
>
> * **Business:** only workspace admins and owners can add and publish it for the workspace.
> * **Enterprise and Edu:** admins and owners, plus members an admin has given permission to. Only admins and owners can publish it for the workspace.
> * **Pro:** custom MCP servers are limited to read and fetch actions. Adriel MCP is read-only.
>
> ### Add Adriel MCP on ChatGPT web
>
> **1. Open Plugins**
>
> On chatgpt.com, go to **Plugins**.
>
> **2. Add a custom MCP server**
>
> Select the plus button, then select **Add custom MCP server**.
>
> **3. Enter the server details**
>
> Enter a name, for example `Adriel MCP`. Under **Connection**, enter `https://mcp.adriel.com/mcp`, and set authentication to OAuth.
>
> **4. Acknowledge the risk warning**
>
> Select the **I understand and want to continue** checkbox, then select **Create as a plugin**.
>
> **5. Sign in to Adriel**
>
> Complete the sign-in flow with an Adriel account.
>
> On Business, Enterprise, and Edu plans, an admin or owner publishes the plugin for the workspace. Members then find it under **Settings** > **Plugins** and sign in with their own Adriel account.
>
> ### Use Adriel MCP in a chat
>
> In ChatGPT, select the plugin for each message that needs Adriel data: type `@` in the prompt box and pick Adriel MCP. Results already in the conversation can be discussed without selecting it again.

## Verify the connection

Start a new conversation and ask something only Adriel can answer, for example:

```text theme={null}
List the teamspaces I can access in Adriel.
```

```text theme={null}
In the <teamspace name> teamspace, list the data sources and the main metrics I can query.
```

If the assistant lists the expected teamspaces and data sources, the connection works. For prompt examples and tips, see [Adriel MCP](https://docs.adriel.com/automate-and-ai/adriel-mcp/overview.md#tips-for-reliable-results).

## Disconnect Adriel MCP

To stop an AI assistant from accessing Adriel, remove or disconnect the Adriel MCP connector in that assistant's connector settings.

## Troubleshooting

> [accordion] The sign-in window doesn't open or fails
>
> Allow pop-ups for the AI assistant's site and try again. On team or enterprise plans, confirm with the organization admin that custom connectors are allowed.

> [accordion] The wrong Adriel account is connected
>
> The connection uses the Adriel account that signed in. Disconnect the connector, connect again, and sign in with the correct account.

> [accordion] The assistant connects but finds no data
>
> Adriel MCP only shows teamspaces the member belongs to and data sources assigned to those teamspaces. Check [Teamspace settings](https://docs.adriel.com/workspace-and-access/teamspace-settings.md) and [Permissions and access](https://docs.adriel.com/data-sources/managing/permissions-and-access.md).

## Related

> [card] [Adriel MCP](https://docs.adriel.com/automate-and-ai/adriel-mcp/overview.md)
>
> What Adriel MCP can do, how access works, and prompt tips.

> [card] [Teamspace settings](https://docs.adriel.com/workspace-and-access/teamspace-settings.md)
>
> Control which members and data sources each teamspace includes.


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