ClickHouse Cloud Remote MCP Server を有効にして接続する

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

前提条件

• 稼働中の ClickHouse Cloud サービス
• 任意の IDE または AI エージェント型開発ツール

Cloud 向けのリモートMCPサーバーを有効にする

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

"Connect with MCP" を選択します:

ボタンをオンに切り替えて、そのサービスの MCP を有効にします:

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

https://mcp.clickhouse.cloud/mcp

開発用にリモートMCPをセットアップする

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

Claude Code

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

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

次に、Claude Code を起動します。

claude

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

/mcp

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

Claude Web UI

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

Cursor

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

Visual Studio Code

次の設定を .vscode/mcp.json に追加してください。

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

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

Windsurf

以下の設定で mcp_config.json ファイルを編集します。

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

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

Zed

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

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

Zed は、初めてサーバーに接続すると、OAuth による認証を求めるプロンプトを表示するはずです。 詳細については、Zed のドキュメントを参照してください

Codex

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

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

関連コンテンツ

• ClickHouse agent のスキル