Inoltro di strumenti MCP

Con il tool forwarding Model Context Protocol (MCP), gli agenti possono lavorare direttamente con le applicazioni e il sistema operativo in esecuzione sul desktop. Effettuano chiamate MCP dirette invece di utilizzare strumenti informatici. Quando si attiva l'inoltro degli strumenti, il server MCP inoltra gli strumenti impostati su WorkSpaces Sessione delle applicazioni al tuo agente.

Impostazione dell'inoltro degli strumenti

Per configurare l'inoltro degli strumenti MCP:

Passaggio 1: abilitare l'inoltro degli strumenti

Attiva il FORWARD_MCP_TOOLS azione dell'agente tramite l'API o le impostazioni della console.

Fase 2: Aggiungere il file di configurazione all'immagine della flotta

WorkSpaces Applications crea ogni istanza di streaming a partire dall'immagine della flotta, quindi il file di configurazione deve far parte di quell'immagine. Aggiungilo quando crei o aggiorni l'immagine. Un file inserito in un'istanza in esecuzione non viene trasferito alle nuove sessioni. Il servizio cerca il file nella seguente posizione, che dipende dalla piattaforma:

Platform (Piattaforma)	Percorso del file di configurazione
Istanze Windows	C:\ProgramData\NICE\dcv\mcp_server_redirection_config.json
Istanze Linux	/etc/dcv/mcp_server_redirection_config.json

Fase 3: Definire i server MCP nel file di configurazione

Il file di configurazione è JSON con un singolo livello superiore mcpServers oggetto. Ogni chiave è un nome univoco che scegli per un server. Ogni valore specifica come avviare il server.

L'esempio seguente è per un'istanza di Windows:

{
    "mcpServers": {
        "filesystem": {
            "command": "C:/path/to/python.exe",
            "args": ["C:/mcpServerPath/filesystem.py", "C:/UserName/Documents"]
        },
        "weather": {
            "command": "C:/Program Files/my-mcp/weather.exe"
        }
    }
}

Campo	Richiesto	Tipo	Description
command	Sì	Stringa	Percorso assoluto dell'eseguibile da avviare.
args	No	Gamma di stringhe	Argomenti passati all'eseguibile.

Fase 4: Verifica la disponibilità dello strumento

Se il file di configurazione è presente, il servizio si connette ai server MCP che elenca e inoltra i relativi strumenti. Gli strumenti inoltrati vengono visualizzati quando l'agente elenca gli strumenti disponibili.

Fase 5: Verificare la configurazione

Per confermare che il tool forwarding funziona, esegui mcpforwardingtester sceneggiatura. Puoi trovarlo nella codice di esempio per l'accesso agli agenti degli spazi di lavoro repository su GitHub. Lo script verifica la configurazione MCP sul tuo WorkSpace. Segnala quali strumenti sono pronti e segnala eventuali problemi.

Nota

Sia l'accesso IAM che l'impostazione del servizio devono essere abilitati affinché l'inoltro degli strumenti funzioni. Le autorizzazioni IAM non sovrascrivono l'impostazione del servizio.

Considerazioni sull'inoltro degli strumenti MCP

Quando configurate l'inoltro degli strumenti MCP, tenete presente le seguenti considerazioni:

• Il trasporto è standard I/O solo (studio). Ogni voce deve avviare un processo che parli di MCP rispetto ai suoi input e output standard. Gli endpoint HTTP o SSE MCP remoti non sono supportati. Per utilizzare un endpoint remoto, inseriscilo in un server stdio locale.

• Solo command e args sono supportati. Non è disponibile alcun campo per le variabili di ambiente o la directory di lavoro. Ogni server eredita l'ambiente della sessione di streaming e viene eseguito come utente della sessione. Usa percorsi assoluti per command e per qualsiasi argomento del percorso.

• Nelle istanze di Windows, usa le barre in avanti nei percorsi. Ad esempio, usa C:/Program Files/my-mcp/server.exe. JSON considera il backslash come un carattere di escape, quindi a Windows-style il percorso scritto con barre rovesciate singole non è valido. Windows accetta barre in avanti per i percorsi assoluti, il che evita la necessità di sfuggire a ogni separatore \\.

Come vengono visualizzati gli strumenti inoltrati all'agente

Per evitare collisioni tra server, il server MCP rinomina ogni strumento inoltrato nell'elenco degli strumenti dell'agente utilizzando il seguente schema:

forwarded___server-name___original-tool-name

Il server-name è la chiave del tuo file di configurazione. Ad esempio, a get_forecast strumento del weather il server è elencato come forwarded___weather___get_forecast. Quando l'agente chiama il nome inoltrato, il server MCP indirizza la richiesta allo strumento originale sul server proprietario. Il codice dell'agente che corrisponde ai nomi degli strumenti deve prevedere questo prefisso.

Autorizzazioni IAM per l'inoltro degli strumenti

L'azione IAM per chiamare gli strumenti inoltrati è CallForwardedTool. Per limitare l'accesso a stack specifici, usa il StackArn chiave di condizione:

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