Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

WorkSpaces Applicazioni (server MCP)

Il server WorkSpaces Applications MCP è un servizio completamente gestito che fornisce agli agenti AI strumenti MCP (Model Context Protocol) per interagire con le applicazioni desktop durante le sessioni di streaming. Gli agenti possono fare clic sui pulsanti, inserire testo, scorrere e acquisire schermate del desktop.

Panoramica di

Quando si abilita l'accesso degli agenti su uno stack, gli agenti possono connettersi al server MCP gestito per interagire con le applicazioni desktop. Il server MCP gestisce la comunicazione tra l'agente e la sessione di streaming. L'agente invia le richieste di strumenti MCP e il server le esegue sul desktop.

Il server MCP è ospitato nel cloud. AWS Non è necessario installare o mantenere alcun componente del server. Il server utilizza Streamable HTTP come protocollo di trasporto.

L'accesso agli agenti supporta sia le flotte non aggiunte al dominio che quelle aggiunte al dominio. Il metodo di connessione varia in base al tipo di parco veicoli. Non-domain-joined le flotte autenticano la sessione con un URL di streaming, mentre le flotte aggiunte al dominio si autenticano tramite la federazione SAML. Per il percorso che corrisponde alla tua flotta, consulta. Connessione al server MCP

Connessione al server MCP

Gli agenti si connettono al server MCP sul seguente dispositivo:

https://agentaccess-mcp.region.api.aws/mcp

Il server MCP è ospitato nel AWS cloud e utilizza Streamable HTTP come protocollo di trasporto. Non è necessario installare o mantenere alcun componente del server.

Ogni richiesta deve SigV4-signed utilizzare credenziali IAM con il nome agentaccess-mcp del servizio. Il seguente esempio di Python mostra lo schema di connessione generale utilizzando: mcp-proxy-for-aws

from mcp_proxy_for_aws import aws_iam_streamablehttp_client

async with aws_iam_streamablehttp_client(
    endpoint="https://agentaccess-mcp.region.api.aws/mcp",
    aws_service="agentaccess-mcp",
    aws_region="region",
    headers={
        # Fleet-type-specific headers (see the following subsections)
    },
    metadata={
        # Fleet-type-specific metadata (see the following subsections)
    },
) as (read, write, _):
    # Use read/write streams with your MCP client
    ...

Per altri linguaggi, scrivete la vostra logica di firma SigV4 per le richieste MCP in uscita o utilizzate una libreria che supporti la firma SigV4. Per ulteriori informazioni su, consulta mcp-proxy-for-aws on. mcp-proxy-for-aws GitHub

Il modo in cui autentichi la sessione di streaming dipende dal tipo di flotta:

Connessione con flotte non aggiunte a un dominio

Per le flotte non aggiunte a un dominio, genera un URL di streaming utilizzando l'CreateStreamingURLAPI e passalo come intestazione per ogni richiesta. X-Amzn-AgentAccess-Streaming-Session-Url Non sono richiesti parametri specifici per l'agente. Il comportamento dell'agente è determinato dalla configurazione di accesso dell'agente dello stack.

import boto3
from mcp_proxy_for_aws import aws_iam_streamablehttp_client

# Generate streaming URL
appstream = boto3.client("appstream", region_name="region")
response = appstream.create_streaming_url(
    StackName="stack-name",
    FleetName="fleet-name",
    UserId="user-id",
)
streaming_url = response["StreamingURL"]

# Connect to MCP server
async with aws_iam_streamablehttp_client(
    endpoint="https://agentaccess-mcp.region.api.aws/mcp",
    aws_service="agentaccess-mcp",
    aws_region="region",
    headers={
        "X-Amzn-AgentAccess-Streaming-Session-Url": streaming_url,
    },
) as (read, write, _):
    ...

Per ulteriori informazioni sull'CreateStreamingURLAPI, consulta CreateStreamingl'URL nell'Amazon WorkSpaces Applications 2.0 API Reference.

Connessione con flotte aggiunte a un dominio

Quando gli agenti accedono a istanze di streaming aggiunte al dominio, la connessione deve essere federata tramite un provider SAML. Questo requisito si applica sia alle sessioni standard che a quelle con agenti. Le sessioni standard consentono agli utenti di inserire la password manualmente o di utilizzare l'autenticazione basata su certificati per un'esperienza di accesso senza interruzioni. Per le sessioni degli agenti, è richiesta l'autenticazione basata su certificati.

