Getting Started with the OpenEdge MCP Server on Linux

February 20, 2026 OpenEdge, Application Development

The OpenEdge MCP Server gives developers a powerful way to bring Model Context Protocol (MCP) capabilities to their OpenEdge applications—whether running on Windows or Linux. In this blog, we’ll walk through how to set up and use the OpenEdge MCP Server on Windows, verify your configuration, generate an OpenAPI specification and connect the server to GitHub Copilot in VS Code for seamless AI-assisted development workflows.

Prerequisites

  • Ubuntu Desktop 24.04.3 LTS
  • Python 3.11 or higher
  • Docker Community Edition (tested using Docker 29.1.2)
  • Distribution package for the OpenEdge MCP Server for Linux (available from the ESD): OPENEDGE_MCP_SERVER_1.0.0_LIN64.zip
  • Progress Data Object Service running on the network
  • VS Code and GitHub Copilot access to use the OpenEdge MCP Server from VS Code

Installation

1. Extract the MCP Server Packages

Start by extracting the Linux-specific MCP Server distribution package:

1. unzip -d ~/demo ~/Downloads/OPENEDGE_MCP_SERVER_1.0.0_LIN64.zip

This creates the working directory (~/demo) that contains everything needed to run the MCP Server locally.

Using the OpenEdge MCP Server

Navigate to the directory where you installed the server:

cd ~/demo

 

2. Load Docker Images

The MCP Server ships with container images that need to be loaded locally:

1. ./load_images.sh

 

3. Verify Your Environment

Use the mcpgen doctor command to confirm your configuration is ready. The tool will prompt you for your Python command and perform environment checks:

1. ./mcpgen doctor

 

4. Generate an OpenAPI Spec

To generate an OpenAPI specification from an OpenEdge Data Object Service, use:

1. ./mcpgen openapi-gen <url-to-openedge-service>

For example: “http://192.168.10.132:8810/Sports/web/pdo/SportsService”

This is one of the sources for service information that the OpenEdge MCP Server can use.

5. Start the MCP Server 

Once you have an OpenAPI spec (for example, openapi_SportsService.yml), spin up a new MCP Server instance:

1. ./mcpgen up --spec <openapi-spec>

Smoke tests will run automatically as part of the startup process.


 

Using the OpenEdge MCP Server with GitHub Copilot in VS Code

One of the most powerful parts of the MCP Server is the ability to securely expose OpenEdge services to AI models like Claude through GitHub Copilot in VS Code.

1. Open the Generated Server Directory

1. code ~/demo/generated/openedge-mcp-server/

 

2. Add the MCP Server in VS Code

  1. Open View -> Command Palette...
  2. Run: MCP: Add Server...
  3. Select HTTP (HTTPS) as the connection method
  4. Enter a temporary URL, such as:
  5. Choose Workspace as the configuration target
  6. Replace the content of the newly created.vscode/mcp.json with the version from client/mcp.json
  7. Click Start next to the server entry in the MCP panel:

3. Test It Through Copilot

  1. Open the Chat view in VS Code and enter a prompt such as: 1. Please list customers in Ohio.
  2. Copilot will ask permission to run the request through the MCP Server. Once allowed, it will return the customer list directly drom the Progress Data Object Service.

Related Resources

For troubleshooting, here is OpenEdge MCP Server-specific documentation:

Learn more about AI capabilities within the OpenEdge platform.

 

 

 

 

 

ABL OpenEdge OpenEdge developer

Jessica (Malakian) Newton

Progress Software empowers organizations to achieve transformational success in the face of disruptive change. Our software enables our customers to develop, deploy and manage responsible AI-powered applications and digital experiences with agility and ease.

Bio Overview

With over five years of experience in product marketing, Jessica has developed a strong foundation in application development and database management software. Her entire career has been at Progress, where she began as an intern in 2020 and have since contributed to multiple products, including the Progress Corticon business rules management system and others.

Jessica specializes in Go-To-Market strategy, execution and management for the Progress OpenEdge platform—leading both campaigns and new product launches, as well as content development, market and persona research and other product marketing activities. She consistently delivers results that drive customer retention and foster innovation. Her public speaking skills have been recognized, notably when she placed first in the Pi Sigma Epsilon South/Atlantic Regional Speakers Competition.

Her goal is to empower customers and partners to fully realize the value of their OpenEdge technology—enabling them to modernize, innovate, and achieve greater business impact by maximizing existing investments and seamlessly embracing new capabilities. Whether it’s migrating to the latest version of the OpenEdge applications or leveraging the Progress Data Platform, she is dedicated to showing organizations how to transform their technology into a strategic advantage. Currently, she focuses on multiple initiatives for the OpenEdge platform, including modernization, expanding the developer base, AI integration, security and more, helping customers and partners succeed in a rapidly evolving landscape. Outside of work, Jessica enjoys writing and reading, which help her stay creative and balanced.

Areas of Expertise

  • Product Marketing Strategy
  • Go-To-Market Execution and Management
  • Content Development
  • Market and Persona Research
  • Public Speaking

Credentials & Publications

  • Pi Sigma Epsilon South/Atlantic Regional Speakers Competition – First Place

Connect with Me

 

 

 

 

 


Read next What MCP Is and How It Modernizes the OpenEdge Platform