Skip to main content
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.
  • 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 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.