FlowiseのAIエージェントからConnect AI経由でHubDB に接続
Flowise AI は、AI ワークフローとカスタムエージェントを視覚的に構築できるオープンソースのノーコードツールです。ドラッグ&ドロップインターフェースにより、大規模言語モデル(LLM)を API、データベース、外部システムと簡単に統合できます。
CData Connect AI は、数百種類のエンタープライズデータソースへのリアルタイム接続を可能にします。Model Context Protocol(MCP)サーバーを通じて、CData Connect AI は Flowise エージェントとリアルタイムの HubDB をセキュアかつ効率的に橋渡しします。データのレプリケーションは不要です。Flowise AI の直感的なエージェントビルダーと CData の MCP 統合を組み合わせることで、Flowise AI ワークフロー内でリアルタイムの HubDB のデータ を取得、分析、操作できるエージェントを作成できます。
このガイドでは、Flowise AI を CData Connect AI MCP に接続し、認証情報を設定して、エージェントがリアルタイムでHubDB のデータをクエリできるようにする方法を説明します。
ステップ 1:Flowise 用の HubDB 接続を設定
Flowise AI から HubDB への接続は、CData Connect AI のリモート MCP サーバーによって実現されます。Flowise AI からHubDB のデータを操作するには、まず CData Connect AI で HubDB 接続を作成・設定します。
- Connect AI にログインし、Sources をクリック、次に Add Connection をクリック
- Add Connection パネルから HubDB を選択
-
HubDB に接続するために必要な認証プロパティを入力します。
HubDBデータソースへの接続には、パブリックHubSpotアプリケーションを使用したOAuth認証とプライベートアプリケーショントークンを使用した認証の2つの方法があります。
カスタムOAuthアプリを使用する
すべてのOAuthフローでAuthSchemeを"OAuth"に設定する必要があります。特定の認証ニーズ(デスクトップアプリケーション、Webアプリケーション、ヘッドレスマシン)に必要な接続プロパティについては、ヘルプドキュメントを確認してください。
アプリケーションを登録し、OAuthクライアント認証情報を取得するには、以下の手順を実行してください。
- HubSpotアプリ開発者アカウントにログインします。
- アプリ開発者アカウントである必要があります。標準のHubSpotアカウントではパブリックアプリを作成できません。
- 開発者アカウントのホームページで、アプリタブをクリックします。
- アプリを作成をクリックします。
- アプリ情報タブで、ユーザーが接続する際に表示される値を入力し、必要に応じて変更します。これらの値には、パブリックアプリケーション名、アプリケーションロゴ、アプリケーションの説明が含まれます。
- 認証タブで、「リダイレクトURL」ボックスにコールバックURLを入力します。
- デスクトップアプリケーションを作成する場合は、http://localhost:33333のようなローカルにアクセス可能なURLに設定します。
- Webアプリケーションを作成する場合は、ユーザーがアプリケーションを承認した際にリダイレクトされる信頼できるURLに設定します。
- アプリを作成をクリックします。HubSpotがアプリケーションとそれに関連する認証情報を生成します。
- 認証タブで、クライアントIDとクライアントシークレットを確認します。これらは後でドライバーを設定する際に使用します。
スコープの下で、アプリケーションの意図する機能に必要なスコープを選択します。
テーブルにアクセスするには、最低限以下のスコープが必要です:
- hubdb
- oauth
- crm.objects.owners.read
- 変更を保存をクリックします。
- 統合に必要な機能にアクセスできる本番ポータルにアプリケーションをインストールします。
- 「インストールURL(OAuth)」の下で、完全なURLをコピーをクリックして、アプリケーションのインストールURLをコピーします。
- コピーしたリンクをブラウザで開きます。アプリケーションをインストールする標準アカウントを選択します。
- アプリを接続をクリックします。結果のタブは閉じて構いません。
プライベートアプリを使用する
HubSpotプライベートアプリケーショントークンを使用して接続するには、AuthSchemeプロパティを"PrivateApp"に設定します。
以下の手順に従ってプライベートアプリケーショントークンを生成できます:
- HubDBアカウントで、メインナビゲーションバーの設定アイコン(歯車)をクリックします。
- 左サイドバーメニューで、統合 > プライベートアプリに移動します。
- プライベートアプリを作成をクリックします。
- 基本情報タブで、アプリケーションの詳細(名前、ロゴ、説明)を設定します。
- スコープタブで、プライベートアプリケーションがアクセスできるようにしたい各スコープに対して読み取りまたは書き込みを選択します。
- テーブルにアクセスするには、最低限hubdbとcrm.objects.owners.readが必要です。
- アプリケーションの設定が完了したら、右上のアプリを作成をクリックします。
- アプリケーションのアクセストークンに関する情報を確認し、作成を続行をクリックし、その後トークンを表示をクリックします。
- コピーをクリックして、プライベートアプリケーショントークンをコピーします。
接続するには、PrivateAppTokenを取得したプライベートアプリケーショントークンに設定します。
- HubSpotアプリ開発者アカウントにログインします。
- Save & Test をクリック
- Permissions タブに移動し、ユーザーベースの権限を更新
接続が確立されると、HubDB データは CData Connect AI でアクセス可能になり、MCP 対応ツールで使用する準備が整います。
Personal Access Token を追加
Personal Access Token(PAT)は、Flowise AI から Connect AI への接続を認証するために使用されます。きめ細かいアクセス制御を維持するため、統合ごとに個別の PAT を作成することをお勧めします。
- Connect AI アプリの右上にある歯車アイコン()をクリックして Settings を開く
- Settings ページで Access Tokens セクションに移動し、 Create PAT をクリック
- PAT にわかりやすい名前を付けて Create をクリック
- トークンが表示されたらコピーして安全な場所に保存してください。再度表示されることはありません
HubDB 接続の設定と PAT の生成が完了したら、Flowise AI から Connect AI 経由でHubDB のデータに接続できます。
ステップ 2:Flowise AI で Connect AI 認証情報を設定
Flowise AI ワークスペースにログインして統合をセットアップします。
OpenAI 認証情報を追加
- Credentials に移動し、Add Credential を選択
- ドロップダウンから OpenAI API を選択
- 名前(例:OpenAI_Key)を入力し、API キーを貼り付け
PAT 変数を追加
- Variables に移動し、Add Variable をクリック
- Variable Name(例:PAT)を設定し、タイプを Static に選択、Value に Base64 エンコードした username:PAT を設定
- Add をクリックして変数を保存
ステップ 3:Flowise AI でエージェントを構築
- Agent Flows に移動し、Add New を選択
- 「+」アイコンをクリックして新しいノードを追加し、Agent を選択してワークフローにドラッグ
- Start ノードを Agent ノードに接続
エージェント設定を構成
Agent ノードをダブルクリックして詳細を入力:
- Model:ChatOpenAI または希望のモデルを選択(例:gpt-4o-mini)
- Connect Credential:先ほど作成した OpenAI API キー認証情報を選択
- Streaming:有効
カスタム MCP ツールを追加
- Tools の下で Add Tool をクリックし、Custom MCP を選択
- 以下のように JSON パラメータを入力:
{
"url": "https://mcp.cloud.cdata.com/mcp",
"headers": {
"Authorization": "Basic {{$vars.PAT}}"
}
}
更新アイコンをクリックして利用可能な MCP アクションを読み込みます。アクションが一覧表示されたら、Flowise エージェントが CData Connect AI MCP に正常に接続されています。
ステップ 4:Flowise でリアルタイムのHubDB のデータをテスト・クエリ
- Flowise で Chat タブを開く
- 「Show top 10 records fromHubDB のデータtable」 のようなクエリを入力
- CData Connect AI MCP 接続を通じてリアルタイムでレスポンスが取得されることを確認
ワークフローの実行が完了すると、Flowise は CData Connect AI MCP サーバーを通じた Salesforce データの正常な取得を示します。MCP Client ノードにより、データに対して質問したり、レコードを取得したり、アクションを実行したりできます。
CData Connect AI を入手
クラウドアプリケーションから 数百種類の SaaS、ビッグデータ、NoSQL ソースに直接アクセスするには、CData Connect AI をお試しください!