MCP 経由で ClickHouse Cloud を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → ClickHouse Cloud をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

ClickHouse Cloud + Gemini

AI エージェントから ClickHouse Cloud の組織を管理：状態、エンドポイント、スケーリング付きでサービスを一覧し、起動、停止、ウェイクを行い、IP アクセス、タグ、オートスケーリングを変更し、バックアップと ClickPipes を確認し、ClickHouse Credits 単位の利用コストと残りのクレジットを読み、通知、クォータ、メンバー、ロール、API キー、監査ログを参照できます。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

CLICKHOUSE_CLOUD_KEY_ID, CLICKHOUSE_CLOUD_KEY_SECRET

ステップ 1 — 認証情報を取得

設定は約 3 分です。組織の ClickHouse Cloud コンソールへのアクセスが必要です。

1. ClickHouse Cloud コンソール（https://console.clickhouse.cloud）で Organization、API keys を開き、New API key をクリックします。
2. 名前、有効期限、任意で IP 許可リスト、そして必要なロールを設定します。読み取りだけなら read-only か developer のロールで十分です。サービスの起動、停止、スケーリング、更新には admin か、サービス管理の権限を持つカスタムロールが必要です。
3. Key ID を CLICKHOUSE_CLOUD_KEY_ID に、Key secret を CLICKHOUSE_CLOUD_KEY_SECRET にコピーします。シークレットは一度しか表示されません。失くした場合は新しいキーを作成してください。API は両方を HTTP Basic 認証（Key ID がユーザー名、シークレットがパスワード）として受け取ります。
4. コネクタをインストールし、clickhouse_cloud_list_organizations を実行します。ほかのすべてのツールが必要とする organization_id が返り、キーを確認できます。

このコネクタは Cloud のコントロールプレーン（https://api.clickhouse.cloud/v1）と通信し、SQL は実行しません。テーブルへのクエリには、サービスの HTTPS インターフェースを使う ClickHouse コネクタをインストールしてください。

読み取れるもの:

• 組織とキー: clickhouse_cloud_list_organizations、clickhouse_cloud_get_organization（プライベートエンドポイント、BYOC 設定）、clickhouse_cloud_whoami（キー、その組織とロール。ClickHouse のベータ版エンドポイント）。
• サービス: clickhouse_cloud_list_services（tag:Environment=Production のようなタグで絞り込み可能）と clickhouse_cloud_get_service で、状態、クラウドプロバイダーとリージョン、ClickHouse のバージョン、ティア、エンドポイント、レプリカのメモリと数、アイドルスケーリング、IP アクセスリスト、リリースチャネル、タグを確認できます。clickhouse_cloud_get_service_settings は既定値と異なるサーバー設定を、clickhouse_cloud_get_service_metrics は現在の Prometheus メトリクスをテキストで返します（filtered_metrics で厳選した短いリスト）。
• バックアップ: clickhouse_cloud_list_backups、clickhouse_cloud_get_backup（状態、開始と終了、サイズ、所要時間、フルか増分か）、clickhouse_cloud_get_backup_configuration（バックアップ間隔、保持期間、毎日の開始時刻）。
• 取り込み: Kafka、S3、Postgres、MySQL などからの ClickPipes 用の clickhouse_cloud_list_clickpipes と clickhouse_cloud_get_clickpipe。ClickPipes の管理権限を持つキーが必要です。
• コストと状態: clickhouse_cloud_get_usage_cost は日別、エンティティ別（データウェアハウス、サービス、ClickPipe）のコストを内訳のメトリクス（コンピュート、ストレージ、バックアップ、データ転送）付きで返します。clickhouse_cloud_get_credit_balances（請求の閲覧権限が必要）、clickhouse_cloud_list_notifications（請求、サービスの状態、ClickPipe の障害、アップグレード。重要度、種類、リソース、日付で絞り込み可能）、clickhouse_cloud_list_quotas もあります。
• メンバーとアクセス: clickhouse_cloud_list_members、clickhouse_cloud_list_invitations、clickhouse_cloud_list_roles、clickhouse_cloud_list_api_keys（シークレットは返されません）、そして実行者、IP アドレス、対象 ID 付きの監査ログ clickhouse_cloud_list_activities。