Poiché le istanze di streaming aggiunte al dominio richiedono l'accesso tramite SAML, il client MCP deve fornire un'asserzione SAML firmata anziché un URL di streaming. Le asserzioni SAML codificate superano i limiti di dimensione dell'intestazione HTTP. Per evitare ciò, usa il campo in: metadata mcp-proxy-for-aws

from mcp_proxy_for_aws import aws_iam_streamablehttp_client

# saml_response: your signed, base64-encoded SAML assertion
# stack_arn: the ARN of the AppStream stack for the AD user

async with aws_iam_streamablehttp_client(
    endpoint="https://agentaccess-mcp.region.api.aws/mcp",
    aws_service="agentaccess-mcp",
    aws_region="region",
    metadata={
        "saml_response": saml_response,
        "stack_arn": stack_arn,
    },
) as (read, write, _):
    ...

Per ulteriori informazioni sulla configurazione della federazione SAML con WorkSpaces Applications, consulta Configurazione SAML nella Amazon WorkSpaces Applications Administration Guide. Per ulteriori informazioni e un esempio di funzionamento completo, consulta il repository sample-code-for-workspaces-agent-access in Samples on. AWS GitHub

Modalità di connessione

Puoi controllare il modo in cui l'agente attende che la sessione desktop diventi disponibile impostando l'X-Amzn-AgentAccess-Connect-Modeintestazione sulle tue richieste MCP.

Sono disponibili le seguenti modalità:

Usa la modalità POLLING quando desideri che il tuo agente esegua altre operazioni in attesa della connessione al desktop o quando hai bisogno di un maggiore controllo sul comportamento di timeout della connessione.

L'esempio seguente mostra come utilizzare la modalità POLLING:

# Pass the header when creating the MCP connection
headers = {
    "X-Amzn-AgentAccess-Streaming-Session-Url": streaming_url,  # non-domain-joined fleets
    "X-Amzn-AgentAccess-Connect-Mode": "POLLING",
}

# After initialize, tools/list returns immediately with connection_status
tools = await session.list_tools()
# tools = [connection_status]

# Poll connection_status until the desktop is ready
while True:
    result = await session.call_tool("connection_status", {})
    status = json.loads(result.content[0].text)
    if status["state"] == "CONNECTED":
        break
    time.sleep(2)

# Now tools/list returns the full set (screenshot, left_click, type_text, etc.)
tools = await session.list_tools()

Pulizia della sessione

Puoi controllare se la sessione di streaming è scaduta quando l'agente termina la connessione impostando l'X-Amzn-AgentAccess-Expire-Streaming-Session-On-Deleteintestazione sulle tue richieste MCP. Sono disponibili i seguenti valori:

Strumenti disponibili

Il server MCP fornisce i seguenti strumenti per consentire agli agenti di interagire con il desktop durante una sessione di streaming. Tutti i nomi degli strumenti utilizzano il agentaccess___ prefisso.

Strumenti del mouse

Strumenti da tastiera

Strumenti dello schermo

Inoltro di strumenti MCP

L'inoltro degli strumenti MCP consente agli agenti di interagire con le applicazioni e il sistema operativo desktop tramite chiamate MCP dirette anziché utilizzare strumenti di utilizzo del computer. Quando abilitate l'inoltro degli strumenti, il server MCP inoltra gli strumenti configurati nella sessione dell'applicazione all'agente. WorkSpaces

Configurazione dell'inoltro degli strumenti

Per configurare l'inoltro degli strumenti MCP:

Autorizzazioni IAM per l'inoltro degli strumenti

L'azione IAM per richiamare gli strumenti inoltrati è. CallForwardedTool Puoi definire l'accesso a stack specifici utilizzando la StackArn chiave condition:

{
  "Action": "agentaccess-mcp:*",
  "Resource": "*",
  "Condition": {
    "ArnLike": {
      "ponte-mcp:StackArn": "arn:aws:appstream:region:account-id:stack/stack-name"
    }
  }
}

Framework compatibili

È possibile connettersi al server MCP delle WorkSpaces applicazioni da qualsiasi framework di MCP-compatible agenti che supporti la firma Streamable HTTP e SigV4. Sono stati testati i seguenti framework:

Monitoraggio

È possibile monitorare l'attività degli agenti tramite i seguenti servizi:

Nozioni di base

Per iniziare a usare il server MCP delle WorkSpaces applicazioni, consulta. Inizia a fornire agli agenti l'accesso alle applicazioni WorkSpaces