Progress OpenEdge AI Assistant

Secure authentication and token management for Progress OpenEdge MCP ABL services using Progress Data Cloud (PDC) API Keys.

The Progress OpenEdge AI Assistant extension provides seamless authentication and token management for accessing Progress OpenEdge MCP (Model Context Protocol) ABL documentation services using Progress Data Cloud (PDC) API keys. Works universally across VS Code, Windsurf, Antigravity, KiloCode, Continue, and Claude Code environments.

Dependencies

• Python 3.9 or higher must be installed and available in system PATH along with pip, for the mcp proxy to function.

🎯 Multi-IDE Support

• VS Code: .vscode/mcp.json (workspace) or /mcp.json (global, configurable)
• Windsurf: ~/.codeium/windsurf/mcp_config.json
• Antigravity: ~/.gemini/antigravity/mcp_config.json
• KiloCode: .kilocode/mcp.json
• Continue: .continue/mcpServers/openedge-abl.yaml
• Claude Code: .mcp.json (project), ~/.claude.json (local or user) — scope configurable
• Auto-detection of IDE environment on startup

📊 Status Bar Integration

• Real-time connection status indicator
• Bearer token expiry countdown (shows hours and minutes remaining)
• One-click access to connection details
• Visual alerts for authentication failures

🌐 Supported IDEs

Auto-Detection: Extension automatically detects your IDE and uses the correct config location.

⚙️ Configuration Settings

Global config path (when mcpAuth.configLocation is set to global):

• Windows: %APPDATA%\Code\User\mcp.json
• macOS: ~/Library/Application Support/Code/User/mcp.json
• Linux: ~/.config/Code/User/mcp.json

To change the setting: open VS Code Settings (Ctrl+,), search for mcpAuth.configLocation, and select workspace or global.

🚀 Quick Start

Getting Your PDC API Key

1. Register for a Progress Data Cloud User Account
   • Before using the OpenEdge MCP Connector, you must first register for a Progress Data Cloud (PDC) user account.
   • 📖 Follow the registration steps here: Register for Progress Data Cloud user account
2. Once registered, visit Progress Data Cloud
3. Sign in with your Progress account
4. Click on the Profile Icon (top right corner)
5. Click on your email address in the dropdown menu
6. You will be taken to the Account Settings page
7. Look for the Your API Key: section
   • If you see an API key already displayed, you already have a key
   • If no key is shown, you need to generate one
8. Click on Manage your API Key option
9. A side panel will open showing the Generate your API Key section
10. Set the API key expiration:
    • Default expiration is shown (this is the maximum allowed)
    • You can provide a lower expiration in minutes if needed
    • You cannot exceed the maximum allowed expiration
    • Leave as default if you want maximum expiration
11. Click Generate to create your API Key
12. Copy the generated API key and use it for authentication in the extension

Security Note: To protect your account, login attempts are rate-limited to 5 attempts per minute.

Choose MCP Config Location (VS Code Only)

Important: Before logging in, decide where the MCP configuration file should be stored. This setting does not apply to Windsurf, Antigravity, or KiloCode — those IDEs use a fixed global location.

1. Open VS Code Settings (Ctrl+,)
2. Search for mcpAuth.configLocation
3. Select your preferred option:
   • workspace (default) — stores config in .vscode/mcp.json inside your project
   • global — stores config in the VS Code user settings directory, shared across all workspaces

Global config paths (when set to global):

• Windows: %APPDATA%\Code\User\mcp.json
• macOS: ~/Library/Application Support/Code/User/mcp.json
• Linux: ~/.config/Code/User/mcp.json

Login

1. Login with API Key
   • Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (macOS)
   • Type and run: Progress OpenEdge AI Assistant: Login to MCP
   • Enter your PDC API Key when prompted
   • Wait for authentication to complete
   • ✅ MCP configuration created automatically in the location chosen above

That's it! The extension will:

• ✅ Start proxy automatically when IDE opens
• ✅ Validate bearer token and API key every 40 seconds
• ✅ Refresh bearer token automatically at 55 minutes
• ✅ Show connection status in status bar
• ✅ Handle bearer token expiry gracefully (no false "API key revoked" errors)

⚙️ Other Configuration Settings

📋 Available Commands

Access commands via Command Palette (Ctrl+Shift+P or Cmd+Shift+P):

📊 Status Messages & UI Elements

Status Bar Badge

