Skip to main content
すべてのユーザーが Cloud Console を通じて ClickHouse を利用しているわけではありません。 たとえば、多くの開発者は使い慣れたコードエディタや CLI エージェントから直接作業したり、独自の構成でデータベースに接続したりしています。一方で、Anthropic Claude のような汎用 AI アシスタントを使って、調査や探索の大半を進めるユーザーもいます。 こうしたユーザーや、その代わりに動作するエージェント型ワークロードには、複雑なセットアップやカスタムのインフラストラクチャなしで、ClickHouse Cloud に安全にアクセスしてクエリを実行できる手段が必要です。 ClickHouse Cloud の リモートMCPサーバー機能は、外部エージェントが分析コンテキストを取得するために利用できる標準インターフェイスを提供することで、この課題に対応します。 MCP (Model Context Protocol) は、LLM を利用した AI アプリケーションが構造化データにアクセスするための標準です。 このインテグレーションにより、外部エージェントはデータベースやテーブルの一覧表示、スキーマの確認、スコープが制限された読み取り専用の SELECT クエリの実行を行えます。 認証は OAuth 2.0 または ClickHouse Cloud API キー で行います。サーバーは ClickHouse Cloud 上で完全マネージド型として提供されるため、セットアップや保守は不要です。 これにより、分析、要約、コード生成、探索などの用途に応じて、エージェント型ツールは ClickHouse に簡単に接続し、必要なデータを取得できるようになります。

リモートMCPサーバーとオープンソースMCPサーバーの比較

ClickHouse には、2 つのMCPサーバーがあります。 リモートMCPサーバーは、管理すべきインフラストラクチャなしで、サービス管理、バックアップ監視、ClickPipe の可視化、請求データなどを含む、ClickHouse Cloud との最も充実したインテグレーションを提供します。 セルフホストの ClickHouse インスタンスについては、オープンソースMCPサーバーのガイドを参照してください。

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

リモートMCPサーバーが接続を受け付けられるようにするには、事前に各サービスごとに有効化する必要があります。 ClickHouse Cloudコンソールで対象のサービスを開き、Connect ボタンをクリックして MCP を選択し、有効化してください。 リモートMCPサーバーの有効化・無効化には、control-plane:service:manage-mcp のアクセス許可が必要です (詳しくはコンソールのロールとアクセス許可を参照してください) 。 スクリーンショット付きの詳しい手順については、セットアップガイドを参照してください。

エンドポイント

有効にすると、リモートMCPサーバーは次のエンドポイントで利用できます。

認証

リモートMCPサーバーは、次の2つの認証方式をサポートしています。
  • OAuth 2.0: 対話型クライアントに推奨される方式です。MCP クライアントが初めて接続すると、ブラウザウィンドウが開き、ユーザーは ClickHouse Cloud の認証情報でサインインします。アクセスできる範囲は、認証されたユーザーがアクセス許可を持つ組織およびサービスに限られます。
  • ClickHouse Cloud API キー: ブラウザベースの OAuth フローを利用しにくいリモート環境、ヘッドレス環境、自動化環境向けの方式です。API キー ID とシークレットを HTTP Basic 認証で送信します。
API キーによるアクセス範囲は、そのキーに設定されたロール、アクセス許可、有効期限によって決まります。最小権限の専用キーを使用し、シークレット管理システム経由で注入してください。Base64 エンコードは認証情報を暗号化するものではありません。エンコードした値をソース管理にコミットしたり、ログに出力したりしないでください。 ヘッドレス環境で MCP クライアントを設定する例については、ヘッドレス環境からの認証を参照してください。

安全性

リモートMCPサーバーで公開されるすべてのツールは読み取り専用です。各ツールのMCPメタデータには readOnlyHint: true の注記が付いています。データの変更、サービス設定の変更、または破壊的な操作を実行できるツールはありません。

利用可能なツール

リモートMCPサーバーは、以下のカテゴリに分類された13個のツールを提供しています。

クエリとスキーマの探索

これらのツールを使用すると、エージェントは利用可能なデータを確認し、分析クエリを実行できます。

組織

サービス

バックアップ

ClickPipes

請求

はじめに

リモートMCPサーバーを有効にし、MCPクライアントに接続する手順については、セットアップガイドを参照してください。