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

ClickHouse Cloud リモート MCP サーバーを有効にする

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

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

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

Claude Code に ClickHouse MCP サーバーを追加する​

  1. 作業ディレクトリで次のコマンドを実行して、ClickHouse Cloud MCP サーバーの設定を 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サーバーを使用する​

  1. Claude CodeでリモートMCPサーバーが接続されていることを確認してください
Claude Code MCP success
Claude Code MCP Details
  1. 完了です。これでClaude CodeからClickHouse Cloud Remote MCPサーバーを使用できます
Claude Code MCP Usage

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