Open WebUI と CData Connect AI を連携してリアルタイムの HubDB データと対話する

Yazhini G
Technical Marketing Engineer

CData Connect AI Remote MCP Server を活用して、Open WebUI のチャットインターフェースから HubDB のデータにリアルタイムかつ安全にアクセス・クエリできるようにします。

Open WebUI は、ホスト型の LLM API とローカルで提供されるモデルを、カスタマイズ可能な単一のインターフェースにまとめたオープンソースのセルフホスト型 AI チャットプラットフォームです。ツールサーバーフレームワークを通じて Model Context Protocol（MCP） をサポートしており、外部ツールやデータソースを設定することで、チャットがモデルの学習データの枠を超えてリアルタイムのシステムとやり取りできるようになります。

組み込みの MCP Server を介して Open WebUI を CData Connect AI と連携させると、Open WebUI はガバナンスの効いた状態でリアルタイムの HubDB のデータにアクセスできるようになります。これにより、自然言語のプロンプトを使ってカタログの一覧表示、スキーマの探索、HubDB のデータのレコードへのクエリが可能になり、すべてのデータアクセスは認可されたデータソースに対して安全に実行されます。

この記事では、Connect AI で HubDB への接続を設定し、必要な Personal Access Token を生成して、Open WebUI をインストールし、Connect AI MCP Server を登録、LLM プロバイダーを設定したうえで、Open WebUI のチャットインターフェースからリアルタイムの HubDB のデータにクエリを実行して連携を確認するまでの手順を説明します。

Step 1: Open WebUI 向けに HubDB への接続を設定

Open WebUI から HubDB への接続は、Connect AI の Remote MCP Server を介して実現します。Open WebUI から HubDB のデータと対話するには、まず Connect AI で HubDB 接続を作成・設定していきましょう。

Connect AI にログインし、Sources をクリックして、 Add Connection をクリックします

Add Connection パネルから HubDB を選択します

HubDB に接続するために必要な認証プロパティを入力します。
HubDBデータソースへの接続には、パブリックHubSpotアプリケーションを使用したOAuth認証とプライベートアプリケーショントークンを使用した認証の2つの方法があります。

カスタムOAuthアプリを使用する

すべてのOAuthフローでAuthSchemeを"OAuth"に設定する必要があります。特定の認証ニーズ（デスクトップアプリケーション、Webアプリケーション、ヘッドレスマシン）に必要な接続プロパティについては、ヘルプドキュメントを確認してください。

アプリケーションを登録し、OAuthクライアント認証情報を取得するには、以下の手順を実行してください。
1. HubSpotアプリ開発者アカウントにログインします。
  - アプリ開発者アカウントである必要があります。標準のHubSpotアカウントではパブリックアプリを作成できません。
2. 開発者アカウントのホームページで、アプリタブをクリックします。
3. アプリを作成をクリックします。
4. アプリ情報タブで、ユーザーが接続する際に表示される値を入力し、必要に応じて変更します。これらの値には、パブリックアプリケーション名、アプリケーションロゴ、アプリケーションの説明が含まれます。
5. 認証タブで、「リダイレクトURL」ボックスにコールバックURLを入力します。
  - デスクトップアプリケーションを作成する場合は、http://localhost:33333のようなローカルにアクセス可能なURLに設定します。
  - Webアプリケーションを作成する場合は、ユーザーがアプリケーションを承認した際にリダイレクトされる信頼できるURLに設定します。
6. アプリを作成をクリックします。HubSpotがアプリケーションとそれに関連する認証情報を生成します。
7. 認証タブで、クライアントIDとクライアントシークレットを確認します。これらは後でドライバーを設定する際に使用します。
8. スコープの下で、アプリケーションの意図する機能に必要なスコープを選択します。
  
  テーブルにアクセスするには、最低限以下のスコープが必要です：
  - hubdb
  - oauth
  - crm.objects.owners.read
9. 変更を保存をクリックします。
10. 統合に必要な機能にアクセスできる本番ポータルにアプリケーションをインストールします。
  - 「インストールURL（OAuth）」の下で、完全なURLをコピーをクリックして、アプリケーションのインストールURLをコピーします。
  - コピーしたリンクをブラウザで開きます。アプリケーションをインストールする標準アカウントを選択します。
  - アプリを接続をクリックします。結果のタブは閉じて構いません。
プライベートアプリを使用する

HubSpotプライベートアプリケーショントークンを使用して接続するには、AuthSchemeプロパティを"PrivateApp"に設定します。

以下の手順に従ってプライベートアプリケーショントークンを生成できます：
1. HubDBアカウントで、メインナビゲーションバーの設定アイコン（歯車）をクリックします。
2. 左サイドバーメニューで、統合 > プライベートアプリに移動します。
3. プライベートアプリを作成をクリックします。
4. 基本情報タブで、アプリケーションの詳細（名前、ロゴ、説明）を設定します。
5. スコープタブで、プライベートアプリケーションがアクセスできるようにしたい各スコープに対して読み取りまたは書き込みを選択します。
6. テーブルにアクセスするには、最低限hubdbとcrm.objects.owners.readが必要です。
7. アプリケーションの設定が完了したら、右上のアプリを作成をクリックします。
8. アプリケーションのアクセストークンに関する情報を確認し、作成を続行をクリックし、その後トークンを表示をクリックします。
9. コピーをクリックして、プライベートアプリケーショントークンをコピーします。
接続するには、PrivateAppTokenを取得したプライベートアプリケーショントークンに設定します。
Save & Test をクリックします
Permissions タブに移動し、ユーザーベースの権限を更新します

