GitHub Copilot × CData Code Assist MCP for Paylocity で Paylocity のリアルタイムデータを活用する方法

GitHub Copilot は、Visual Studio Code をはじめとする IDE に統合された AI コーディングアシスタントです。MCP に対応しているため、ローカルツールやエンタープライズデータソースに接続し、開発中にリアルタイムデータを自然言語で操作できます。

Model Context Protocol（MCP） は、LLM クライアントを外部サービスに接続するためのオープンスタンダードです。MCP サーバーはスキーマの探索やリアルタイムクエリなどの機能を提供し、AI エージェントがリアルタイムデータに安全かつ一貫した方法でアクセスできるようにします。

この記事では、CData Code Assist MCP for Paylocity のインストールから Paylocity への接続設定、Code Assist MCP アドオンと GitHub Copilot の連携、さらに Visual Studio Code から Paylocity のデータ をクエリする方法まで、ステップバイステップで解説します。

前提条件

• Visual Studio Code がインストールされていること
• Visual Studio Code で GitHub Copilot Chat 拡張機能が有効になっていること
• CData Code Assist MCP for Paylocity がインストールされていること

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

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

インストールが完了したら、Paylocity への接続設定に進みましょう。

ステップ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 & Test をクリックして接続を確定します。

この操作により、GitHub Copilot が Code Assist MCP アドオンを起動する際に参照する .mcp 構成ファイルが作成されます。続いて、Code Assist MCP アドオンを GitHub Copilot に接続しましょう。

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

1. Visual Studio Code をダウンロード・インストールし、GitHub Copilot Chat 拡張機能を有効にします。

方法1：MCP 構成を手動で追加する

1. mcp.json ファイルを開くか新規作成します。
   • グローバル設定の場合：%%APPDATA%%/Roaming/Code/User/mcp.json
   • プロジェクト固有の設定の場合：/.vscode/mcp.json
2. 以下の JSON コードを追加してファイルを保存します。

{
  "servers": {
    "cdata_paylocity": {
      "command": "C:\Program Files\CData\CData Code Assist MCP for Paylocity\jre\bin\java.exe",
      "args": [
        "-Dfile.encoding=UTF-8",
        "-jar",
        "C:\Program Files\CData\CData Code Assist MCP for Paylocity\lib\cdata.mcp.paylocity.jar",
        "cdata_paylocity"
      ]
    }
  }
}

注意：command の値には Java 17+ の java.exe 実行ファイルへのパスを、JAR パスには CData Code Assist MCP アドオンの .jar ファイルへのパスを指定してください。最後の引数は、CData 設定ウィザードで保存した MCP 構成名（例：「cdata_paylocity」）と一致させる必要があります。

方法2：CData Code Assist MCP for Paylocity の UI から MCP 構成をコピーする

1. 設定ウィザードで接続の保存とテストが完了したら、Next をクリックします。
2. AI MCP Tool ドロップダウンから Github Copilot を選択します。
3. MCP Client Instructions に従って、必要な構成ファイルを作成します。
4. 表示された JSON コードをコピーして、構成ファイルに貼り付けます。

ステップ4：GitHub Copilot からリアルタイム Paylocity のデータ をクエリ

1. Visual Studio Code を起動し、GitHub Copilot Chat インターフェースを開きます。ツールアイコンを選択して、設定済みの Code Assist MCP アドオンを有効にします。
2. 自然言語で Paylocity のデータ について質問してみましょう。例：

   "List all tables available in my Paylocity のデータ data connection."

   
3. 自然言語プロンプトを使って開発を進めることもできます：

   For my project, data from the Employee is very important. Pull data from the most important columns like FirstName and LastName.
   

これで GitHub Copilot と CData Code Assist MCP for Paylocity の連携は完了です。MCP ツールを使用して、スキーマの探索や Paylocity に対するリアルタイムクエリを実行できます。

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

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

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