mait.sh1.69.2

Private beta: features and content may change. No warranty; use at your own risk.

Docs / Agent tools (MCP)

MCP RDP

Work through a reachable RDP desktop when the task needs a visible application.

For cross-platform QA, Windows operators, and agents validating graphical applications.

Read from the top for the basics; the later sections go deeper.

Beta
All components

What it doesBasics

  • Named RDP connections
  • Keyboard, pointer, and clipboard control
  • RemoteFX screenshots and WebM recording or H.264 passthrough recording
  • Audio transport
  • Optional beta change-aware recording

First useBasics

  1. Connect to the intended desktop, inspect it and verify one harmless interaction.
  2. Observe before sending input.
  3. Record or capture evidence, then close the session deliberately.

Everyday tasksEveryday use

Validate a GUI-only workflow

An agent must exercise a Windows application without an automation API.

  1. Create a named connection from a reviewed target profile.
  2. Capture the initial screen, then drive pointer and keyboard actions.
  3. Capture the resulting screen and drop the connection.

What you getThe remote workflow is completed through the same RDP session.

How to check: Before-and-after screenshots are published as session-scoped MCP resources.

Record a reviewable desktop run

A team needs durable evidence of a remote interaction sequence.

  1. Choose a decodable graphics mode and recording quality.
  2. Start a plain or condensed recording and perform the workflow.
  3. Stop the recording and save the returned resource before the session ends.

What you getA WebM recording, or compatible MP4 passthrough recording, is finalized.

How to check: The recording response, resource URI, and condensed event index identify the produced artifacts.

Settings to decideAdvanced

Environment or named profiles
Use RDP_* variables for one default target; use RDP_PROFILES_PATH and explicit connection IDs when a session may reach several reviewed targets.
Graphics mode
Choose rfx or legacy for screenshots and analysis; choose h264 for codec-copy MP4 recording.
Recording and retention
Set quality, duration, byte caps, audio, and condensing deliberately; keepOriginal can create a second audit file.
Reconnect policy
Leave transparent reconnect enabled for transport loss unless workflow semantics call for manual recovery.

CommandsAdvanced

$ rdp_connection_create({"connectionId":"qa","profile":"approved-target","template":"windows"})
$ rdp_screenshot({"connectionId":"qa","inlineImage":true})
$ rdp_type({"connectionId":"qa","action":"text","text":"sample"})
$ rdp_screenshot({"connectionId":"qa","inlineImage":true})
$ rdp_connection_drop({"connectionId":"qa"})

Problems and fixesHelp

What you seeCheckFix
The connection fails during NLA or CredSSP authentication.Verify username, password, domain, security mode, and the target account state.Correct the credential or target profile and reconnect.
Screenshots are unavailable or blank.Inspect the resolved graphics mode and confirm whether the connection uses H.264 passthrough.Reconnect with rfx, legacy, or the appropriate target template when decoded frames are required.
A recording cannot start or condensing is rejected.Check connection state for an active recording and validate the graphics mode and condense fields.Stop the existing recording, or recreate the connection with a decodable graphics mode and valid recording settings.
What you see
The connection fails during NLA or CredSSP authentication.
Check
Verify username, password, domain, security mode, and the target account state.
Fix
Correct the credential or target profile and reconnect.
What you see
Screenshots are unavailable or blank.
Check
Inspect the resolved graphics mode and confirm whether the connection uses H.264 passthrough.
Fix
Reconnect with rfx, legacy, or the appropriate target template when decoded frames are required.
What you see
A recording cannot start or condensing is rejected.
Check
Check connection state for an active recording and validate the graphics mode and condense fields.
Fix
Stop the existing recording, or recreate the connection with a decodable graphics mode and valid recording settings.

All MCP RDP problems and fixes →

Good to knowHelp

  • Named connections are session-scoped; configure an approved target and account before connecting.
  • H.264 passthrough records MP4; screenshots and WebM recording use RemoteFX.
  • Take a screenshot before and after input to confirm what the desktop received.