MCP server

The MCP server feature in Remote Desktop Manager (RDM) is experimental and provided AS IS. Its use may involve transmitting sensitive or personal data to third-party AI/LLM providers, which Devolutions does not control.

Before proceeding, review our Security and confidentiality disclaimer for MCP server usage.

MCP server (experimental) allows you to communicate with Remote Desktop Manager using an MCP client with your preferred Large Language Model (LLM). Using this method, users can interact with the Remote Desktop Manager application through text-based prompts, allowing them to quickly and efficiently create vaults and folders, send commands to opened connections, and much more.

Although MCP servers operate by leveraging pre-configured tools, reference to these by the user is not necessary when writing prompts. For example, identifying entries with out-of-date credentials and batch updating them may require the use of multiple tools, but the user only needs to write a simple sentence asking for deprecated passwords to be updated.

The MCP server (experimental) tool can be disabled altogether by applying the appropriate Group Policy Object (GPO).

MCP server configuration

RDM MCP server is locally hosted on your desktop, and as such it is compatible with most MCP clients that support local MCPs. Below are some of the methods to configure it:

Using Visual Studio Code

1. In Visual Studio Code, open the command palette (CTRL+Shift+P), and run MCP: Open User Configuration. This opens the mcp.json file on your user profile or creates it for you if it is not found.

2. Connect to Remote Desktop Manager using one of the following methods:

   • With WinGet, run winget install jetsocat, then:

   {
   	"servers": {
   		"rdm-mcp": {
   			"type": "stdio",
   			"command": "jetsocat",
   			"args": ["mcp-proxy", "-", "np://RDM.MCP"]
   		}
   	},
   	"inputs": []
   }

   • Directly:

   {
   	"servers": {
   		"rdm-mcp": {
   			"type": "stdio",
   			"command": "C:\\Program Files\\Devolutions\\Remote Desktop Manager\\runtimes\\win-x64\\native\\jetsocat.exe",
   			"args": ["mcp-proxy", "-", "np://RDM.MCP"]
   		}
   	},
   	"inputs": []
   }

3. Open Remote Desktop Manager, and click on Tools – More tools – MCP server (experimental).

4. In the MCP server (experimental) window, click the Start button.

Using Claude Desktop

1. Open Claude Desktop, and click on Settings – Developer – Edit Config.

2. Open claude_desktop_config.json, and add the following content:

   {
   	"mcpServers": {
   		"rdm-mcp": {
   			"type": "stdio",
   			"command": "jetsocat",
   			"args": ["mcp-proxy", "-", "np://RDM.MCP"]
   		}
   	}
   }

   If you are using Claude Code (CLI), you can run this PowerShell script:

   claude mcp add-json rdm --scope user '{"type": "stdio", "command": "jetsocat", "args": ["mcp-proxy", "-", "np://RDM.MCP"]}'

   Or this cmdline:

   claude mcp add-json rdm --scope user '{"type": "stdio", "command": "jetsocat", "args": ["mcp-proxy", "-", "np://RDM.MCP"]}

3. Restart Claude Desktop. The server should then be listed in the Developer section and the tools available in the chat itself.

Using Codex CLI

1. Open Codex in Visual Studio Code.

2. Click on Settings in the Codex panel, and then MCP settings – Open config.toml. Click to create a new configuration file or use the curent one.

3. Add the following content:

   [mcp_servers."rdm-mcp"]
   
   command = 'C:\Program Files\Devolutions\Remote Desktop Manager\runtimes\win-x64\native\jetsocat.exe'
   
   args    = ['mcp-proxy', '-', 'np://RDM.MCP']

The MCP server can be set to launch on Remote Desktop Manager startup by checking the option located in File – Settings – AI – MCP server (experimental).

Tools

As stated above, Remote Desktop Manager MCP servers offers tools that can be called via prompts using your MCP client. MCP clients allow you to pick and choose the tools that best fit your needs.

A good way to reduce security risks is to disable tools capable of deleting sensitive data or complex infrastructure.

For more details about each tool, ask your LLM for a list or consult the tables below.

Workspace management
RDM_list_datasources	Lists all available workspaces in Remote Desktop Manager.

ENTRY MANAGEMENT

Basic entry operations
RDM_list_entries	Lists all the entries in a vault.
RDM_get_entry	Retrieves detailed information about a specific entry.
RDM_create_folders	Creates folder structures within a vault.

Entry modification
RDM_update_entry_name	Updates the name of an entry.
RDM_update_entry_host	Updates the host/server address of an entry.
RDM_update_entry_host_port	Updates the port number of an entry.
RDM_update_entry_username	Updates the Username field of an entry.
RDM_update_entry_password	Updates the Password field of an entry.
RDM_update_entry_domain	Updates the Domain field of an entry.
RDM_batch_edit_entries	Batch edits multiple entries using property mappings.

Entry organization
RDM_move_entries	Moves multiple entries to a different folder within the same vault.
RDM_copy_entries	Copies multiple entries to a different folder or vault root.

OTP management
RDM_add_otp_to_entry	Adds a one-time password (OTP) or multifactor authentication (MFA) configuration to an entry.
RDM_get_entry_otp	Generates and retrieves the current OTP for an entry.

CONNECTION MANAGEMENT

Common actions
close_connection	Closes a connection tab.
get_connection_info	Gets the information (name, type, ID) of a connection.
RDM_open_connection	Opens a session entry in Remote Desktop Manager.
RDM_list_opened_connections	Lists all currently opened connections.
RDM_list_opened_connection_actions	Lists available actions for opened connections (by type).
RDM_execute_opened_connection_action	Executes actions on opened connections.

RDP connections
send_ctrl_alt_delete	Sends CTRL+Alt+Delete to an RDP session.
send_command	Executes commands via Devolutions Agent on the remote machine.
logoff	Logs off from an RDP session.
toggle_view_only	Toggles the view-only mode.

SSH connections
send_command	Sends commands to an SSH terminal.
send_command_from_a_vault_script_entry	Executes vault script entries on an SSH terminal.
send_break	Sends a break signal (CTRL+C) to an SSH terminal.
clear_terminal	Clears the SSH terminal’s screen.
get_terminal_status	Retrieves the SSH terminal’s connection status and state.

SQL Server connections
start_sql_agent	Starts the SQL Server Agent service.
stop_sql_agent	Stops the SQL Server Agent service.
restart_sql_server	Restarts the SQL Server service.
refresh_data	Refreshes SQL Server data (databases, logins, etc.).
create_new_query	Creates a new SQL query tab with specified query text and database.
get_database_schema	Retrieves a comprehensive database schema (tables, columns, relationships, etc.).

Hyper-V virtual machines
list_vms	Lists all virtual machines on a Hyper-V host.
start_vm	Starts a virtual machine.
stop_vm	Stops a virtual machine.
restart_vm	Restarts a virtual machine.

vault management
RDM_create_vaults	Creates one or more vaults with intelligent prompting for missing information.
RDM_list_vaults	Lists all the vaults in a specified workspace.
RDM_list_vault_templates	Lists available vault templates for a specified workspace.

Metadata and templates
RDM_list_entry_metadata	Provides metadata about entry types and their localized display names.
RDM_list_entry_property_mappings	Lists all available entry properties which can be modified via batch editing.
RDM_create_custom_entry_template	Creates custom entry templates with specified fields.

Logging and audit
RDM_get_entry_logs	Retrieves activity logs for a specific entry within a date range.