Skip to main content
Skip to main content
Edit this page

Enabling the ClickHouse Cloud Remote MCP Server

This guide explains how to enable and use the ClickHouse Cloud Remote MCP Server. We will use Claude Code as an MCP Client for this example.

Note

The remote server capability is currently available in private preview only. Join the waitlist by filling out the form at clickhouse.ai

Enable the remote MCP server for your ClickHouse Cloud service​

  1. Connect to your ClickHouse Cloud Service, click on the Connect button, and enable the Remote MCP Server for your Service
  1. Copy the URL of the ClickHouse Cloud MCP Server from the Connect view or below

Add the ClickHouse MCP Server in Claude Code​

  1. In your working directory, run the following command to add the ClickHouse Cloud MCP Server configuration to Claude Code. In this example, we named the MCP server in the Claude Code config clickhouse_cloud

1b. Depending on the MCP Client used, you can also edit the JSON config directly

  1. Launch Claude Code in your working directory

Authenticate to ClickHouse Cloud via OAuth​

  1. Claude Code will open a browser window on the firgst session. Otherwise, you can also trigger a connection by running the /mcp command in Claude Code and selecting the clickhouse_cloud MCP server

  2. Authenticate using your ClickHouse Cloud credentials

Use the ClickHouse Cloud Remote MCP Server from Claude Code​

  1. Verify in Claude Code that the remote MCP server is connected
  1. Congratulations! You can now use the ClickHouse Cloud Remote MCP Server from Claude Code