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

# How to connect with Claude

> How to configure Claude Desktop to connect to the Atoti MCP Server, including the `mcpServers` JSON configuration block, `mcp-remote` via `npx`, Base64 Basic Auth passkey generation, and tool discovery verification steps.

This guide explains how to connect Claude Desktop to the Atoti MCP server.

## Prerequisites

Before connecting Claude, ensure the following requirements are met:

* Atoti MCP server is set up and running
* Claude Desktop is installed
* Access to Claude Desktop configuration file
* Atoti application credentials (username and password)

## Configure Claude Desktop

Add the MCP server configuration to the Claude Desktop config file. The location of this file depends on the operating system.

The following examples assume the application runs locally on port `9090`. Replace `9090` with the port on which the application is running.

### Option 1: Basic authentication

The following example uses HTTP Basic authentication. Replace `{passkey}` with a Base64-encoded string in the format `Base64(<login>:<password>)`.

```json theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
{
  "mcpServers": {
    "my-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:9090/sse",
        "--header",
        "Authorization: Basic {passkey}",
        "--header",
        "Content-Type: application/json",
        "--header",
        "Accept: text/event-stream",
        "sse-only"
      ]
    }
  }
}
```

### Option 2: Bearer token authentication

The following example uses a long-lived JWT bearer token. Replace `<jwt>` with a token generated from the [MCP credentials page](./mcp-credentials-page).

```json theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
{
  "mcpServers": {
    "my-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:9090/sse",
        "--header",
        "Authorization: Bearer <jwt>",
        "--header",
        "Content-Type: application/json",
        "--header",
        "Accept: text/event-stream",
        "sse-only"
      ]
    }
  }
}
```

The bearer token approach avoids embedding credentials in the configuration file. The MCP credentials page must be enabled in the application before a token can be generated.

## Generate the passkey

Replace `{passkey}` in the Basic authentication configuration with a Base64-encoded string.

Generate the passkey using the following format:

```
Base64(<login>:<password>)
```

Replace `<login>` and `<password>` with the Atoti application credentials.

## Verify the connection

After configuring Claude Desktop, verify that the connection works:

1. Restart Claude Desktop
2. Check that Claude discovers the MCP server tools

<Frame>
  <img src="https://mintcdn.com/activeviam/J0McnvoVg4x05kNG/atoti-intelligence/6.1/images/claude_tool_discovery.png?fit=max&auto=format&n=J0McnvoVg4x05kNG&q=85&s=eded9b04b7a14149b6ce7e43b5e117ad" alt="Tool Discovery" width="670" height="656" data-path="atoti-intelligence/6.1/images/claude_tool_discovery.png" />
</Frame>

3. Test interaction with the Atoti server by asking Claude to use the available tools

<Frame>
  <img src="https://mintcdn.com/activeviam/J0McnvoVg4x05kNG/atoti-intelligence/6.1/images/claude_answer1.png?fit=max&auto=format&n=J0McnvoVg4x05kNG&q=85&s=b7b1eb11ff17fba6104bbe1b80e5d737" alt="Claude Answer 1" width="766" height="1192" data-path="atoti-intelligence/6.1/images/claude_answer1.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/activeviam/J0McnvoVg4x05kNG/atoti-intelligence/6.1/images/claude_answer2.png?fit=max&auto=format&n=J0McnvoVg4x05kNG&q=85&s=a19aa1a0f4b22c2ff3c69a7037667ab3" alt="Claude Answer 2" width="958" height="930" data-path="atoti-intelligence/6.1/images/claude_answer2.png" />
</Frame>

## Troubleshooting

If Claude does not discover the tools, check the following:

* The Atoti application is running and accessible
* The MCP server endpoint is available at the configured URL
* The passkey is correctly formatted and encoded
* The Claude Desktop configuration file is valid JSON

## Related reading

After connecting Claude, explore additional capabilities:

* [Add custom tools](../custom-tools) to extend MCP server functionality