ClickHouse Cloud のリモートMCPサーバーを有効にして接続する

このガイドでは、ClickHouse Cloud リモートMCPサーバーを有効にし、一般的な開発ツールで使用できるよう設定する方法を説明します。

前提条件

• 稼働中のClickHouse Cloud サービス
• 使用する IDE またはエージェント型開発ツール

リモートMCPサーバーを有効にする対象の ClickHouse Cloud サービスに接続します。 左側のメニューで Connect をクリックします。接続の詳細が表示されたボックスが開きます。

Connect with MCP を選択します。

サービスで MCP を有効にするには、ボタンをオンにします。

表示された URL をコピーします。これは以下の URL と同じです。

https://mcp.clickhouse.cloud/mcp

以下からお使いのIDEまたはツールを選択し、対応するセットアップ手順に従ってください。

作業ディレクトリで次のコマンドを実行し、ClickHouse Cloud MCPサーバーの設定をClaude Codeに追加します。

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

続いて、Claude Code を起動します。

claude

MCPサーバーを一覧表示するには、次のコマンドを実行します。

/mcp

clickhouse-cloud を選択し、ClickHouse Cloud の認証情報を使って OAuth 認証を行います。

1. Customize > Connectors に移動します
2. 「+」アイコンをクリックし、Add custom connector を選択します
3. カスタムコネクタに clickhouse-cloud などの名前を付けて追加します
4. 新しく追加した clickhouse-cloud コネクタをクリックし、Connect をクリックします
5. OAuth を使用して、ClickHouse Cloud の認証情報で認証します

1. Cursor Marketplace でMCPサーバーを探してインストールします。
2. ClickHouse を検索し、任意のサーバーで「Add to Cursor」をクリックしてインストールします
3. OAuth で認証します。

以下の設定を .vscode/mcp.json に追加します。

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

詳細については、Visual Studio Code ドキュメントを参照してください。

以下の設定でmcp_config.jsonファイルを編集してください。

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

詳しくは、Windsurf docsを参照してください。

ClickHouse をカスタムサーバーとして追加します。 Zed の設定の context_servers に、以下を追加します。

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

その後、Zed が初めてサーバーに接続する際に、OAuth による認証を求められるはずです。 詳しくは、Zed のドキュメントを参照してください。

CLIでClickHouse Cloud MCPサーバーを追加するには、次のコマンドを実行します。

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

接続したら、自然言語のプロンプトを使って ClickHouse Cloud を操作できます。 以下では、一般的なワークフローと、その際に MCPクライアントがバックグラウンドで呼び出すツールを紹介します。 利用可能なツールの一覧については、ツールリファレンスを参照してください。

まず、何が利用できるかを確認しましょう。

自然言語で質問すると、エージェントがそれを SQL に変換します。

run_select_query ツールで許可されているのは SELECT ステートメントのみです。すべてのクエリは読み取り専用です。

ClickHouse Cloud リソースの状況を把握できます。

• ClickHouse Agent Skills