Progress OpenEdge MCP Connector For ABL

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

This 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, and Continue 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
• Windsurf: ~/.codeium/windsurf/mcp_config.json
• Antigravity: ~/.gemini/antigravity/mcp_config.json
• KiloCode: .kilocode/mcp.json
• Continue: .continue/mcpServers/openedge-abl.yaml
• 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.

🚀 Quick Start

Getting Your PDC API Key

1. Visit Progress Data Cloud
2. Sign in with your Progress account
3. Click on the Profile Icon (top right corner)
4. Click on your email address in the dropdown menu
5. You will be taken to the Account Settings page
6. 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
7. Click on Manage your API Key option
8. A side panel will open showing the Generate your API Key section
9. 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
10. Click Generate to create your API Key
11. 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.

MCP Connector Login

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

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)

📋 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 MCP
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 MCP") 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: .vscode/mcp.json in workspace
   • Windsurf: ~/.codeium/windsurf/mcp_config.json
   • Antigravity: ~/.gemini/antigravity/mcp_config.json
   • Continue: .continue/mcpServers/openedge-abl.yaml
3. Check file permissions in target directory
4. 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.

Version 1.0.0

💬 Feedback & Support

Join our community and get help:

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