メインコンテンツへスキップ
メインコンテンツへスキップ

ClickHouse Cloud リモート MCP サーバーの有効化

このガイドでは、ClickHouse Cloud リモート MCP サーバーを有効化して使用する方法を説明します。ここでは例として Claude Code を MCP クライアントとして使用しますが、MCP をサポートする任意の LLM クライアントを使用できます。

ClickHouse Cloud サービスでリモート MCP サーバーを有効化する​

  1. ClickHouse Cloud サービスに接続し、Connect ボタンをクリックして、対象サービスの Remote MCP Server を有効化します。
Connect モーダルで MCP を選択
MCP Server を有効化
  1. Connect ビュー、または以下に表示されている ClickHouse Cloud MCP Server の URL をコピーします。
https://mcp.clickhouse.cloud/mcp

Claude Code に ClickHouse MCP Server を追加する​

  1. 作業ディレクトリ内で、次のコマンドを実行して ClickHouse Cloud MCP Server の設定を Claude Code に追加します。この例では、Claude Code の設定内で MCP サーバーに clickhouse_cloud という名前を付けています。
claude mcp add --transport http clickhouse_cloud https://mcp.clickhouse.cloud/mcp

1b. 使用している MCP クライアントによっては、JSON 設定を直接編集することもできます

{
  "mcpServers": {
    "clickhouse-remote": {
      "url": "https://mcp.clickhouse.cloud/mcp"
    }
  }
}
  1. 作業ディレクトリ内で Claude Code を起動する
[user@host ~/Documents/repos/mcp_test] $ claude

OAuth を使用して ClickHouse Cloud に対して認証する​

  1. 最初のセッションでは、Claude Code がブラウザウィンドウを開きます。そうでない場合は、Claude Code で /mcp コマンドを実行し、clickhouse_cloud MCP サーバーを選択して接続を開始できます。

  2. ClickHouse Cloud の認証情報を使用して認証します。

OAuth 接続フロー
OAuth 接続フローの成功

Claude Code から ClickHouse Cloud Remote MCP Server を使用する​

  1. Claude Code でリモート MCP サーバーが接続されていることを確認します。
Claude Code MCP 成功
Claude Code MCP の詳細
  1. おめでとうございます。これで Claude Code から ClickHouse Cloud Remote MCP Server を使用できるようになりました。
Claude Code MCP の利用例

この例では Claude Code を使用しましたが、同様の手順に従うことで、MCP をサポートする任意の LLM クライアントを使用できます。