ElevenLabsでHubDB にアクセスする音声エージェントを構築
ElevenLabs は、自然で人間らしいインタラクションが可能な会話型音声エージェントの構築をサポートする AI オーディオプラットフォームです。ElevenLabs の Conversational AI プラットフォームでは、タスクの処理、動的な応答、外部システムとのリアルタイム連携が可能な音声アシスタントを作成できます。
ElevenLabs と CData Connect AI を MCP(Model Context Protocol)で連携させることで、音声エージェントが会話中にHubDB のデータをクエリ、分析、操作できるようになります。この連携により、ElevenLabs の会話型 AI フレームワークと CData Connect AI のセキュアなエンタープライズ接続が統合され、手動でのデータ移動なしに、承認されたデータソースへのアクセスを安全に実行できます。
この記事では、Connect AI で HubDB 接続を構成し、認証に必要な資格情報を生成してから、ElevenLabs に Connect AI MCP サーバーを登録し、音声エージェントが会話中にHubDB のデータと正常にやり取りできることを確認するまでの手順を説明します。
ステップ1:ElevenLabs 用の HubDB 接続を構成
ElevenLabs から HubDB への接続は、CData Connect AI のリモート MCP サーバーを通じて実現します。音声エージェントから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 タブに移動し、ユーザーベースの権限を更新します
パーソナルアクセストークンの追加
パーソナルアクセストークン(PAT)は、ElevenLabs から Connect AI への接続を認証するために使用します。きめ細かなアクセス制御を維持するため、連携ごとに個別の PAT を作成することをお勧めします。
- Connect AI アプリの右上にある歯車アイコン()をクリックして Settings を開きます
- Settings ページで Access Tokens セクションに移動し、 Create PAT をクリックします
- PAT にわかりやすい名前(例:"ElevenLabs Voice Agent")を付けて、Create をクリックします
- トークンが表示されたらコピーして安全に保管してください。このトークンは再表示されません
HubDB 接続の設定と PAT の生成が完了したら、ElevenLabs から Connect AI を通じてHubDB のデータに接続できるようになります。
ステップ2:ElevenLabs に Connect AI MCP サーバーを追加
ElevenLabs は、SSE(Server-Sent Events)または HTTP ストリーミングトランスポートを使用する外部 MCP サーバーへの接続をサポートしています。CData Connect AI のリモート MCP サーバーはこの連携に対応しています。
-
ElevenLabs プラットフォームにログインし、エージェントダッシュボードに移動します
- Integrations に移動し、+ Add Integration をクリックして MCP サーバー連携セクションにアクセスします
-
Custom MCP Server をクリックして新しい連携を追加します
-
以下の設定を入力します:
- Name: CData Connect AI
- Description: 数百種類のソースからエンタープライズデータへのリアルタイムアクセス
- Server URL: https://mcp.cloud.cdata.com/sse
- Secret Token: 空欄のままにします(認証はヘッダーで処理されます)
- HTTP Headers: キー Authorization、値 Basic your_email:your_PAT でヘッダーを追加します
- your_email:your_PAT を、Connect AI のログインメールと先ほど作成したパーソナルアクセストークンに置き換えます。例:Basic [email protected]:ABC123...XYZ789
- Save をクリックして接続をテストし、Connect AI から利用可能なツールを取得します
- CData Connect AI MCP サーバーが音声エージェントに割り当て可能になりました
ステップ3:Connect AI を使用するように音声エージェントを設定
MCP サーバーを登録したら、ElevenLabs の音声エージェントに追加して、会話中のリアルタイムデータアクセスを有効にできます。
- ElevenLabs ダッシュボードで新しいエージェントを作成するか、既存のエージェントを編集します
- エージェントの設定で Tools セクションに移動します
-
ステップ2で設定した CData Connect AI MCP サーバーを追加します
-
要件に応じてツール承認モードを設定します:
- Always Ask: エージェントはデータクエリのたびに許可を求めます(機密データの場合に推奨)
- Fine-Grained: ツール/アクションごとに承認要件を設定します
- No Approval: エージェントは自律的にデータをクエリできます
- エージェントの設定を保存します
ステップ4:音声エージェントでリアルタイムデータを操作
ElevenLabs の音声エージェントが、CData Connect AI MCP サーバーを通じて会話中にHubDB のデータへアクセスしてクエリできるようになりました。
-
音声エージェントとの会話を開始します
-
エージェントにデータ関連の質問をしてみましょう:
- "利用可能な接続を教えて"
- "HubDB のスキーマを見せて"
- "HubDB のデータ の最新レコードをクエリして"
- "最新のデータをまとめて"
-
エージェントは Connect AI の MCP ツールを使用してリアルタイムデータを取得し、会話形式で応答します
ElevenLabs の音声エージェントが CData Connect AI のリモート MCP サーバーを通じてHubDB のデータにアクセスしてクエリできるように設定が完了しました。これで、ユーザーに向けたリアルタイムでデータドリブンな音声インタラクションが可能になります。
CData Connect AI の入手
数百種類の SaaS、ビッグデータ、NoSQL ソースに、セキュアで AI 対応のインターフェースからアクセスするには、今すぐ CData Connect AI をお試しください。