Integrate Live Paylocity Data in the Windsurf IDE via CData Connect AI

Windsurf is an AI-native IDE built around Cascade, an autonomous coding agent that understands project context and executes multi-step tasks directly inside the editor. Cascade supports the Model Context Protocol (MCP), allowing the agent to discover and call external tools and data sources without leaving the development environment.

By integrating Windsurf with CData Connect AI through the built-in MCP server, the Cascade agent gains governed, real-time access to live Paylocity data. This enables developers to list catalogs, inspect schemas, and query records from Paylocity data within the IDE using natural language prompts.

This article explains how to configure Paylocity connectivity in Connect AI, generate the required personal access token, configure the Connect AI MCP Server in Windsurf, and verify the integration by querying live Paylocity data from the Cascade chat.

Step 1: Configure Paylocity connectivity for Windsurf

Connectivity to Paylocity from Windsurf is made possible through Connect AI's Remote MCP Server. To interact with Paylocity data from Windsurf, start by creating and configuring a Paylocity connection in Connect AI.

1. Log into Connect AI, click Sources, and then click Add Connection

2. Select Paylocity from the Add Connection panel

3. Enter the necessary authentication properties to connect to Paylocity.

   Set the following to establish a connection to Paylocity:

   • RSAPublicKey: Set this to the RSA Key associated with your Paylocity, if the RSA Encryption is enabled in the Paylocity account.

     This property is required for executing Insert and Update statements, and it is not required if the feature is disabled.

   • UseSandbox: Set to true if you are using sandbox account.
   • CustomFieldsCategory: Set this to the Customfields category. This is required when IncludeCustomFields is set to true. The default value for this property is PayrollAndHR.
   • Key: The AES symmetric key(base 64 encoded) encrypted with the Paylocity Public Key. It is the key used to encrypt the content.

     Paylocity will decrypt the AES key using RSA decryption.
     It is an optional property if the IV value not provided, The driver will generate a key internally.

   • IV: The AES IV (base 64 encoded) used when encrypting the content. It is an optional property if the Key value not provided, The driver will generate an IV internally.

   Connect Using OAuth Authentication

   You must use OAuth to authenticate with Paylocity. OAuth requires the authenticating user to interact with Paylocity using the browser. For more information, refer to the OAuth section in the Help documentation.

   The Pay Entry API

   The Pay Entry API is completely separate from the rest of the Paylocity API. It uses a separate Client ID and Secret, and must be explicitly requested from Paylocity for access to be granted for an account. The Pay Entry API allows you to automatically submit payroll information for individual employees, and little else. Due to the extremely limited nature of what is offered by the Pay Entry API, we have elected not to give it a separate schema, but it may be enabled via the UsePayEntryAPI connection property.

   Please be aware that when setting UsePayEntryAPI to true, you may only use the CreatePayEntryImportBatch & MergePayEntryImportBatchgtable stored procedures, the InputTimeEntry table, and the OAuth stored procedures. Attempts to use other features of the product will result in an error. You must also store your OAuthAccessToken separately, which often means setting a different OAuthSettingsLocation when using this connection property.

4. Click Save & Test
5. Navigate to the Permissions tab and update user-based permissions

Add a Personal Access Token

A Personal Access Token (PAT) is used to authenticate the connection to Connect AI from Windsurf. It is best practice to create a separate PAT for each integration to maintain granular access control.

1. Click the gear icon () at the top right of the Connect AI app to open Settings
2. On the Settings page, go to the Access Tokens section and click Create PAT
3. Give the PAT a descriptive name and click Create

4. Copy the token when displayed and store it securely. It will not be shown again

With the Paylocity connection configured and a PAT generated, Windsurf can now connect to Paylocity data.

Step 2: Configure Connect AI MCP in Windsurf

Next, configure the Connect AI Remote MCP Server in Windsurf so that the Cascade agent can discover and call live data tools through Connect AI.

1. Download and install the Windsurf IDE
2. Open Windsurf, click your profile icon in the top right, and select Windsurf Settings
3. Under the Cascade section, locate MCP Servers and click Open MCP Registry
4. In the MCP Marketplace, click Add custom MCP in the top right
5. This opens the mcp_config.json file. Paste the following JSON:

   {
       "mcpServers": {
           "cdata-mcp": {
               "serverUrl": "https://mcp.cloud.cdata.com/mcp",
               "headers": {
                   "Authorization": "Basic your_base64_encoded_email_PAT",
                   "Content-Type": "application/json"
               }
           }
       }
   }
   		

   Note: Windsurf will use Basic authentication with Connect AI. Combine your Connect AI user email and the PAT you created earlier in the format email:PAT, base64 encode the combined string, and prefix it with Basic. For example, given [email protected]:ABC123...XYZ789, the Authorization header value becomes something like: Basic dXNlckBkb21haW4uY29tOkFCQzEyMy4uLlhZWjc4OQ==

   
6. Save the mcp_config.json file and return to the MCP Registry
7. Under Installed, confirm that cdata-mcp is listed and marked as Enabled

With the MCP server registered and enabled, Windsurf is ready to query live Paylocity data through Connect AI.

Step 3: Query live Paylocity data from Windsurf

With the integration complete, use the Cascade chat panel in Windsurf to interact with live Paylocity data through natural language prompts.

1. On the top bar of Windsurf, switch from Editor to Agent to open a new Cascade chat
2. At the bottom of the chat panel, confirm that the cdata-mcp server is listed and the toggle is enabled
3. Start interacting with the agent by entering prompts like:
   • List all catalogs in my cdata-mcp connection
   • Show the available schemas and tables for Paylocity
   • Query the top 5 records from a table in Paylocity data
4. The Cascade agent calls the Connect AI MCP Server and returns live results from Paylocity data

At this point, your Windsurf IDE communicates with the Connect AI MCP Server and retrieves live Paylocity data through remote MCP directly from the editor.

Get CData Connect AI

To access hundreds of SaaS, Big Data, and NoSQL sources directly from your cloud applications, try CData Connect AI today! Download a free 14-day trial of CData Connect AI today, and as always, our Support Team is available to assist you with any questions you may have.