【MCP Server】Mistral AI からHubSpot のデータに連携しよう!
Mistral AI は、エンタープライズグレードのオープンソースおよび商用大規模言語モデル(LLM)を構築するフロンティアAI 企業です。Mistral を使えば、オンプレミス、クラウド、エッジなど、あらゆる場所でエージェントのトレーニング、ファインチューニング、デプロイが可能で、データの完全なコントロールを維持できます。エージェント対応プラットフォームは、多言語・マルチモーダル AI を実現し、メモリや拡張コンテキスト処理をサポートしながら、安全に検索、作成、コーディング、自動化、コラボレーションができます。
CData Connect AI は、HubSpot のデータに接続するための専用クラウド間インターフェースを提供します。CData Connect AI Remote MCP Server により、Google ADK エージェントと HubSpotの間でセキュアな通信が可能になります。これにより、ネイティブ対応データベースへのデータレプリケーションを必要とせずに、エージェントから HubSpot のデータ の読み取りや操作を実行できます。CData Connect AIは最適化されたデータ処理機能を備えており、フィルタや JOIN を含むサポート対象のすべての SQL 操作を効率的に HubSpotへ直接送信します。サーバーサイド処理を活用することで、要求されたHubSpot のデータ を迅速に取得できます。
この記事では、Mistral AI の Le Chat(Mistral のカスタマイズ可能な会話型チャットボット)と CData Connect AI を使用して、HubSpot に接続していきます。Mistral AI のワークフロー内でライブの HubSpot と直接やり取りでき、クエリの実行やタスクの自動化を安全に行えるようになります。
セットアップはわずか数分で完了し、接続が完了すればHubSpot のリアルタイムデータとインテリジェントに会話できる独自のチャットボットエージェントが完成します。
それでは、早速始めていきましょう。
前提条件
- Mistral AI アカウント(サインアップまたはログインはこちら)
- CData Connect AI アカウント(サインアップまたはログインはこちら)
- 有効な認証情報を持つアクティブな HubSpot アカウント
概要
実施する手順の概要を確認しておきましょう。
- 接続:CData Connect AI で認証情報を使用してHubSpot への接続を追加します。
- 設定:Mistral AI のLe Chat でカスタム MCP 接続を作成し、CData Connect AI の HubSpot 接続を指定します。
- クエリ:Mistral AI ワークフロー内でライブの HubSpot データとやり取りし、自然言語を使用してクエリを実行したりアクションを実行したりします。
HubSpot データ連携について
CData は、HubSpot のライブデータにアクセスし、統合するための最も簡単な方法を提供します。お客様は CData の接続機能を以下の目的で使用しています:
- API の更新や変更を気にすることなく、HubSpot にアクセスできます。
- 追加の構成手順なしで、HubSpot のカスタムオブジェクトやフィールドにアクセスできます。
- SQL ストアドプロシージャを使用して、添付ファイルのアップロード・ダウンロード、エンゲージメントの挿入、カスタムオブジェクトやフィールドの作成・削除などの機能的な操作を実行できます。
ユーザーは、Tableau、Power BI、Excel などの分析ツールと HubSpot を統合し、当社のツールを活用して HubSpot データをデータベースやデータウェアハウスにレプリケートしています。
他のお客様が CData の HubSpot ソリューションをどのように使用しているかについては、ブログをご覧ください:Drivers in Focus: Simplified HubSpot Connectivity
はじめに
ステップ1:Mistral 用の HubSpot 接続を設定する
Mistral AI から HubSpot への接続は、CData Connect AI のリモートMCP で実現します。Mistral から HubSpot とやり取りするために、まず CData Connect AI で HubSpot 接続を作成・設定していきましょう。
- Connect AI にログインし、Sources をクリックして、「Add Connection」をクリックします。
- 「Add Connection」パネルから「HubSpot」を選択します。
-
HubSpot に接続するために必要な認証プロパティを入力します。
HubSpot 接続プロパティの取得・設定方法
HubSpot はOAuth 認証 およびPrivateAppToken ベース認証をサポートします。
OAuth
HubSpot は埋め込みOAuth 認証情報を提供しており、デスクトップアプリケーションまたはヘッドレスマシンから簡単に接続できます。 Web アプリケーションから接続するには、カスタムOAuth アプリケーションを作成する必要があります。 OAuth 経由で接続するには、すべての認証フローでAuthScheme をOAuth に設定します。 ヘルプドキュメントでは、利用可能なOAuth フローでのHubSpot への認証について詳しく説明します。 カスタムOAuth アプリケーションの作成についての情報と、すでに埋め込みOAuth 認証情報を持つ認証フローでもカスタムOAuth アプリケーションを作成したほうがよい場合の説明については、「カスタムOAuth アプリケーションの作成」セクション を参照してください。
また、PrivateAppToken ベース認証についてはヘルプドキュメントの「接続の確立」セクションを参照してください。
- 「Create & Test」をクリックします。
-
「Add HubSpot Connection」ページの Permissions タブに移動し、ユーザーベースの権限を更新します。
パーソナルアクセストークンの追加
パーソナルアクセストークン(PAT)は、Mistral AI から Connect AI への接続を認証するために使用されます。アクセス制御の粒度を維持するために、サービスごとに個別の PAT を作成することをおすすめします。
- Connect AI アプリの右上にある歯車アイコン()をクリックして、Settings ページを開きます。
- Settings ページの Access Tokens セクションに移動し、「Create PAT」をクリックします。
-
PAT にわかりやすい名前を付けて、Create をクリックします。
- ※PAT は作成時にのみ表示されますので、必ずコピーして安全な場所に保管してください。
これで接続の設定と PAT の生成が完了しました。Mistral AI ワークフローから HubSpot に接続する準備が整いました。
ステップ 2:Mistral Le Chat でMCP コネクタを設定する
CData Connect AI で HubSpot 接続とPAT を作成できたので、次は Mistral Le Chat 内でカスタム MCP コネクタを設定していきましょう。
-
Le Chat にログインします。
-
左側のメニューからIntelligence をクリックし、Connectors を選択します。Add Connector をクリックします。
-
ダイアログでCustom MCP Connector を選択し、以下の詳細を入力します。
- Connector Name:例:CData_Remote_MCP
- Connector Server:https://mcp.cloud.cdata.com/mcp(Connect AI の「Connect Data to AI」リボンに記載されています)
- Authentication Method:API Token Authentication
- Header Name:Authorization
- Header Type:Basic
- Header Value:[email protected]:YourPAT(「[email protected]」を CData Connect AI のメールアドレスに、「YourPAT」を先ほど作成した PAT に置き換えてください。上記の形式で指定します)
- Connect をクリックして接続を確立します。
-
Connections セクションの下部までスクロールして、MCP 接続が正常に確立されたことを確認します。
これで、Mistral Le Chat がCData Remote MCP Server を通じてHubSpot にリアルタイムでクエリをセキュアに連携できるようになりました。
ステップ 3:Mistral AI からHubSpot データをリアルタイムでクエリする
Le Chat でMCP コネクタの設定が完了したので、会話の中でHubSpot のデータを直接クエリできるようになりました。
- Le Chat で、左側のメニューの Chats をクリックして新しいチャットを開始します。
-
Enable Tools ボタンをクリックして MCP コネクタを有効化します。
-
Get Catalogs や Get Tables などのディスカバリークエリを実行して、CData Connect AI を通じて接続されている利用可能なデータソースとスキーマを確認してみましょう。
-
簡単なクエリを実行して接続をテストしてみてください。例えば:
「業種別の商談成約率を比較して」
これで完了です!Mistral Le Chat 内でHubSpot と会話形式でやり取りできるようになりました。
CData Connect AI で複雑な AI エージェントを構築する
統合が完了したら、シンプルなクエリを超えて、複数ステップの AI エージェントを構築できます。これらのエージェントは、Mistral AI の推論機能と CData Connect AI を通じたエンタープライズデータへの安全なリアルタイムアクセスを組み合わせることで、売上予測、サポートトリアージ、顧客トレンド分析など、さまざまなワークフローを実現できます。
CData Connect AI でビジネスシステムのデータ活用を今すぐスタート
いかがでしたか?Mistral AI から HubSpot へのデータ接続が簡単に完了したのではないでしょうか。業務に使えそう、と感じてくださった方は、14 日間の無償トライアルで AI ツールからビジネスシステムへのリアルタイムデータ接続をぜひお試しください。