The extension displays a status bar item in the bottom-right corner with real-time connection status:

Click on the status bar badge to see detailed connection information including token expiry time.

Success Messages

The extension shows these success notifications:

Info Messages

Warning Messages

Error Messages

Quick Action Buttons

When errors occur, the extension provides quick action buttons for easy resolution:

🔧 Troubleshooting

Commands Not Showing in Command Palette

Symptom: Can't find "Login to MCP" or other commands

Solutions:

1. Reload IDE window (Ctrl+Shift+P → "Developer: Reload Window")
2. Check extension is installed and enabled in Extensions panel
3. Look in Command Palette with category filter: type >Progress OpenEdge AI Assistant
4. Verify IDE version (VS Code 1.85.0+ required)

Connection Issues

Symptom: "Cannot reach Progress Data Cloud" or "Bearer token validation failed"

Solutions:

1. Run Clear Stored API Key command
2. Get a fresh API key from Progress Data Cloud portal (openedge.data.progress.cloud)
3. Run Login to MCP with new API key
4. Check network connectivity to openedge.data.progress.cloud
5. Verify no proxy/firewall blocking HTTPS traffic

Python Not Found (Proxy Only)

Symptom: "Python is not installed or not found in PATH"

Solutions:

1. Install Python 3.9 or higher from python.org
2. During installation, check "Add Python to PATH" option
3. Restart IDE after installing Python
4. Verify by running python --version in terminal (should show 3.9+)
5. Try python3 --version if python doesn't work

Auto-Refresh Not Working

Symptom: Bearer token expires and service stops

Solutions:

1. Check IDE is not in sleep/hibernation mode
2. Verify mcpAuth.autoRefreshInterval setting (should be 55 minutes)
3. Check IDE Output panel (View → Output → select "Progress OpenEdge AI Assistant") for extension logs
4. Run Refresh Token Now manually to test refresh mechanism
5. Check status bar for error indicators

API Key Rejected / Revoked

Symptom: "API Key is invalid or expired" after working previously

Solutions:

1. Verify API key hasn't been revoked in Progress Data Cloud portal
2. Check API key hasn't reached its expiration date
3. Generate new API key in Progress Data Cloud portal
4. Use Clear Stored API Key command
5. Login with new API key using Login to MCP command

Login Rate Limited

Symptom: "Too many login attempts. Please wait X seconds."

Solutions:

1. Wait for the specified time (usually less than 1 minute)
2. Check if you have multiple VS Code instances trying to login simultaneously
3. Verify you are using the correct API Key to avoid repeated failures

Extension Not Starting

Symptom: No status bar item, commands don't work

Solutions:

1. Check IDE version (VS Code 1.85.0+ required)
2. Check extension is enabled in Extensions panel
3. Look for error messages in Output panel
4. Try uninstalling and reinstalling extension
5. Check IDE logs: Help → Toggle Developer Tools → Console tab

Config File Not Created

Symptom: After login, MCP config file not found

Solutions:

1. Check your IDE type is detected correctly
2. Expected locations:
   • VS Code (workspace): .vscode/mcp.json in workspace
   • VS Code (global): %APPDATA%\Code\User\mcp.json (Windows) / ~/.config/Code/User/mcp.json (Linux)
   • Windsurf: ~/.codeium/windsurf/mcp_config.json
   • Antigravity: ~/.gemini/antigravity/mcp_config.json
   • Continue: .continue/mcpServers/openedge-abl.yaml
3. Check the mcpAuth.configLocation setting if using VS Code (default: workspace)
4. Check file permissions in target directory
5. Try running Disconnect MCP then Login to MCP again

🌍 Network Requirements

Required Endpoints

Firewall Configuration

If behind corporate firewall, allow outbound HTTPS (port 443) to:

• *.progress.cloud
• Specific: openedge.data.progress.cloud

Proxy Support

The extension uses IDE's proxy settings automatically. No additional configuration needed.

📄 License & Legal

The following files are included with this extension and can be viewed via the Command Palette (Ctrl+Shift+P):

Version 1.0.0

💬 Feedback & Support

Support and Operations

If you experience access or availability problems with the Progress OpenEdge AI Assistant, report them through:

• Progress Technical Support via SupportLink
• Phone: +1-781-280-4999

Community

• Discord Community: Join discussions about the Progress OpenEdge AI Assistant on our Discord Channel
• Bug Reports: Found a bug or have a feature request? Share it on our Discord channel