Skip to main content

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.

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>). 
{
  "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. 
{
  "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
Tool Discovery
  1. Test interaction with the Atoti server by asking Claude to use the available tools
Claude Answer 1
Claude Answer 2

​
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
After connecting Claude, explore additional capabilities: