---
title: "Use Alis from Claude"
description: "Add Alis to Claude as a connector, sign in with your AlisX user, and hand work to Alis from a Claude chat."
url: "https://docs.alisx.com/how-to/alis/use-alis-from-claude/"
---
# Use Alis from Claude

Add Alis to Claude as a connector, sign in, and hand work to Alis from a Claude chat. Claude talks to the same Alis you chat with in the console, signed in as you.

## Prerequisites

- An AlisX user, and an [active account](https://docs.alisx.com/how-to/account/switch-your-active-account.md) with [billing set up](https://docs.alisx.com/how-to/account/set-up-billing.md). Alis works against that account, as it does in the console.
- Claude on the web or the Claude desktop app.
- On a Claude Team or Enterprise plan: an Owner of your Claude organisation, to add the connector once for everyone.

## Add the connector

1. In Claude, open **Customize**, then **Connectors**.
2. Select **Add**, then **Add custom connector**.
3. Enter a name, such as `Alis`, and this server URL, then select **Continue**:

    ```text title="MCP server URL"
    https://mcp.agent.alisx.com
    ```

4. Under **Advanced**, choose **Use your own OAuth client** and enter this client ID. Leave the secret blank:

    ```text title="Client ID"
    0f29254c-954f-4c26-bc7c-58c1f1dce654
    ```

5. Select **Add**.

On a Team or Enterprise plan, an Owner does this under **Organization settings**, then **Connectors**: select **Add**, then **Custom**, and choose **Web** if Claude asks for the connector type. The connector then appears for every member under **Customize**, **Connectors**, with the **Custom** label.

Claude does not let you change these settings afterwards. To correct one, remove the connector and add it again.

## Sign in

1. On the connector, select **Connect**.
2. Sign in as you do at [console.alisx.com](https://console.alisx.com), with the email address your account knows you by, and approve the access Claude asks for: reading your chats with Alis, and writing to them.

Claude returns to the connector, now connected. Each person signs in as themselves, so Alis sees only what you can see.

The sign-in lasts seven days. After that, Claude asks you to connect again.

## Hand work to Alis

1. In a Claude chat, select **+**, then **Connectors**, and turn Alis on.
2. Ask in plain words. For example:

    - "Ask Alis to summarise what we learned in the Onboarding project."
    - "Carry on my last chat with Alis and ask it to deploy the fix to Development."
    - "What is Alis waiting on?"

Claude asks for your permission before it uses a tool. Read what it is about to send, above all when it answers an approval for you.

## What Claude can do with Alis

| Tool | What it does | Changes anything |
|---|---|---|
| Send a message | Starts a new chat with Alis, or carries on one you name, and waits for the answer. | Yes |
| Wait for a reply | Keeps following work that outlasted the first wait. | No |
| List sessions | Your chats with Alis, most recent first. | No |
| Get a session | A chat's state and its recent messages. | No |
| Respond to an approval | Approves or declines what Alis asked before it changes something. | Yes |
| Cancel a turn | Stops what Alis is doing in a chat. | Yes |
| Read a file | A file Alis wrote in your workspace. | No |
| Get status | Who is signed in, and whether Alis can use the CLI as you. | No |

Alis asks before it changes anything that matters, in Claude as in the console. Claude shows you what Alis wants to do, and nothing happens until you approve it.

### Long work

Alis keeps working after Claude stops waiting. A build or a deploy can take longer than Claude waits on one request, so Claude tells you the work is still running. Ask "is it done?" and Claude picks it up where it left off.

### The same chats as the console

A chat you start from Claude is an ordinary chat with Alis. It appears under **Chats** in the console's navigation pane, and you can carry it on from either side.

## Read your skills in Claude Code

The connector also gives Claude the skills you can see in the [Skill store](https://docs.alisx.com/reference/skill-store.md): your own, the ones shared with you and the platform's. Claude sees each skill as a document: its `SKILL.md`, with the files it refers to.

Claude Code uses the connectors of your Claude account, so once Alis is connected there you need no further sign-in. Ask in plain words. For example:

- "List my Alis skills."
- "Read my Alis skill `getting-started` and follow it."

Claude Code finds each skill by its name and description and opens it when you ask. Steps in a skill that need the `alis` CLI run where the CLI is signed in: on your own machine in Claude Code, or in your workspace when you hand the task to Alis.

## Your data

- Claude reaches Alis only as you, after you sign in and approve the access. It can do nothing your own user cannot.
- Claude can read the skills you can see in the Skill store: each skill's name and description when it lists them, and a skill's files when it opens one. It sees no skill your own user cannot.
- The connector keeps nothing: it passes each request to Alis and the answer back. Your chats, files and projects stay where they are, in your AlisX account.
- Alis receives what Claude sends it: the message Claude writes for you, and your answers to its questions and approvals. Nothing else from your Claude conversation reaches AlisX.

## Disconnect

In Claude, open **Customize**, then **Connectors**, select the connector, and select **Remove**. Your chats with Alis stay in the console.

## Get help

If the connector does not connect, or a tool fails, [talk to a Specialist](https://docs.alisx.com/how-to/help/get-support.md) and say what Claude showed you.

## Related

- [Alis](https://docs.alisx.com/reference/alis.md): where you chat with Alis in the console.
- [Glossary: Alis](https://docs.alisx.com/reference/glossary.md)