【MCP Server】Mistral AI からPaylocity のデータに連携しよう!
Mistral AI は、エンタープライズグレードのオープンソースおよび商用大規模言語モデル(LLM)を構築するフロンティアAI 企業です。Mistral を使えば、オンプレミス、クラウド、エッジなど、あらゆる場所でエージェントのトレーニング、ファインチューニング、デプロイが可能で、データの完全なコントロールを維持できます。エージェント対応プラットフォームは、多言語・マルチモーダル AI を実現し、メモリや拡張コンテキスト処理をサポートしながら、安全に検索、作成、コーディング、自動化、コラボレーションができます。
CData Connect AI は、Paylocity のデータに接続するための専用クラウド間インターフェースを提供します。CData Connect AI Remote MCP Server により、Google ADK エージェントと Paylocityの間でセキュアな通信が可能になります。これにより、ネイティブ対応データベースへのデータレプリケーションを必要とせずに、エージェントから Paylocity のデータ の読み取りや操作を実行できます。CData Connect AIは最適化されたデータ処理機能を備えており、フィルタや JOIN を含むサポート対象のすべての SQL 操作を効率的に Paylocityへ直接送信します。サーバーサイド処理を活用することで、要求されたPaylocity のデータ を迅速に取得できます。
この記事では、Mistral AI の Le Chat(Mistral のカスタマイズ可能な会話型チャットボット)と CData Connect AI を使用して、Paylocity に接続していきます。Mistral AI のワークフロー内でライブの Paylocity と直接やり取りでき、クエリの実行やタスクの自動化を安全に行えるようになります。
セットアップはわずか数分で完了し、接続が完了すればPaylocity のリアルタイムデータとインテリジェントに会話できる独自のチャットボットエージェントが完成します。
それでは、早速始めていきましょう。
前提条件
- Mistral AI アカウント(サインアップまたはログインはこちら)
- CData Connect AI アカウント(サインアップまたはログインはこちら)
- 有効な認証情報を持つアクティブな Paylocity アカウント
概要
実施する手順の概要を確認しておきましょう。
- 接続:CData Connect AI で認証情報を使用してPaylocity への接続を追加します。
- 設定:Mistral AI のLe Chat でカスタム MCP 接続を作成し、CData Connect AI の Paylocity 接続を指定します。
- クエリ:Mistral AI ワークフロー内でライブの Paylocity データとやり取りし、自然言語を使用してクエリを実行したりアクションを実行したりします。
ステップ1:Mistral 用の Paylocity 接続を設定する
Mistral AI から Paylocity への接続は、CData Connect AI のリモートMCP で実現します。Mistral から Paylocity とやり取りするために、まず CData Connect AI で Paylocity 接続を作成・設定していきましょう。
- Connect AI にログインし、Sources をクリックして、「Add Connection」をクリックします。
- 「Add Connection」パネルから「Paylocity」を選択します。
-
Paylocity に接続するために必要な認証プロパティを入力します。
Paylocity への接続を確立するには以下を設定します。
- RSAPublicKey:Paylocity アカウントでRSA 暗号化が有効になっている場合は、Paylocity に関連付けられたRSA キーを設定。
このプロパティは、Insert およびUpdate ステートメントを実行するために必須です。この機能が無効になっている場合は必須ではありません。
- UseSandbox:サンドボックスアカウントを使用する場合はTrue に設定。
- CustomFieldsCategory:Customfields カテゴリに設定。これは、IncludeCustomFields がtrue に設定されている場合は必須です。デフォルト値はPayrollAndHR です。
- Key:Paylocity の公開鍵で暗号化されたAES 共通鍵(base 64 エンコード)。これはコンテンツを暗号化するためのキーです。
Paylocity は、RSA 復号化を使用してAES 鍵を復号化します。
これはオプションのプロパティで、IV の値が指定されていない場合、ドライバーは内部でキーを生成します。 - IV:コンテンツを暗号化するときに使用するAES IV(base 64 エンコード)。これはオプションのプロパティで、Key の値が指定されていない場合、ドライバーは内部でIV を生成します。
OAuth
OAuth を使用してPaylocity で認証する必要があります。OAuth では認証するユーザーにブラウザでPaylocity との通信を要求します。詳しくは、ヘルプドキュメントのOAuth セクションを参照してください。
Pay Entry API
Pay Entry API はPaylocity API の他の部分と完全に分離されています。個別のクライアントID とシークレットを使用し、アカウントへのアクセスを許可するにはPaylocity から明示的にリクエストする必要があります。 Pay Entry API を使用すると、個々の従業員の給与情報を自動的に送信できます。 Pay Entry API によって提供されるものの性質が非常に限られているため、CData では個別のスキーマを提供しないことを選択しましたが、UsePayEntryAPI 接続プロパティを介して有効にできます。
UsePayEntryAPI をtrue に設定する場合は、CreatePayEntryImportBatch、MergePayEntryImportBatch、Input_TimeEntry、およびOAuth ストアドプロシージャのみ利用できることに注意してください。 製品のその他の機能を使用しようとするとエラーが発生します。また、OAuthAccessToken を個別に保存する必要があります。これは、この接続プロパティを使用するときに異なるOAuthSettingsLocation を設定することを意味します。
- RSAPublicKey:Paylocity アカウントでRSA 暗号化が有効になっている場合は、Paylocity に関連付けられたRSA キーを設定。
- 「Create & Test」をクリックします。
-
「Add Paylocity Connection」ページの Permissions タブに移動し、ユーザーベースの権限を更新します。
パーソナルアクセストークンの追加
パーソナルアクセストークン(PAT)は、Mistral AI から Connect AI への接続を認証するために使用されます。アクセス制御の粒度を維持するために、サービスごとに個別の PAT を作成することをおすすめします。
- Connect AI アプリの右上にある歯車アイコン()をクリックして、Settings ページを開きます。
- Settings ページの Access Tokens セクションに移動し、「Create PAT」をクリックします。
-
PAT にわかりやすい名前を付けて、Create をクリックします。
- ※PAT は作成時にのみ表示されますので、必ずコピーして安全な場所に保管してください。
これで接続の設定と PAT の生成が完了しました。Mistral AI ワークフローから Paylocity に接続する準備が整いました。
ステップ 2:Mistral Le Chat でMCP コネクタを設定する
CData Connect AI で Paylocity 接続と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 を通じてPaylocity にリアルタイムでクエリをセキュアに連携できるようになりました。
ステップ 3:Mistral AI からPaylocity データをリアルタイムでクエリする
Le Chat でMCP コネクタの設定が完了したので、会話の中でPaylocity のデータを直接クエリできるようになりました。
- Le Chat で、左側のメニューの Chats をクリックして新しいチャットを開始します。
-
Enable Tools ボタンをクリックして MCP コネクタを有効化します。
-
Get Catalogs や Get Tables などのディスカバリークエリを実行して、CData Connect AI を通じて接続されている利用可能なデータソースとスキーマを確認してみましょう。
-
簡単なクエリを実行して接続をテストしてみてください。例えば:
「業種別の商談成約率を比較して」
これで完了です!Mistral Le Chat 内でPaylocity と会話形式でやり取りできるようになりました。
CData Connect AI で複雑な AI エージェントを構築する
統合が完了したら、シンプルなクエリを超えて、複数ステップの AI エージェントを構築できます。これらのエージェントは、Mistral AI の推論機能と CData Connect AI を通じたエンタープライズデータへの安全なリアルタイムアクセスを組み合わせることで、売上予測、サポートトリアージ、顧客トレンド分析など、さまざまなワークフローを実現できます。
CData Connect AI でビジネスシステムのデータ活用を今すぐスタート
いかがでしたか?Mistral AI から Paylocity へのデータ接続が簡単に完了したのではないでしょうか。業務に使えそう、と感じてくださった方は、14 日間の無償トライアルで AI ツールからビジネスシステムへのリアルタイムデータ接続をぜひお試しください。