Cursor で Paylocity 対応アプリケーションを構築する方法 - CData Code Assist MCP

Cursor は、日々の開発ワークフローにエージェント型 AI を統合した AI 搭載コードエディタです。MCP をサポートしているため、エディタから直接ローカルツールやエンタープライズデータソースに接続でき、コンテキストを切り替えることなく自然言語でライブシステムとやり取りできます。

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

この記事では、CData Code Assist MCP for Paylocity のインストール、Paylocity への接続設定、Code Assist MCP アドオンの Cursor への接続、そしてエディタ内からのリアルタイム 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 Configuration をクリックして Code Assist MCP アドオンの構成を保存します。

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

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

1. Cursor デスクトップアプリケーションをダウンロードし、アカウントのサインアップを完了します。
2. 上部メニューから Settings をクリックして設定パネルを開きます。
3. 左側のナビゲーションで Tools & MCP タブを開き、Add Custom MCP をクリックします。

オプション1：MCP 設定を手動で追加

1. Cursor がエディタ内に mcp.json ファイルを開きます。
2. 以下のコードを追加してファイルを保存します。

{
  "mcpServers": {
    "cdata-local": {
      "command": "C:/Program Files/Java/jdk-17/bin/java.exe",
      "args": [
        "-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 ドロップダウンから Cursor を選択します。

3. MCP Client Instructions の手順に従って、MCP 設定に必要なフォルダを作成します。

4. 表示された JSON コードをコピーして、設定ファイルに貼り付けます。
5. Cursor で、mcp.json 設定を含むプロジェクトフォルダを開きます。
4. Code Assist MCP アドオンが、Installed MCP Servers の一覧に Running と表示されていれば設定完了です。

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

1. 上部バーの Toggle AI Pane をクリックして、チャットウィンドウを開きます。
2. 自然言語を使って Paylocity のデータについて質問してみましょう。例：

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

   

これで Cursor と 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 ワークフローの可能性を探索しましょう。