Installation

Prerequisites

• macOS or Linux machine
• Claude Desktop client installed on your machine
• Your Blotout Cloud environment must be onboarded

Setup

Manual Setup

Claude Desktop Configuration

Add the following to your claude_desktop_config.json:

macOS path: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "blotout-athena-api-mcp-service-remote-mcp": {
      "command": "npx",
      "args": ["mcp-remote", "https://<host-name>/stream"],
      "name": "blotout-athena-api-mcp-service-remote-mcp"
    }
  }
}

Replace <host-name> with your Blotout Cloud MCP server hostname.

Restart Claude Desktop

After making configuration changes:

1. Quit Claude Desktop completely
2. Restart it:

   open -a "Claude"

Verify the Server

Open Claude Desktop and navigate to Settings → Developer to verify the MCP server is configured.

Before configuration — the Developer settings will show “No servers added”:

After configuration — the server should appear with a “running” status:

Enable the MCP Server

In the Claude Desktop chat interface, click the settings icon next to the message input and toggle on the blotout-athena-api-mcp-ser... connector:

You can now start querying your data lake using natural language prompts. Before your first query, complete the Login steps to authenticate with Blotout Cloud.

Troubleshooting

If there are errors, check the logs at:

~/Library/Logs/Claude/blotout-athena-api-mcp-service.log

Quick Installer

Step 1: Download the Installer

Download mcp-installer.sh

Or download via terminal:

curl -O https://cloud-docs.blotout.io/mcp-installer.sh

Step 2: Run the Installer

chmod +x mcp-installer.sh

./mcp-installer.sh "https://<your-org>-ui-<env>.blotout.io/stream"

Replace the URL with your MCP server endpoint. For example:

./mcp-installer.sh "https://multitenant-ui-preprod.blotout.io/stream"

The installer automatically:

• Installs Homebrew (if not present)
• Installs Node.js, npm, and jq
• Installs the mcp-remote package globally
• Configures Claude Desktop by updating claude_desktop_config.json
• Creates a backup of any existing Claude config

Once complete, you should see the installation output confirming success:

Step 3: Verify the Server

Open Claude Desktop and navigate to Settings → Developer to verify the MCP server is configured.

Before running the installer — the Developer settings will show “No servers added”:

After running the installer — the server should appear with a “running” status:

Step 4: Enable the MCP Server

In the Claude Desktop chat interface, click the settings icon next to the message input and toggle on the blotout-athena-api-mcp-ser... connector:

You can now start querying your data lake using natural language prompts. Before your first query, complete the Login steps to authenticate with Blotout Cloud.