Weiterleitung von MCP-Tools

Mit der Model Context Protocol (MCP) -Toolweiterleitung können Agenten direkt mit den Anwendungen und dem Betriebssystem arbeiten, die auf dem Desktop ausgeführt werden. Sie tätigen direkte MCP-Aufrufe, anstatt computergestützte Tools zu verwenden. Wenn Sie die Tool-Weiterleitung aktivieren, leitet der MCP-Server die auf dem WorkSpaces Anwendungssitzung an Ihren Agenten.

Tool-Forwarding einrichten

So richten Sie die MCP-Tool-Weiterleitung ein:

Schritt 1: Tool-Weiterleitung aktivieren

Schalten Sie das ein FORWARD_MCP_TOOLS Agentenaktion über die API- oder Konsoleneinstellungen.

Schritt 2: Fügen Sie die Konfigurationsdatei zum Image der Flotte hinzu

WorkSpaces Applications erstellt jede Streaming-Instance aus dem Image der Flotte, daher muss die Konfigurationsdatei Teil dieses Images sein. Fügen Sie sie hinzu, wenn Sie das Image erstellen oder aktualisieren. Eine Datei, die auf einer laufenden Instance platziert wird, wird nicht auf neue Sitzungen übertragen. Der Service sucht an der folgenden Stelle nach der Datei, die von der Plattform abhängt:

Plattform	Pfad der Konfigurationsdatei
Windows-Instances	C:\ProgramData\NICE\dcv\mcp_server_redirection_config.json
Linux-Instances	/etc/dcv/mcp_server_redirection_config.json

Schritt 3: Definieren Sie die MCP-Server in der Konfigurationsdatei

Die Konfigurationsdatei ist JSON mit einer einzigen obersten Ebene mcpServers Objekt. Jeder Schlüssel ist ein eindeutiger Name, den Sie für einen Server wählen. Jeder Wert gibt an, wie dieser Server gestartet wird.

Das folgende Beispiel bezieht sich auf eine Windows-Instance:

{
    "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"
        }
    }
}

Feld	Erforderlich	Typ	Description
command	Ja	Zeichenfolge	Absoluter Pfad zur ausführbaren Datei, die gestartet werden soll.
args	Nein	Zeichenfolgen-Array	An die ausführbare Datei übergebene Argumente.

Schritt 4: Überprüfen Sie die Verfügbarkeit des Tools

Wenn die Konfigurationsdatei vorhanden ist, stellt der Dienst eine Verbindung zu den MCP-Servern her, die er auflistet, und leitet deren Tools weiter. Weitergeleitete Tools werden angezeigt, wenn der Agent seine verfügbaren Tools auflistet.

Schritt 5: Testen Sie die Konfiguration

Führen Sie den Befehl aus, um zu überprüfen, ob die Tool-Weiterleitung funktioniert mcpforwardingtester Skript. Sie finden es in der Beispielcode für Workspaces-Agent-Zugriff Repository auf GitHub. Das Skript testet das MCP-Setup auf Ihrem WorkSpace. Es meldet, welche Tools bereit sind, und weist auf Probleme hin.

Anmerkung

Sowohl der IAM-Zugriff als auch die Serviceeinstellung müssen aktiviert sein, damit die Tool-Weiterleitung funktioniert. IAM-Berechtigungen haben keinen Vorrang vor der Diensteinstellung.

Überlegungen zur Weiterleitung von MCP-Tools

Beachten Sie bei der Konfiguration der MCP-Tool-Weiterleitung die folgenden Überlegungen:

• Der Transport ist Standard I/O Nur (Studio). Jeder Eintrag muss einen Prozess starten, der MCP über seine Standardeingabe und -ausgabe spricht. Remote-HTTP- oder SSE-MCP-Endpunkte werden nicht unterstützt. Um einen Remote-Endpunkt zu verwenden, binden Sie ihn in einen lokalen Stdio-Server ein.

• Nur command und args werden unterstützt. Es gibt kein Feld für Umgebungsvariablen oder Arbeitsverzeichnis. Jeder Server erbt die Umgebung der Streaming-Sitzung und wird als Sitzungsbenutzer ausgeführt. Verwenden Sie absolute Pfade für command und für alle Pfadargumente.

• Verwenden Sie auf Windows-Instanzen Schrägstriche in Pfaden. Verwenden Sie zum Beispiel C:/Program Files/my-mcp/server.exe. JSON behandelt den Backslash als Escape-Zeichen, also Windows-style Ein mit einzelnen Backslashes geschriebener Pfad ist ungültig. Windows akzeptiert Schrägstriche für absolute Pfade, wodurch vermieden wird, dass jedes Trennzeichen wie folgt maskiert werden muss \\.

Wie werden weitergeleitete Tools dem Agenten angezeigt

Um Kollisionen zwischen Servern zu vermeiden, benennt der MCP-Server jedes weitergeleitete Tool in der Toolliste des Agenten nach dem folgenden Muster um:

forwarded___server-name___original-tool-name

Der server-name ist der Schlüssel aus Ihrer Konfigurationsdatei. Zum Beispiel ein get_forecast Tool aus dem weather Server ist aufgeführt als forwarded___weather___get_forecast. Wenn der Agent den weitergeleiteten Namen aufruft, leitet der MCP-Server die Anfrage an das Original-Tool auf dem besitzenden Server weiter. Agentencode, der mit den Toolnamen übereinstimmt, muss mit diesem Präfix rechnen.

IAM-Berechtigungen für die Tool-Weiterleitung

Die IAM-Aktion für den Aufruf weitergeleiteter Tools lautet CallForwardedTool. Um den Zugriff auf bestimmte Stacks einzuschränken, verwenden Sie den StackArn Bedingungsschlüssel:

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