MCP Extension Copilot Extension

VS Code Integration

Two ways to use ManageLM in VS Code: a one-click MCP install for native Copilot Chat agent mode, or the ManageLM extension for the dedicated @managelm chat participant.

Install MCP Download Extension MCP install is recommended. The extension provides the @managelm participant if you prefer that style.

Choose Your Integration

Both paths work side by side — pick what suits your workflow. Most users want the MCP install: it's faster, gets every ManageLM tool automatically, and uses VS Code's native MCP support.

MCP IntegrationVS Code Extension
InstallOne click via deeplinkDownload .vsix + install
Where it shows upCopilot Chat in Agent mode — tools pickerCopilot Chat as @managelm participant
AuthenticationOAuth 2.0 with PKCE (browser flow)API key in VS Code settings
Tool surfaceFull ManageLM skill catalog (auto-updates)13 hand-picked tools shipped with the extension
UpdatesServer-side — nothing to reinstallRe-install the .vsix when new versions ship
VS Code version1.99+ (April 2025)1.85+
Copilot subscriptionRequired (Agent mode)Required (Chat participant)

Can I have both? Yes — they don't conflict. You can install MCP for general agent-mode use and keep the extension for the @managelm shortcut.

MCP Integration

This is the modern, recommended path. ManageLM exposes a remote MCP server at https://app.managelm.com/mcp. VS Code 1.99+ has native MCP support built into Copilot Chat — no extension needed.

MCP — Install

One-click install

Click the button below. VS Code opens a confirmation dialog with the server pre-filled — click Install.

Install MCP in VS Code

Manual config

If the deeplink doesn't fire, open the Command Palette and run MCP: Open User Configuration, then paste:

mcp.json
{
  "servers": {
    "managelm": {
      "type": "http",
      "url": "https://app.managelm.com/mcp"
    }
  }
}

Self-hosted users: Replace app.managelm.com with your own portal URL.

MCP — Use

Daily usage

  1. Open Copilot Chat (Ctrl/Cmd+Alt+I)

  2. Switch the chat mode to Agent (dropdown at the top of the chat)

  3. Type a request: "list my managelm servers", "check disk usage on web-prod-01", "run a security audit on production"

  4. First tool call opens your browser for OAuth login — approve, and you're connected. Subsequent calls happen silently.

The tools picker (small icon at the bottom of the chat input) lets you toggle which ManageLM tools the agent may call. Leave them all on for the full surface.

VS Code Extension

The classic ManageLM extension adds a dedicated @managelm chat participant to Copilot Chat. It's a leaner surface (13 curated tools), uses an API key instead of OAuth, and works on older VS Code versions (1.85+) that don't have native MCP support.

Extension — Install

From the marketplace

Search for ManageLM in the Extensions panel, or run:

terminal
code --install-extension managelm.managelm

From VSIX

Download the .vsix from GitHub Releases and install:

terminal
code --install-extension managelm-1.0.0.vsix

API key setup

  1. Open Settings (Cmd+, / Ctrl+,) and search for ManageLM

  2. Set your API Key — find it in your ManageLM portal under Settings > MCP & API

  3. (Optional) If self-hosting, set the Portal URL to your own portal address

Extension — Use

Daily usage

Open Copilot Chat (any mode) and type @managelm followed by your request:

copilot chat
@managelm show me all my servers
@managelm check disk usage on web-prod-01
@managelm install nginx on all servers in the staging group
@managelm run a security audit on db-primary
@managelm which servers are running Docker?

Tools shipped with the extension

ToolDescription
listAgentsList all servers with status, health, OS, IP
agentInfoDetailed info for a single server
runTaskExecute a skill-based task on a server
getTaskStatusCheck task status and result
getTaskHistoryRecent tasks for a server
approveAgentApprove a pending agent enrollment
listSkillsList skills available in your account
agentSkillsSkills assigned to a specific server
getSecuritySecurity audit findings for a server
getInventorySystem inventory (packages, services, containers)
runSecurityAuditStart a security audit on a server
runInventoryScanStart an inventory scan on a server
accountInfoAccount plan, members, and usage

What You Can Do

Either integration lets you:

The MCP integration gets the full skill catalog (firewall, docker, apache, nginx, mysql, postgresql, backup, certificates, git, dns, vpn, kubernetes, …) automatically. The extension ships with a fixed set of 13 tools that cover the common cases.

Security

Requirements

Troubleshooting

MCP — "Install MCP" deeplink does nothing

Make sure VS Code is installed and registered as the vscode:// protocol handler. Open VS Code first, then click the deeplink again. If it still fails, use the manual config above.

MCP — Server is "Started" but no tools appear

Switch the chat mode to Agent (the tools picker only shows in Agent mode). If still empty, type a request directly — the OAuth flow runs on first call and tools register after authentication.

MCP — OAuth fails in Safari

Safari's Intelligent Tracking Prevention can block the loopback callback. Switch your default browser to Chrome or Firefox for the sign-in step, then switch back. Auth tokens persist after.

Extension — API key not configured

Open VS Code Settings (Ctrl+,), search for ManageLM, and enter your API key from the portal under Settings > MCP & API.

Extension — @managelm not appearing in chat

The extension requires GitHub Copilot Chat. Make sure github.copilot-chat is installed and active. Reload VS Code (Ctrl+Shift+P > Reload Window) after enabling.

Connection refused or timeout (both)

Verify your portal URL is correct and reachable. Default is https://app.managelm.com. If self-hosting, make sure your portal is running and accessible from your machine.

No agents listed (both)

Either no agents are enrolled, or your account doesn't have access. Check the portal dashboard to verify.

Task timeout

Long-running tasks can exceed the default timeout. Break them into smaller steps, or check task status with a follow-up message.