EmergentからConnect AI経由でHubDB にアクセス

Yazhini G
Technical Marketing Engineer

CData Connect AI のリモートMCP サーバーを活用して、Emergent エージェントからMCP 統合を通じてHubDB のデータにセキュアにアクセスし、アプリケーションを構築する方法をご紹介します。

Emergent は、AI を活用した開発プラットフォームです。作りたいものを自然言語で記述するだけで、自律型エージェントがフルスタックの Web アプリケーションをリアルタイムに生成してくれます。エージェントは MCP を通じて外部ツールやデータソースに接続し、ライブデータを取得してアウトプットに活用できます。

Emergent と CData Connect AI を組み込みの MCP（Model Context Protocol）サーバーで統合すると、Emergent エージェントはガバナンスの効いたリアルタイムのHubDB のデータへのアクセスが可能になります。これにより、エージェントはHubDB のデータのクエリ、分析、可視化を実行できます。セッション中に MCP ツールを直接呼び出す方法と、ライブデータに接続されたフルアプリケーションを生成する方法のどちらにも対応しており、手動のデータエクスポートやカスタム統合コードは不要です。

この記事では、Connect AI で HubDB への接続を設定し、CData MCP サーバーを Emergent に登録して、Emergent からライブのHubDB のデータとやり取りする手順をご紹介します。

ステップ 1：Emergent 用の HubDB への接続を設定

Emergent から HubDB への接続は、CData Connect AI のリモートMCP サーバーを通じて実現されます。Emergent からHubDB のデータとやり取りするために、まず CData 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 タブに移動し、ユーザーベースの権限を更新します

パーソナルアクセストークンの追加

パーソナルアクセストークン（PAT）は、Emergent から Connect AI への接続を認証するために使用されます。アクセス制御の粒度を維持するために、統合ごとに個別の PAT を作成することをおすすめします。

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

トークンが表示されたらコピーして安全な場所に保管してください。一度しか表示されません

HubDB 接続の設定と PAT の生成が完了しました。これで Emergent から Connect AI 経由でHubDB のデータに接続する準備が整いました。

ステップ 2：Emergent で Connect AI を設定

CData Connect AI と Emergent の統合方法は、アカウントのプランに応じて 2 通りあります。Pro および Enterprise ユーザーは Emergent の UI から MCP サーバーを直接登録できます。無料プランのユーザーは、自然言語でやりたいことを記述し、Emergent のエージェントに接続済みアプリケーションを自動生成させることができます。

方法 1：MCP の直接設定（Pro / Enterprise）

Pro および Enterprise ユーザーは、CData Connect AI MCP サーバーを Emergent の UI から直接登録できます。登録が完了すると、どのプロジェクトのエージェントからでも追加設定なしで MCP ツールを通じてライブのHubDB のデータを呼び出せるようになります。

Emergent にサインインします。まだアカウントをお持ちでない場合は新規作成してください
をクリックして新しいプロジェクトを作成します。Project Name を入力して Create Project をクリックします
プロジェクトのチャットウィンドウで、ドロップダウンからお好みのモデル（例：Claude 4.5 Sonnet）を選択します
Advanced Controls アイコンをクリックし、Select MCP Tools をクリックして MCP 設定パネルを開きます
Select MCPs to use ダイアログで、+ New MCP Server をクリックしてカスタム MCP サーバーを追加します
Configure New MCP ダイアログで、以下の情報を入力します：
- MCP Name: cdata-mcp
- Description:（任意）サーバーの簡単な説明
- JSON Configuration: 以下をペーストし、base64-encode-email-pat の部分を Base64 エンコードした email:PAT 文字列に置き換えてください：
```
{
    "mcpServers": {
        "cdata-mcp": {
            "args": [
                "-y",
                "mcp-client",
                "connect",
                "https://mcp.cloud.cdata.com/mcp"
            ],
            "command": "npx",
            "env": {
                "MCP_HEADERS": "{\"Authorization\":\"Basic base64-encode-email-pat\"}"
            }
        }
    }
}
        
```
注：Connect AI のメールアドレスと PAT を email:PAT の形式で結合し、Base64 エンコードしてください。例えば、[email protected]:ABC123...XYZ の場合、エンコード結果は dXNlckBteWRvbWFpbjphSzkvbVB4Mi9Rcjd2TjQ... のようになります。
Verify and Save をクリックして MCP サーバーを登録します
Select MCP Tools に戻り、cdata-mcp がリストに表示され、トグルが有効になっていることを確認します。有効になっていない場合はオンに切り替えてください

CData MCP サーバーの登録と有効化が完了しました。これで Emergent エージェントは、どのプロジェクトからでも Connect AI を通じてライブのHubDB のデータをクエリ・操作できます。

Emergent からライブのHubDB のデータをクエリ

MCP サーバーの設定が完了したら、Emergent のエージェントパネルで会話を開始して、ライブのHubDB のデータとやり取りしてみましょう。

プロジェクトのチャットに戻り、データを探索するプロンプトを入力します。例：
- cdata-mcp 接続で利用可能なすべてのカタログを一覧表示して。
- HubDB で利用可能なスキーマとテーブルを表示して。
- HubDB のデータから上位 5 件のレコードをクエリして。
エージェントが CData Connect AI MCP サーバーを呼び出し、HubDB のデータからリアルタイムの結果を返します

方法 2：自然言語でアプリケーションを構築（無料プラン）

無料プランのユーザーは、自然言語のプロンプトで CData Connect AI MCP サーバーに接続するフルスタックアプリケーションの構築を Emergent に指示できます。エージェントが必要なエンドポイントと認証情報を対話的に確認し、ライブのHubDB のデータに接続されたアプリケーションを生成します。

Emergent にサインインし、チャットウィンドウを開きます

構築したいアプリケーションを記述するプロンプトを入力します。例：

I would like to build a small application that connects to a remote MCP HTTPS server.
I already have the MCP endpoint URL and the required credentials.
The application should:
  - Establish a connection to the remote MCP server
  - Authenticate using the provided credentials
  - Retrieve and list all available catalogs from the MCP

Please make sure the credentials are stored securely in a .env file
and not hardcoded in the application.

Emergent が MCP エンドポイント URL と認証情報の入力を求めてきます。以下の値を入力してください：
- MCP Endpoint URL: https://mcp.cloud.cdata.com/mcp
- Authorization: Basic base64(email:PAT)
Emergent エージェントが Connect AI 経由でHubDB のデータに接続するフルスタックアプリケーションを生成し、App Preview パネルにライブの結果を表示します。

これで、Emergent が CData Connect AI MCP サーバーと通信し、ライブのHubDB のデータを取得するアプリケーションを構築できました。自然言語のプロンプトひとつで完了です。

CData Connect AI でビジネスシステムのデータ活用を今すぐスタート

いかがでしたか？Emergent から HubDB へのデータ接続が10 分もかからずに完了したのではないでしょうか。業務に使えそう、と感じてくださった方は、CData Connect AI をぜひお試しください。 14 日間の無償トライアルで、数百種類の SaaS、ビッグデータ、NoSQL ソースへのリアルタイムアクセスを体験いただけます。ご不明点がございましたら、サポートチームまでお気軽にお問い合わせください。

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

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

無料トライアル

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

お問い合わせ

EmergentからConnect AI経由でHubDB にアクセス

ステップ 1：Emergent 用の HubDB への接続を設定

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

プライベートアプリを使用する