メインコンテンツへスキップ
このガイドでは、Open WebUI を ClickHouse MCPサーバーと連携させて設定し、 ClickHouse のサンプルデータセットに接続する方法を説明します。
1

uv をインストール

このガイドの手順に従うには、uv をインストールする必要があります。 uv を使わない場合は、別のパッケージマネージャーを使用するように MCPサーバーの設定を更新する必要があります。
2

Open WebUI を起動

Open WebUI を起動するには、次のコマンドを実行します。
UI を表示するには、http://localhost:8080/ にアクセスします。
3

ClickHouse MCPサーバーを設定

ClickHouse MCPサーバーを設定するには、MCPサーバーを Open API エンドポイントに変換する必要があります。 まず、ClickHouse SQL Playground に接続できるように環境変数を設定します。
次に、mcpo を実行して Open API エンドポイントを作成します。
http://localhost:8000/docs にアクセスすると、作成されたエンドポイントの一覧を確認できます。
Open API エンドポイント
これらのエンドポイントを Open WebUI で使用するには、設定画面に移動します。
Open WebUI の設定
Tools をクリックします。
Open WebUI のツール
ツール URL として http://localhost:8000 を追加します。
Open WebUI のツール
これが完了すると、チャットバーのツールアイコンの横に 1 が表示されます。
利用可能な Open WebUI のツール
ツールアイコンをクリックすると、利用可能なツールの一覧を表示できます。
Open WebUI のツール一覧
4

OpenAI を設定

Open WebUI はデフォルトで Ollama モデルに対応していますが、OpenAI 互換のエンドポイントも追加できます。 これらは設定メニューから構成しますが、今回は Connections タブをクリックする必要があります。
Open WebUI の接続
エンドポイントと OpenAI キーを追加します。
Open WebUI - 接続として OpenAI を追加
すると、OpenAI モデルが上部メニューから利用できるようになります。
Open WebUI - モデル
5

Open WebUI で ClickHouse MCPサーバーとチャット

その後、会話を開始すると、必要に応じて Open WebUI が MCPサーバーを呼び出します。
Open WebUI - ClickHouse MCPサーバーとチャット