Integrate Live Adobe Commerce 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 Adobe Commerce data. This enables developers to list catalogs, inspect schemas, and query records from Adobe Commerce data within the IDE using natural language prompts.

This article explains how to configure Adobe Commerce 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 Adobe Commerce data from the Cascade chat.

Step 1: Configure Adobe Commerce connectivity for Windsurf

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

1. Log into Connect AI, click Sources, and then click Add Connection
👁 Adding a connection in Connect AI

2. Select Adobe Commerce from the Add Connection panel
👁 Selecting data source

3. Enter the necessary authentication properties to connect to Adobe Commerce.

   Adobe Commerce uses the OAuth 1 authentication standard. To connect to the Adobe Commerce REST API, obtain values for the OAuthClientId, OAuthClientSecret, and CallbackURL connection properties by registering an app with your Adobe Commerce system. See the "Getting Started" section in the help documentation for a guide to obtaining the OAuth values and connecting.

   You will also need to provide the URL to your Adobe Commerce system. The URL depends on whether you are using the Adobe Commerce REST API as a customer or administrator.

   • Customer: To use Adobe Commerce as a customer, make sure you have created a customer account in the Adobe Commerce homepage. To do so, click Account -> Register. You can then set the URL connection property to the endpoint of your Adobe Commerce system.

   • Administrator: To access Adobe Commerce as an administrator, set CustomAdminPath instead. This value can be obtained in the Advanced settings in the Admin menu, which can be accessed by selecting System -> Configuration -> Advanced -> Admin -> Admin Base URL.

     If the Use Custom Admin Path setting on this page is set to YES, the value is inside the Custom Admin Path text box; otherwise, set the CustomAdminPath connection property to the default value, which is "admin".

   👁 Configuring a connection (Salesforce is shown)
   
4. Click Save & Test
5. Navigate to the Permissions tab and update user-based permissions
👁 Updating 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
👁 Creating a new PAT

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

With the Adobe Commerce connection configured and a PAT generated, Windsurf can now connect to Adobe Commerce 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 👁 Opening Windsurf Settings from the profile menu
   
3. Under the Cascade section, locate MCP Servers and click Open MCP Registry 👁 Opening the MCP Registry from Cascade settings
   
4. In the MCP Marketplace, click Add custom MCP in the top right 👁 Adding a custom MCP server
   
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==

   👁 Pasting Connect AI MCP Server configuration
   
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 👁 Confirming cdata-mcp is installed and enabled
   

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

Step 3: Query live Adobe Commerce data from Windsurf

With the integration complete, use the Cascade chat panel in Windsurf to interact with live Adobe Commerce 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 👁 Enabling the cdata-mcp server in the Cascade chat
   
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 Adobe Commerce
   • Query the top 5 records from a table in Adobe Commerce data
4. The Cascade agent calls the Connect AI MCP Server and returns live results from Adobe Commerce data 👁 Querying live data from Cascade in Windsurf
   

At this point, your Windsurf IDE communicates with the Connect AI MCP Server and retrieves live Adobe Commerce 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.