215111 Stack

Overview

Enterprises face a critical obstacle when attempting to deploy AI agents: the desktop applications and legacy systems that drive most business processes are often inaccessible to modern AI. According to a 2024 Gartner report, 75% of organizations run legacy applications lacking modern APIs, and 71% of Fortune 500 companies rely on mainframe systems without adequate programmatic interfaces. This forces many organizations to choose between delaying AI adoption or undertaking expensive, risky modernization projects.

Amazon WorkSpaces now enables AI agents to securely operate desktop applications without the need for application modernization—directly addressing this challenge. The same managed virtual desktops trusted by millions of employees can now serve AI agents, transforming WorkSpaces into infrastructure for scaling enterprise productivity. Agents operate within your existing WorkSpaces environment, eliminating the need for custom API builds, application migrations, or new infrastructure management.

As Chris Noon, Director at Nuvens Consulting, noted: “WorkSpaces lets our clients give AI agents the same secure, governed desktop environment their employees already use—no custom API integrations, full audit trails, and enterprise-grade isolation out of the box. For regulated industries, that’s not a nice-to-have—it’s the baseline.”

Prerequisites

Before setting up AI agent access with Amazon WorkSpaces, ensure you have:

• An AWS account with appropriate permissions to create and manage WorkSpaces resources (typically WorkSpaces_Admin or equivalent IAM policies).
• A WorkSpaces environment already configured, including a directory (e.g., AWS Managed Microsoft AD or Simple AD) and at least one running WorkSpace instance.
• Basic familiarity with the AWS Management Console, IAM roles, and CloudTrail for audit logging.
• An AI agent framework that supports the Model Context Protocol (MCP), such as LangChain, CrewAI, or Strands Agents.
• Network connectivity between the agent's runtime environment and the WorkSpaces VPC endpoints (typically via AWS PrivateLink).

Step-by-Step Guide

Creating Your WorkSpaces Application Stack

Start by navigating to the Amazon WorkSpaces console. In the left navigation pane, choose Application stacks and then click Create stack. The stack defines the environment for agent connections, including fleet associations and VPC endpoints.

1. Name and describe your stack (e.g., AI-Agent-WorkSpace-Stack).
2. Select a fleet—a group of identical WorkSpace instances. Choose or create a fleet that matches your agent's performance needs.
3. Configure VPC endpoints to establish secure connectivity. Use the same VPC as your WorkSpaces directory.

Click Next to proceed to Step 3, where the critical AI agent option appears.

Enabling AI Agent Access

In Step 3 of the stack creation wizard, you'll see a new AI agents section with two options:

• No AI agent access (default)—for standard human-only WorkSpaces.
• Add AI agents—allows agents to securely access and operate applications using their own identity and permissions.

Select Add AI agents. This immediately enables MCP support and configures the necessary IAM roles for agent authentication.

Complete the remaining steps (review and create) to finalize the stack. Once created, note the Stack ID; you'll use it in agent configuration.

Configuring IAM Permissions and Audit Trails

Agents authenticate through AWS Identity and Access Management (IAM). Create an IAM role that the agent will assume, with permissions to access the WorkSpaces application stack. Attach a policy similar to the following:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "workspaces:Connect",
        "workspaces:DescribeApplicationStacks",
        "workspaces:StartApplication"
      ],
      "Resource": "arn:aws:workspaces:REGION:ACCOUNT:application-stack/STACK_ID"
    }
  ]
}

Ensure the agent's runtime uses this role for API calls.

For audit trails, enable AWS CloudTrail for your account (if not already active) and log all WorkSpaces API operations. Additionally, configure Amazon CloudWatch logs to capture agent session activity. This provides a complete, tamper-evident record of agent actions within the WorkSpace.

Integrating with Agent Frameworks via MCP

Amazon WorkSpaces supports the Model Context Protocol (MCP), an industry standard that allows any compliant agent framework to interact with the WorkSpace. Here's a high-level integration example using the LangChain framework:

1. Install the MCP client library in your agent's environment (available via pip for Python).

pip install mcp-client

2. Configure the agent to connect to your WorkSpaces stack:

from mcp_client import WorkSpacesMCPClient

client = WorkSpacesMCPClient(
    region='us-east-1',
    stack_id='your-stack-id',
    role_arn='arn:aws:iam::account:role/AgentRole'
)
session = client.create_session()

3. Use the session to perform actions within the desktop environment, such as opening an application or clicking a button:

session.open_application('calc.exe')
session.click_button('Calculate')
result = session.get_screen_content()

Similar integration steps apply for CrewAI and Strands Agents—each provides a compatible MCP adapter.

Common Mistakes to Avoid

• Insufficient IAM permissions: Ensure the agent's role includes workspaces:Connect and workspaces:StartApplication; otherwise, authentication will fail.
• Ignoring VPC endpoint configuration: Agents must communicate via private endpoints. If endpoints are missing or misconfigured, connections time out.
• Using a fleet designed for humans: Some fleets may have session limits or UI customizations unsuitable for agents. Use a dedicated fleet or configure session timeouts appropriately.
• Forgetting to enable CloudTrail: Without audit logging, you lose visibility into agent actions—critical for compliance and troubleshooting.
• Assuming all agent frameworks work out of the box: While MCP standardizes integration, verify that your chosen framework's MCP client is updated to work with WorkSpaces (check documentation).

Summary

Amazon WorkSpaces now provides a secure, governed desktop environment for AI agents, eliminating the need for API modernization or infrastructure overhauls. By following this guide—creating an application stack, enabling AI agent access, configuring IAM and audit trails, and integrating via MCP—you can equip your agents to operate legacy desktop applications within existing security boundaries. This approach directly addresses the challenge of inaccessible business applications, enabling faster AI adoption without compromising compliance or control. Start by assessing your current WorkSpaces setup and creating a dedicated stack for agent operations.