Skip to main content
Skip to main content
Edit this page

Enable and connect ClickHouse Cloud Remote MCP Server

This guide shows you how to enable the ClickHouse Cloud Remote MCP Server and set it up for use with common developer tools.

Prerequisites

Enable remote MCP server for Cloud​

Connect to the ClickHouse Cloud service for which you want to enable remote MCP server, click on the Connect button in the left hand menu. A box with connection details will open.

Select "Connect with MCP":

Toggle the button on to enable MCP for the service:

Copy the displayed URL, which is the same as the one below:

https://mcp.clickhouse.cloud/mcp

Setup remote MCP for development​

Choose your IDE or tool below and follow the corresponding setup instructions.

Claude Code​

From your working directory, run the following command to add the ClickHouse Cloud MCP Server configuration to Claude Code:

claude mcp add --transport http clickhouse-cloud https://mcp.clickhouse.cloud/mcp

Then launch Claude Code:

claude

Run the following command to list MCP servers:

/mcp

Select clickhouse-cloud and authenticate via OAuth using your credentials for ClickHouse Cloud.

Claude web UI​

  1. Navigate to Customize > Connectors
  2. Click the "+" icon and Add custom connector
  3. Give the custom connector a name like clickhouse-cloud and add it
  4. Click the newly added clickhouse-cloud connector and click Connect
  5. Authenticate using your ClickHouse Cloud credentials via OAuth

Cursor​

  1. Browse and install MCP servers from the Cursor Marketplace.
  2. Search for ClickHouse and click "Add to Cursor" on any server to install it
  3. Authenticate with OAuth.

Visual Studio Code​

Add the following configuration to your .vscode/mcp.json:

{
  "servers": {
    "clickhouse-cloud": {
      "type": "http",
      "url": "https://mcp.clickhouse.cloud/mcp"
    }
  }
}

For more details refer to the Visual Studio Code docs

Windsurf​

Edit your mcp_config.json file with the following config:

{
  "mcpServers": {
    "clickhouse-cloud": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.clickhouse.cloud/mcp"]
    }
  }
}

For more details refer to the Windsurf docs

Zed​

Add ClickHouse as a custom server. Add the following to your Zed settings under context_servers:

{
  "context_servers": {
    "clickhouse-cloud": {
      "url": "https://mcp.clickhouse.cloud/mcp"
    }
  }
}

Zed should then prompt you to authenticate via OAuth when it first connects to the server. For more details refer to the Zed docs

Codex​

Run the following command to add the ClickHouse Cloud MCP server via the CLI:

codex mcp add clickhouse-cloud --url https://mcp.clickhouse.cloud/mcp

Related content​