メインコンテンツまでスキップ
メインコンテンツまでスキップ

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

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

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

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

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

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

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

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