Gemini Code Assist で Paylocity データを活用したアプリケーション開発 | CData Code Assist MCP

Gemini Code Assist は、日常の開発ワークフローにインテリジェントなコード生成を統合する、AI 搭載のコーディングアシスタントです。MCP をサポートしているため、Gemini Code Assist は Visual Studio Code から直接エンタープライズデータソースに接続でき、コンテキストを切り替えたりデータアクセスコードを手動で記述したりすることなく、自然言語で構造化データを操作できます。

Model Context Protocol（MCP）は、LLM クライアントを構造化されたツールインターフェースを通じて外部サービスに接続するためのオープンスタンダードです。MCP サーバーはスキーマの検出やリアルタイムクエリなどの機能を公開し、AI エージェントが安全かつ一貫した方法でリアルタイムデータを取得・分析できるようにします。

このガイドでは、CData Code Assist MCP for Paylocity のインストール、Paylocity への接続設定、Code Assist MCP アドオンと Gemini Code Assist の連携、そしてエディタ内からのリアルタイム Paylocity のデータのクエリまでを、ステップバイステップで解説します。

前提条件

作業を始める前に、以下の要件を満たしていることを確認してください。

1. Visual Studio Code がインストール済みであること
2. Gemini Code Assist 拡張機能が Visual Studio Code で有効化されていること
3. CData Code Assist MCP for Paylocity がインストール済みであること
4. Paylocity へのアクセス権があること

注意： MCP サーバーを設定する前に、Gemini Code Assist が Visual Studio Code で正常にセットアップされ、動作していることが必要です。MCP サーバーは、Gemini Code Assist が Agent モードで実行されている場合にアクセスされます。

ステップ1：CData Code Assist MCP for Paylocity のダウンロードとインストール

1. まず、CData Code Assist MCP for Paylocity をダウンロードします。
2. ダウンロードしたインストーラーをダブルクリックして、インストールを開始します。
3. 画面の指示に従ってインストールを完了させます。

インストールが完了したら、Paylocity への接続を設定して Code Assist MCP アドオンを構成していきましょう。

ステップ2：Paylocity への接続を設定

1. インストール完了後、CData Code Assist MCP for Paylocity の設定ウィザードを開きます。

   注意： ウィザードが自動的に開かない場合は、Windows の検索バーで「CData Code Assist MCP for Paylocity」と検索して、アプリケーションを起動してください。

   
2. MCP Configuration > Configuration Name で、既存の構成を選択するか、 を選択して新しい構成を作成します。
3. 構成名を入力し（例：「cdata_paylocity」）、OK をクリックします。

4. 設定ウィザードで、適切な接続プロパティを入力します。

   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 を設定することを意味します。

5. Connect をクリックして、OAuth 経由で Paylocity に認証します。
6. 続いて、Save Configuration をクリックして Code Assist MCP アドオンの設定を保存します。

この操作により、Gemini Code Assist が Code Assist MCP アドオンを起動する際に参照する .mcp 構成ファイルが作成されます。Code Assist MCP アドオンの設定が完了したら、次は Gemini Code Assist との接続に進みましょう。

ステップ3：Code Assist MCP アドオンを Gemini Code Assist に接続

1. Visual Studio Code がインストールされ、Gemini Code Assist 拡張機能が有効化されていることを確認します。
2. 設定ウィザードで接続の保存とテストが完了したら、Next をクリックします。
3. AI MCP Tool ドロップダウンから Gemini Code Assist を選択します。
4. Copy JSON をクリックして、生成された MCP 構成をクリップボードにコピーします。
5. コピーした JSON を、使用するスコープに応じた構成ファイルに貼り付けます。
   • ユーザーレベル： 現在のユーザーのすべてのプロジェクトに構成が適用されます。
   • ワークスペースレベル： 現在のワークスペースまたはプロジェクトにのみ構成が適用されます。

   注意： 構成には、Java 17+ の実行ファイルのパスと CData Code Assist MCP アドオンの JAR ファイルのパスが含まれています。最後の引数は、ウィザードで保存した MCP 構成名と一致している必要があります（例：「cdata_paylocity」）。

6. 構成ファイルを保存し、必要に応じて Visual Studio Code を再起動します。

ステップ4：Gemini Code Assist でリアルタイムの Paylocity のデータをクエリ

1. Visual Studio Code を開き、アクティビティバーの Gemini Code Assist を選択します。
2. チャットプロンプトで /mcp と入力して、接続状態を確認します。Paylocity の Code Assist MCP アドオンが緑色の接続インジケーターとともに表示されます。
3. 自然言語を使って Paylocity のデータについて質問してみましょう。例：

   "Provide the list of all tables available in my Paylocity のデータ connection."

   
4. リアルタイムの Paylocity のデータを操作するコードを生成することもできます。例：

   "Write a function to retrieve records from the Employee table where FirstName matches a given value."

   

これで、Gemini Code Assist と CData Code Assist MCP アドオンの連携が完了しました。MCP ツールを活用して、スキーマの探索、Paylocity に対するリアルタイムクエリの実行、データに基づいたコード生成を行えます。

Code Assist MCP で構築。CData Drivers で本番運用。

Code Assist MCP を無料でダウンロードして、開発中にリアルタイムの Paylocity のデータへのスキーマ対応アクセスを AI ツールに提供しましょう。本番環境に移行する際は、CData Paylocity Drivers が同じ SQL ベースのアクセスをエンタープライズグレードのパフォーマンス、セキュリティ、信頼性で提供します。

CData コミュニティにアクセスして、インサイトの共有や質問、MCP を活用した AI ワークフローの可能性を探索しましょう。