【MCP Server】Paylocity × Claude Desktop 連携ガイド | AI でデータを徹底活用

Model Context Protocol (MCP) is an emerging, open-source standard for connecting LLMs with external services and data sources. Through MCP Servers, AI clients can perform actions like opening Jira tickets, posting Slack messages, committing GitHub branches and more. With CData MCP Servers, these capabilities expand exponentially.

In this article, we guide the reader through installing the CData MCP Server for Paylocity, configuring the connection to Paylocity, and asking questions of the data in Claude Desktop.

Prerequisites

You need to download Claude Desktop (download) and create an account before continuing.

Overview

Here's a quick overview of the steps:

1. Download and install the CData MCP Server for Paylocity
2. Configure the connection to Paylocity
3. Ask questions about the data in Claude Desktop

Step 1: Download and install the CData MCP Server

1. To begin, navigate to https://www.cdata.com/solutions/mcp/connectors and download the CData MCP Server for Paylocity.
2. Find and double-click the installer to begin the installation.
3. Follow the prompts to complete the installation.

When the installation is complete, you are ready to configure your MCP Server by connecting to Paylocity.

Step 2: Configure the connection to Paylocity

1. After installation, the CData MCP Server configuration wizard should open automatically.

   NOTE: If the wizard does not open automatically, search for "CData MCP Server" in the Windows search bar and double-click the application.

2. Click the dropdown menu in MCP Configuration > Configuration Name and select ""
3. Name the configuration (e.g. "cdatapaylocity") and click "OK."

   NOTE: This name is used as the name for the MCP server and as the prefix for all of the MCP Server's tools.

   

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

   Enter the appropriate connection properties in the configuration wizard.

   
5. Click "Connect" to authenticate with Paylocity through OAuth.

   NOTE: The configuration wizard should open your browser and ask you to sign into Paylocity. If your browser does not open, close the configuration wizard and re-open the application using "Run as Administrator" (see below).

   
6. Finally, click "Save Configuration" to save the MCP server.

   NOTE: This saves the configuration details to a separate file and updates the Claude Desktop configuration file (claude_desktop_config.json) to start the CData MCP Server when the Claude Desktop client starts.

With the CData MCP Server configured, you are ready to start asking questions of your live data from Claude.

Step 3: Ask AI for answers from live Paylocity のデータ

Now that we have installed the CData MCP Server and configured a connection, we are ready to start with Paylocity のデータ in Claude Desktop.

1. Open Claude Desktop. It may take a moment for the MCP Servers to start, but you will see the list of servers and tools available in the Claude interface (look for the settings icon below the prompt bar).

   You can individually enable and disable specific tools by clicking on the server name.

2. Now that you have connected, you can ask Claude questions about the Paylocity のデータ. For example: "Can you give me a quantitative analysis about my closed-won opportunities by industry?"

   NOTE: Claude may need to explore the Paylocity のデータ to make sense of it before it can begin answering questions of the data. The tabular model presented by CData alongside the database tools available simplify the data exploration and analysis for an LLM.

   

Connect your AI to your data today!

CData MCP Servers make it easier than ever for LLMs to work with live enterprise data. To explore the technology hands-on, download a free, 30-day trial or visit the CData Community to share insights, ask questions, and help shape the future of enterprise-ready AI.