Verwenden von Orchestrator-Assets in MCP-Servern

MCP-Server benötigen häufig Geheimnisse (API-Schlüssel, Datenbankanmeldeinformationen, Diensttoken), um eine Verbindung mit externen Systemen herzustellen. Anstatt diese Werte in die MCP-Serverkonfiguration fest einprogrammieren, können Sie mit der Syntax %ASSETS/AssetName% auf Orchestrator-Assets verweisen. Zur Runtime löst der Roboter diese Verweise auf und fügt die tatsächlichen Asset-Werte als Umgebungsvariablen ein.

Der Mechanismus ist für Befehls- und codierteMCP-Server identisch. Nur wo die Umgebungsvariablen konfiguriert sind, unterscheidet sich zwischen den beiden.

Erstellen Sie das Asset in Orchestrator

Wechseln Sie zu Ihrem Ordner unter Orchestrator > Assets > Asset erstellen. Zum Beispiel:

• Name: MyApiKey
• Typ: Geheimnis (oder Zugangsdaten für Benutzername/Kennwort-Paare)
• Wert: sk-abc123...

Das Asset muss sich im selben Ordner wie der MCP-Server befinden.

Verweisen Sie auf das Asset in den Umgebungsvariablen des MCP-Servers

Die Asset-Referenzsyntax ist für alle Servertypen identisch. Der Speicherort der Umgebungsvariablen unterscheidet sich:

Servertyp	Wo Umgebungsvariablen konfiguriert werden sollen
Befehls-MCP-Server	Direkt auf dem MCP-Server, im Feld Umgebungsvariablen des Formulars zum Erstellen oder Bearbeiten im Orchestrator.
Codierter MCP-Server	Über den Prozess im Orchestrator: Einstellungen > Umgebungsvariablen.

In beiden Fällen haben Einträge das Format KEY=VALUE mit %ASSETS/AssetName% als Wert:

API_KEY=%ASSETS/MyApiKey%
DATABASE_URL=%ASSETS/MyDatabaseUrl%
REGION=us-east-1

Asset-Referenzen und einfache Werte können gemischt werden. Jede Variable folgt einer eigenen Zeile.

Lesen Sie die Variablen in Ihrem Servercode

Orchestrator speichert die unformatierten Umgebungsvariablen, einschließlich der %ASSETS/...% -Platzhalter, in der Datenbank, im Ruhezustand verschlüsselt. Wenn eine Sitzung gestartet wird, leitet der Orchestrator sie an die serverlose Runtime weiter, die die Asset-Referenzen auf ihre tatsächlichen Werte auflöst, bevor sie an den MCP-Serverprozess übergeben werden.

Im MCP-Servercode sind die Variablen dann als Standardumgebungsvariablen verfügbar. Zum Beispiel:

import os
api_key = os.environ.get("API_KEY")  # Resolved to the asset value at runtime

Hinweis:

Das folgende Verhalten gilt für die Asset-Inferenz auf MCP-Servern:

• Bei Asset-Namen wird die Groß-/Kleinschreibung nicht berücksichtigt %ASSETS/...% .
• Der Umgebungsvariablenschlüssel bestimmt die Geheimnismaskierung auf der Benutzeroberfläche. Schlüssel, die Mustern wie API_KEY, SECRET, PASSWORD, TOKEN oder Authorization entsprechen, werden automatisch mit **** maskiert. Die %ASSETS/...% -Referenz selbst ist immer sichtbar (nicht maskiert).
• Wenn ein Asset nicht vorhanden ist oder der Roboter keinen Zugriff hat, wird die Umgebungsvariable nicht aufgelöst und der Server erhält den Rohstring %ASSETS/...% .