MCP Setup — Claude Desktop

This guide walks you through connecting the Ailyx MCP Server to Claude Desktop. The same server URL (https://mcp.ailyx.co) works with any MCP-compatible client.

Prerequisites

• A Ailyx account with at least one connected database.
• Claude Desktop installed on your machine.

Method 1: Connectors UI (Recommended)

1. Open Connectors

In Claude Desktop, go to Chat > Customize > Connectors. Click the + icon in the top-right corner and select Add custom connector.

2. Add the Ailyx connector

Fill in the following fields:

Field	Value
Name	Ailyx
Remote MCP server URL	https://mcp.ailyx.co

Click Add.

3. Authenticate

Claude Desktop will open a browser window for you to log in with your Ailyx account. After granting access, you’re all set.

Method 2: JSON Config

1. Open Claude Desktop config

Navigate to Settings > Developer > Edit Config. This opens the claude_desktop_config.json file.

2. Add the Ailyx MCP server

Add the following to the mcpServers section of your config file:

{
  "mcpServers": {
    "ailyx": {
      "url": "https://mcp.ailyx.co"
    }
  }
}

3. Save and restart Claude Desktop

Save the config file and restart Claude Desktop. You should see “ailyx” appear in the MCP servers list. The first time you use a Ailyx tool, Claude Desktop will open a browser window for you to authenticate.

Usage

Once connected, you can ask Claude questions about your data:

“Using Ailyx, what were our top 10 customers by revenue last quarter?”

“Search my database tables for anything related to user signups”

“List all my saved dashboards in Ailyx”

Claude will automatically use the appropriate MCP tool to answer your question.

Follow-up questions

The ask_question tool supports conversation threads. When you ask a follow-up, Claude passes the thread_id from the previous response to maintain context:

“Now break that down by region”

“Show me the monthly trend instead”

Troubleshooting

“Not authenticated” error

Your OAuth token may have expired. Restart Claude Desktop to trigger a fresh authentication flow.

“No active connection” error

Make sure you have an active database connection in Ailyx. Log in to app.ailyx.co and verify your connection is set as active.

Slow responses from ask_question

The ask_question tool runs a full AI pipeline (table selection, SQL generation, execution). This typically takes 10–30 seconds but can take up to 2 minutes for complex queries. Other tools (list_tables, search_tables, etc.) respond in under 2 seconds.