Build HubDB-Powered Applications in GitHub Copilot with CData Code Assist MCP
GitHub Copilot is an AI-powered coding assistant that integrates directly into Visual Studio Code and other IDEs. With support for MCP, GitHub Copilot can connect to local tools and enterprise data sources, enabling natural language interaction with live systems during development.
Model Context Protocol (MCP) is an open standard for connecting LLM clients to external services through structured tool interfaces. MCP servers expose capabilities such as schema discovery and live querying, allowing AI agents to retrieve and reason over real-time data safely and consistently.
In this article, we guide you through installing the CData Code Assist MCP for HubDB, configuring the connection to HubDB, connecting the Code Assist MCP add-on to GitHub Copilot, and querying live HubDB data from within Visual Studio Code.
Prerequisites
- Visual Studio Code is installed on your machine
- GitHub Copilot Chat extension is enabled in Visual Studio Code
- CData Code Assist MCP for HubDB has been installed
Step 1: Download and install the CData Code Assist MCP for HubDB
- To begin, download the CData Code Assist MCP for HubDB
- Find and double-click the installer to begin the installation
- Run the installer and follow the prompts to complete the installation
When the installation is complete, you are ready to configure your Code Assist MCP add-on by connecting to HubDB.
Step 2: Configure the connection to HubDB
- After installation, open the CData Code Assist MCP for HubDB configuration wizard
NOTE: If the wizard does not open automatically, search for "CData Code Assist MCP for HubDB" in the Windows search bar and open the application.
- In MCP Configuration > Configuration Name, either select an existing configuration or choose
to create a new one
- Name the configuration (e.g. "cdata_hubdb") and click OK
-
Enter the appropriate connection properties in the configuration wizard
There are two authentication methods available for connecting to HubDB data source: OAuth Authentication with a public HubSpot application and authentication with a Private application token.
Using a Custom OAuth App
AuthScheme must be set to "OAuth" in all OAuth flows. Be sure to review the Help documentation for the required connection properties for you specific authentication needs (desktop applications, web applications, and headless machines).
Follow the steps below to register an application and obtain the OAuth client credentials:
- Log into your HubSpot app developer account.
- Note that it must be an app developer account. Standard HubSpot accounts cannot create public apps.
- On the developer account home page, click the Apps tab.
- Click Create app.
- On the App info tab, enter and optionally modify values that are displayed to users when they connect. These values include the public application name, application logo, and a description of the application.
- On the Auth tab, supply a callback URL in the "Redirect URLs" box.
- If you're creating a desktop application, set this to a locally accessible URL like http://localhost:33333.
- If you are creating a Web application, set this to a trusted URL where you want users to be redirected to when they authorize your application.
- Click Create App. HubSpot then generates the application, along with its associated credentials.
- On the Auth tab, note the Client ID and Client secret. You will use these later to configure the driver.
Under Scopes, select any scopes you need for your application's intended functionality.
A minimum of the following scopes is required to access tables:
- hubdb
- oauth
- crm.objects.owners.read
- Click Save changes.
- Install the application into a production portal with access to the features that are required by the integration.
- Under "Install URL (OAuth)", click Copy full URL to copy the installation URL for your application.
- Navigate to the copied link in your browser. Select a standard account in which to install the application.
- Click Connect app. You can close the resulting tab.
Using a Private App
To connect using a HubSpot private application token, set the AuthScheme property to "PrivateApp."
You can generate a private application token by following the steps below:
- In your HubDB account, click the settings icon (the gear) in the main navigation bar.
- In the left sidebar menu, navigate to Integrations > Private Apps.
- Click Create private app.
- On the Basic Info tab, configure the details of your application (name, logo, and description).
- On the Scopes tab, select Read or Write for each scope you want your private application to be able to access.
- A minimum of hubdb and crm.objects.owners.read is required to access tables.
- After you are done configuring your application, click Create app in the top right.
- Review the info about your application's access token, click Continue creating, and then Show token.
- Click Copy to copy the private application token.
To connect, set PrivateAppToken to the private application token you retrieved.
- Log into your HubSpot app developer account.
- Click Connect to authenticate with HubDB through OAuth
- Click Save & Test to finalize the connection
This process creates a .mcp configuration file that GitHub Copilot will reference when launching the Code Assist MCP add-on. Now with your Code Assist MCP add-on configured, you are ready to connect it to GitHub Copilot.
Step 3: Connect the Code Assist MCP add-on to GitHub Copilot
- Download and install Visual Studio Code and enable the GitHub Copilot Chat extension
- Open or create the mcp.json file:
- For global configuration: %%APPDATA%%/Roaming/Code/User/mcp.json
- For project-specific configuration:
/.vscode/mcp.json
- Add the JSON code shown below and save the file
- After saving and testing your connection in the configuration wizard, click Next
- Select Github Copilot from the AI MCP Tool dropdown
- Follow the MCP Client Instructions to create the required configuration file
- Copy the displayed JSON code and paste it into your configuration file
Option 1: Manually add the MCP configuration
{
"servers": {
"cdata_hubdb": {
"command": "C:\Program Files\CData\CData Code Assist MCP for HubDB\jre\bin\java.exe",
"args": [
"-Dfile.encoding=UTF-8",
"-jar",
"C:\Program Files\CData\CData Code Assist MCP for HubDB\lib\cdata.mcp.hubdb.jar",
"cdata_hubdb"
]
}
}
}
NOTE: The command value should point to your Java 17+ java.exe executable, and the JAR path should point to the installed CData Code Assist MCP add-on .jar file. The final argument must match the MCP configuration name you saved in the CData configuration wizard (e.g. "cdata_hubdb").
Option 2: Copy the MCP configuration from the CData Code Assist MCP for HubDB UI
Step 4: Query live HubDB data in GitHub Copilot
- Launch Visual Studio Code and open the GitHub Copilot Chat interface. Select the tool icon to enable the configured Code Assist MCP add-on
- Ask questions about your HubDB data using natural language. For example:
"List all tables available in my HubDB data data connection."
- Start building with natural language prompts:
For my project, data from the NorthwindProducts is very important. Pull data from the most important columns like PartitionKey and Name.
GitHub Copilot is now fully integrated with CData Code Assist MCP for HubDB and can use the MCP tools to explore schemas and execute live queries against HubDB.
Build with Code Assist MCP. Deploy with CData Drivers.
Download Code Assist MCP for free and give your AI tools schema-aware access to live HubDB data during development. When you're ready to move to production, CData HubDB Drivers deliver the same SQL-based access with enterprise-grade performance, security, and reliability.
Visit the CData Community to share insights, ask questions, and explore what's possible with MCP-powered AI workflows.