変更できるもの:

• clickhouse_cloud_change_service_state はサービスを起動、停止、ウェイク（awake）します。停止するとコンピュートが止まります。データは保持され、コンピュートの課金も止まりますが、再起動するまでクエリは失敗するため、AI は事前に確認します。
• clickhouse_cloud_update_service はサービス名の変更、リリースチャネル（slow、default、fast）の設定、IP アクセスリストのエントリとタグの追加や削除を行います。渡したフィールドだけが変わり、削除は追加より先に実行されます。
• clickhouse_cloud_update_replica_scaling はレプリカあたりのメモリ（最小と最大、GB 単位で 4 の倍数。メモリ上限は Production ティアのみ）、オートスケーリングのモード、レプリカ数、アイドルスケーリング、アイドルタイムアウト（5 分以上）を変更します。
• clickhouse_cloud_change_clickpipe_state は ClickPipe を開始、停止、再同期します。再同期ではソーステーブルがもう一度コピーされるため、AI はあなたに確認します。
• clickhouse_cloud_create_invitation は clickhouse_cloud_list_roles のロール ID を指定して、メールで人を招待します。

インストール後は 26 個のツールがすべて有効で、無効化されているものはありません。AI に閲覧だけをさせたい場合は、キーに read-only のロールを付けてください。

データ形式: 応答はすべて {status, requestId, result} で、データは result にあります。ID は UUID、時刻は UTC の ISO 8601 です。コストは ClickHouse Credits（CHC）で、期間全体が grandTotalCHC、レコードごとが totalCHC です。メモリは GB、バックアップのサイズはバイト、所要時間は秒です。サービスの state は starting または stopping を経て running か stopped になります。idle はゼロまでスケールダウンした状態で、次のクエリで起動します。

ページング: clickhouse_cloud_list_organizations、clickhouse_cloud_list_api_keys、clickhouse_cloud_list_notifications は limit（最大 250）を受け取り、続きがあると nextCursor を返します。AI はそれがなくなるまで cursor として渡します。ほかの一覧は一度にすべて返ります。

制限: 利用コストのレポートは 1 回あたり最大 31 日（to_date は from_date の最大 30 日後）です。それより長い期間は、AI が複数回に分けて呼び出します。API にはキーごとのレート制限があります。

よくあるエラー: 401 は Key ID かシークレットの誤り、またはキーの期限切れや無効化を意味します。403 はキーのロールにその呼び出しの権限がない（請求、ClickPipes、サービス管理は別々の権限です）か、呼び出し元の IP がキーの許可リストに含まれていないことを意味します。AnythingMCP Cloud ではサーバーの送信元 IP を、セルフホストでは自分のサーバーの IP を追加してください。404 は組織、サービス、バックアップの ID の誤りです。429 はレート制限なので、数秒待ってから再試行してください。

このコネクタは SQL を実行せず、サービスの作成や削除、バックアップの復元や削除、API キーの作成や失効、メンバーの削除は行いません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が ClickHouse Cloud のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「ClickHouse Cloud のサービスのうち、今動いているのはどれで、アイドルや停止中なのはどれですか？」
• 「10 月に使った ClickHouse Credits をサービス別に教えてください。いちばんコストが高かったのは何日ですか？」
• 「本番サービスの昨夜のバックアップは完了しましたか？ サイズと所要時間を見せてください。」
• 「ステージングサービスの IP アクセスリストに、説明『オフィス』で 203.0.113.0/24 を追加してください。」
• 「直近 7 日間にサービスを停止またはスケーリングしたのは誰ですか？ 監査ログのエントリを見せてください。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Cursor に接続
• Meta Muse に接続
• Microsoft Copilot に接続