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

# Connect Claude or ChatGPT

> Add the Alumio MCP server to the Claude or ChatGPT app and sign in with your Alumio account.

You add the Alumio MCP server to Claude or ChatGPT as a custom connector. This page covers the Claude and ChatGPT apps in the browser and on desktop. You need:

* The server address of your environment, for example `https://{environment}.alumio.com/api/v1/mcp`. See [Server address](https://docs.alumio.com/documentation/mcp-server.md#server-address).
* An Alumio account on that environment. To let the assistant make changes, your role must be Editor or higher.

The menus of the AI apps change regularly. If a label below doesn't match what you see, look for the connectors or plugins settings of the app.

## Claude

Custom connectors are available on all Claude plans. On the Free plan you can add one custom connector.

### Add the connector yourself

Use these steps on a Free, Pro or Max plan, or on a Team or Enterprise plan when your organisation lets members add their own connectors.

**1. Open the connector settings**

In Claude, go to **Customize → Connectors**.

**2. Add a custom connector**

Select **Add**, then **Add custom connector**. Enter a name, for example `Alumio`, and the server address. Click **Continue**.

**3. Keep the sign-in settings**

Claude detects that the Alumio MCP server uses sign-in. Keep the detected settings and click **Add**. You don't need to enter a client ID, secret or request headers.

**4. Sign in to Alumio**

Click **Connect**. Alumio opens in a new window. Sign in if you aren't already, check the account, environment and access, and choose **Allow access**. You return to Claude.

### Add the connector for your organisation

On a Team or Enterprise plan, an owner can add the connector once for everyone:

1. Go to **Organization settings → Connectors**.
2. Select **Add**, then **Custom**. If Claude asks for the type, choose **Web**.
3. Enter a name and the server address, keep the detected sign-in settings and click **Add**.

Each member then goes to **Customize → Connectors**, finds the connector with the **Custom** label and clicks **Connect**. Every member signs in with their own Alumio account, so each person keeps their own role.

### Use it in a chat

Start a new chat and ask a question about your environment, for example "Which tasks failed in the last 24 hours?". To turn the connector on or off for a chat, click **+** in the message box and open **Connectors**.

Claude asks for your approval before it uses a tool. Choose **Always allow** only for tools you trust to run without a check. To prevent a tool from being used, open the connector under **Customize → Connectors** and set the tool's permission to **Blocked**. Blocking `change_task_status` and `control_queue_jobs` keeps the connector read-only for you.

## ChatGPT

ChatGPT adds MCP servers as plugins in the browser. Whether you can add one depends on your ChatGPT plan and, in a business workspace, on the permissions your workspace admin has set.

**1. Open plugins**

Go to [chatgpt.com/plugins](https://chatgpt.com/plugins) and select the **+** button. Choose **Add custom MCP server**.

**2. Enter the server details**

Enter a name, for example `Alumio`, and optionally a description. Under **Connection**, enter the server address in **Server URL**.

**3. Choose OAuth**

Set the authentication to **OAuth**. You don't need to enter a client ID or secret.

**4. Create the plugin**

Read the warning about custom servers, select **I understand and want to continue**, then **Create as a plugin**.

**5. Install and sign in**

Install the plugin. ChatGPT sends you to Alumio, where you check the account, environment and access, and choose **Allow access**.

To use Alumio in a conversation, type `@` in the message box and select the plugin. ChatGPT asks you to confirm each tool that can change data. You can remember your choice for the rest of the conversation. In the plugin's details page you can turn individual tools off.

## Troubleshooting

**The sign-in page says the request is unavailable or has expired.** The sign-in request is valid for ten minutes. Start again from the AI app.

**The assistant says it isn't allowed to use a tool.** Your role doesn't allow it, or the connection has view access only. A new role applies straight away, so ask an administrator for the Editor role if you need it. If the connection has view access only, remove the connector, add it again and check that the sign-in page lists **Make changes in this environment**.

**The assistant can't find a route or configuration you can see in Alumio.** Check that the server address points to the Space that holds it.

**The connector asks you to sign in again.** This happens when you haven't used it for 30 days. Sign in again to continue.


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