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

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

Getting Started

---

Step 1: Configure Amazon Athena connectivity for Windsurf

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

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

2. Select Amazon Athena from the Add Connection panel

3. Enter the necessary authentication properties to connect to Amazon Athena.

   Authenticating to Amazon Athena

   To authorize Amazon Athena requests, provide the credentials for an administrator account or for an IAM user with custom permissions: Set AccessKey to the access key Id. Set SecretKey to the secret access key.

   Note: Though you can connect as the AWS account administrator, it is recommended to use IAM user credentials to access AWS services.

   Obtaining the Access Key

   To obtain the credentials for an IAM user, follow the steps below:

   1. Sign into the IAM console.
   2. In the navigation pane, select Users.
   3. To create or manage the access keys for a user, select the user and then select the Security Credentials tab.

   To obtain the credentials for your AWS root account, follow the steps below:

   1. Sign into the AWS Management console with the credentials for your root account.
   2. Select your account name or number and select My Security Credentials in the menu that is displayed.
   3. Click Continue to Security Credentials and expand the Access Keys section to manage or create root account access keys.

   Authenticating from an EC2 Instance

   If you are using the CData Data Provider for Amazon Athena 2018 from an EC2 Instance and have an IAM Role assigned to the instance, you can use the IAM Role to authenticate. To do so, set UseEC2Roles to true and leave AccessKey and SecretKey empty. The CData Data Provider for Amazon Athena 2018 will automatically obtain your IAM Role credentials and authenticate with them.

   Authenticating as an AWS Role

   In many situations it may be preferable to use an IAM role for authentication instead of the direct security credentials of an AWS root user. An AWS role may be used instead by specifying the RoleARN. This will cause the CData Data Provider for Amazon Athena 2018 to attempt to retrieve credentials for the specified role. If you are connecting to AWS (instead of already being connected such as on an EC2 instance), you must additionally specify the AccessKey and SecretKey of an IAM user to assume the role for. Roles may not be used when specifying the AccessKey and SecretKey of an AWS root user.

   Authenticating with MFA

   For users and roles that require Multi-factor Authentication, specify the MFASerialNumber and MFAToken connection properties. This will cause the CData Data Provider for Amazon Athena 2018 to submit the MFA credentials in a request to retrieve temporary authentication credentials. Note that the duration of the temporary credentials may be controlled via the TemporaryTokenDuration (default 3600 seconds).

   Connecting to Amazon Athena

   In addition to the AccessKey and SecretKey properties, specify Database, S3StagingDirectory and Region. Set Region to the region where your Amazon Athena data is hosted. Set S3StagingDirectory to a folder in S3 where you would like to store the results of queries.

   If Database is not set in the connection, the data provider connects to the default database set in Amazon Athena.

   
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 Amazon Athena connection configured and a PAT generated, Windsurf can now connect to Amazon Athena 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 Amazon Athena data through Connect AI.

Step 3: Query live Amazon Athena data from Windsurf

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

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