How to Access Live Dynamics 365 Business Central Data in Visual Studio Code via Cline

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
Run the CData MCP Server for Dynamics 365 Business Central on Windows Subsytem for Linux (WSL) and connect to live Dynamics 365 Business Central data from the Cline extension in Visual Studio Code.

Cline is an autonomous coding agent right in your IDE, capable of creating/editing files, running commands, using the browser, and more with your permission every step of the way. When paired with the CData MCP Server for Dynamics 365 Business Central, you get live access to CRM data within your IDE, enabling you to build, test, and validate data-driven features using real-time schema and records without ever leaving your development environment.

This article outlines how to run the CData MCP Server for Dynamics 365 Business Central on WSL (Windows Subsystem for Linux) and connect to it from the Cline extension in Visual Studio Code on Windows.

Background

CData MCP Servers are typically designed for clients like Claude Desktop. However, when attempting to use the server via the Cline extension in Windows VS Code, the following error occurred:

MCP error -32000: Connection closed

This issue is suspected to be caused by I/O handling problems in the stdio transport implementation on the Windows version of the Cline extension.

Prerequisites

  • Visual Studio Code installed on Windows
  • Cline extension installed and configured in VS Code
  • Windows Subsystem for Linux (WSL) installed with a working Linux distribution (e.g., Ubuntu)
  • Java 21+ JRE installed in WSL
  • CData MCP Server for Dynamics 365 Business Central installed on Windows

Step 1: Authenticate with Dynamics 365 Business Central (on Windows)

Before running the MCP Server in WSL, you must complete authentication flow in a Windows environment. This ensures all necessary credentials are generated and stored properly. Find and run the "CData MCP Server for Dynamics 365 Business Central" or execute the MCP Server JAR file to open the configuration wizard.

java -jar "C:\Program Files\CData\CData MCP Server for Dynamics 365 Business Central 2024\lib\cdata.mcp.d365businesscentral.jar"

Connecting to Dynamics 365 Business Central

To authenticate to Dynamics 365 Business Central, you must select an AuthScheme and provide the required properties (OAuth by default).

All Methods

Specify the OrganizationUrl. If you have multiple companies in your organization, you must also specify the Company to indicate which company you would like to connect to. Company does not need to be specified if you have only one company.

Access Key

To authenticate with an Access Key, set AuthScheme to "AccessKey" and provide the User and AccessKey properties.

To obtain the User and AccessKey values, navigate to the Users page in Dynamics 365 Business Central and then click on Edit. The User Name and Web Service Access Key values are what you will enter as the User and AccessKey connection string properties. Note that the User Name is not your email address. It is a shortened user name.

If you wish to authenticate through other methods, refer to the Help documentation.

Configuring the CData MCP Server

Name your MCP Server (e.g. cdatad365businesscentral), enter the required connection properties, and click "Connect."

Upon successful connection, the following directory and files will be created:

C:\Users\<username>\AppData\Roaming\CData\d365businesscentral Provider\
 |-- cdatad365businesscentral.mcp
 |-- (other supporting config files)

Step 2: Copy the MCP Server Configuration into WSL

Next, copy the entire configuration folder from Windows into your WSL environment.

mkdir -p ~/.config/CData/
cp -r /mnt/c/Users/<username>/AppData/Roaming/CData/"d365businesscentral Provider" ~/.config/CData/

Ensure the destination path matches exactly: ~/.config/CData/d365businesscentral Provider/.

Step 3: Install the MCP Server on WSL

Install Java and place the MCP Server JAR in the desired location within WSL:

sudo apt update
sudo apt install openjdk-21-jre-headless
sudo mkdir -p /opt/cdata/mcp_d365businesscentral/lib
sudo cp /mnt/c/Program\ Files/CData/CData\ MCP\ Server\ for\ Dynamics 365 Business Central\ 2024/lib/cdata.mcp.d365businesscentral.jar /opt/cdata/mcp_d365businesscentral/lib/

Step 4: Configure Cline

Now, configure the Cline extension to launch the MCP Server inside WSL using the wsl command.

Create or update cline_mcp_settings.json with the following content:

{
  "mcpServers": {
    "cdatad365businesscentral": {
      "autoApprove": ["*"],
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "wsl",
      "args": [
        "-d",
        "Ubuntu", // Replace with your installed WSL distro name
        "--",
        "/usr/bin/java",
        "-jar",
        "/opt/cdata/mcp_d365businesscentral/lib/cdata.mcp.d365businesscentral.jar",
        "cdatad365businesscentral"
      ],
      "env": {
        "JAVA_TOOL_OPTIONS": "-Xmx2g"
      }
    }
  }
}

Note: Replace Ubuntu with your actual WSL distribution name (e.g., Ubuntu-22.04). Run wsl -l in PowerShell or CMD to confirm.

Step 5: Interact with Live Data in Cline

From within Visual Studio Code, you can now run MCP commands through the Cline extension.

cdatad365businesscentral_get_tables
cdatad365businesscentral_get_columns Accounts

If configured correctly, these commands will return a list of available Dynamics 365 Business Central objects and metadata, allowing you to interact with your CRM schema in real time.

Try natural language prompts like:

  • "Generate a React form to create a new Dynamics 365 Business Central Lead."
  • "Write a Python function to pull Opportunities closed this quarter."

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.

Ready to get started?

Download a free Dynamics 365 Business Central MCP Server to get started:

 Download Now

Learn more:

Dynamics 365 Business Central (NAV) Icon Dynamics 365 Business Central MCP Server

The CData MCP Server for Dynamics 365 Business Central (NAV) allows you to connect with live Dynamics 365 Business Central (NAV) data, directly from LLMs that support MCP.