Personal Access Token を追加する

Personal Access Token（PAT）は、Open WebUI から Connect AI への接続を認証するために使用します。きめ細かなアクセス制御を維持するために、連携ごとに個別の PAT を作成することをおすすめします。

Connect AI アプリの右上にある歯車アイコン（）をクリックして Settings を開きます
Settings ページで Access Tokens セクションに移動し、 Create PAT をクリックします
PAT にわかりやすい名前を付けて Create をクリックします

トークンが表示されたらコピーして安全な場所に保存してください。再度表示されることはありません

HubDB 接続を設定し、PAT を生成すれば、Open WebUI から Connect AI を介して HubDB のデータに接続できるようになります。

Step 2: Open WebUI をインストールして Connect AI MCP を設定

次に、Open WebUI をローカルにインストールし、Connect AI Remote MCP Server をツールサーバーとして設定していきましょう。これにより、チャットインターフェースが Connect AI を通じてリアルタイムデータ向けのツールを検出・呼び出せるようになります。

公式のクイックスタートガイドに従って Open WebUI をインストールします
インストールが完了したら、Open WebUI を起動してブラウザーで開き、チャットインターフェースにアクセスします
右上のプロフィールアイコンをクリックし、Admin Panel を選択します
Admin Panel の上部ナビゲーションバーで Settings をクリックします
左メニューから Integrations を選択し、Manage Tool Servers の横にあるアイコンをクリックして新しい接続を追加します
Add Connection パネルで、次の値を使ってサーバーを設定します。
- Type: MCP Streamable HTTP
- Name: CData MCP、または任意の名前
- ID: cdata-mcp
- URL: https://mcp.cloud.cdata.com/mcp
- Auth: None
Advanced セクションを展開し、次の JSON を Headers フィールドに貼り付けます。
```
{
    "Authorization": "Basic your_base64_encoded_email_PAT",
    "Content-Type": "application/json"
}
		
```
注意：Open WebUI は Connect AI との通信に Basic authentication を使用します。Connect AI のユーザーメールアドレスと、先ほど作成した PAT を email:PAT の形式で結合し、その文字列を Base64 エンコードして、先頭に Basic を付けます。たとえば [email protected]:ABC123...XYZ789 の場合、Authorization ヘッダーの値は次のようになります：Basic dXNlckBkb21haW4uY29tOkFCQzEyMy4uLlhZWjc4OQ==
Save をクリックしてツールサーバーを登録します

MCP サーバーを有効化して LLM プロバイダーを設定する

Open WebUI でチャットを動かすには、少なくとも 1 つの LLM プロバイダーが必要です。チャット入力欄から MCP サーバーを有効化し、お好みのプロバイダーの API キーを設定しましょう。これにより、モデルがプロンプトを解釈し、Connect AI を介して MCP ツールを呼び出せるようになります。

チャットインターフェースに戻り、チャット入力欄の下部にある Integrations アイコンをクリックして Tools を選択し、CData MCP をオンに切り替えてツールをチャットに公開します
チャット上部のモデルセレクターをクリックし、お好みの LLM プロバイダーとモデルを選択します。プロンプトが表示されたらプロバイダーの API キーを追加し、チャットでモデルを使用できるようにします

MCP サーバーと LLM プロバイダーの設定が完了すれば、Open WebUI から Connect AI を介してリアルタイムの HubDB のデータにクエリを実行する準備が整います。

Step 3: Open WebUI からリアルタイムの HubDB のデータにクエリ

連携が完了したら、Open WebUI のチャット入力欄を使い、設定した LLM が処理する自然言語のプロンプトでリアルタイムの HubDB のデータと対話してみましょう。

CData MCP サーバーを有効化してモデルを選択した状態で、チャット入力欄にプロンプトを入力します。たとえば次のようなプロンプトです。
- cdata mcp 内のすべてのカタログを一覧表示して
- HubDB の利用可能なスキーマとテーブルを表示して
- HubDB のデータのテーブルから上位 5 件のレコードを取得して
Open WebUI が Connect AI MCP Server を呼び出し、HubDB のデータからリアルタイムの結果を返します

これで、Open WebUI インスタンスが Connect AI MCP Server と通信し、リモート MCP ツールを通じてチャットインターフェースから直接 HubDB のデータのリアルタイムデータを取得できるようになりました。

CData Connect AI の入手

数百種類の SaaS、ビッグデータ、NoSQL データソースにクラウドアプリケーションから直接アクセスするには、ぜひ CData Connect AI をお試しください。 14日間の無償トライアルを今すぐダウンロードしてみましょう。ご不明な点があれば、いつでも世界トップクラスのサポートチームがお手伝いします。

はじめる準備はできましたか？

CData Connect AI の詳細、または無料トライアルにお申し込みください：

無料トライアル

CData は、AI を本番環境で機能させるデータレイヤーです。数百の主要エンタープライズソースへのライブコネクティビティとレプリケーション、セマンティックコンテキスト、組み込みガバナンスを提供。Databricks、Microsoft、Google、Palantir をはじめ、世界中の 10,000 以上のお客様の AI を支えています。

お問い合わせ

Open WebUI と CData Connect AI を連携してリアルタイムの HubDB データと対話する

Step 1: Open WebUI 向けに HubDB への接続を設定

カスタムOAuthアプリを使用する