Utiliser les ressources Orchestrator dans les serveurs MCP

Les serveurs MCP ont souvent besoin de secrets (clés API, informations d’identification de la base de données, jetons de service) pour se connecter aux systèmes externes. Au lieu de coder en dur ces valeurs dans la configuration du serveur MCP, vous pouvez référencer les ressources Orchestrator à l’aide de la syntaxe %ASSETS/AssetName% . Au moment de l'exécution, le robot résout ces références et injecte les valeurs réelles des ressources sous forme de variables d'environnement.

Le mécanisme est le même pour les serveurs MCP de type Commande et Codés. Uniquement lorsque les variables d'environnement sont configurées diffère entre les deux.

Créer la ressource dans Orchestrator

Accédez à votre dossier dans Orchestrator > Ressources > Créer une ressource. Par exemple:

• Nom : MyApiKey
• Type: Secret (ou Credential pour les paires nom d'utilisateur/mot de passe)
• Valeur: sk-abc123...

La ressource doit se trouver dans le même dossier que le serveur MCP.

Référencer la ressource dans les variables d'environnement du serveur MCP

La syntaxe de référence de la ressource est identique pour tous les types de serveurs. L'emplacement des variables d'environnement diffère:

Type de serveur	Où configurer les variables d’environnement
Commande serveur MCP	Directement sur le serveur MCP, dans le champ Variables d'environnement du formulaire de création ou de modification dans Orchestrator.
Serveur MCP codé	Sur le processus dans Orchestrator: Paramètres > Variables d'environnement.

Dans les deux cas, les entrées prennent la forme KEY=VALUE, avec %ASSETS/AssetName% comme valeur:

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

Les références de ressources et les valeurs simples peuvent être mixtes. Chaque variable va sur sa propre ligne.

Lire les variables dans votre code serveur

Orchestrator stocke les variables d'environnement brutes, y compris les espaces réservés %ASSETS/...% , dans la base de données, chiffrés au repos. Lorsqu'une session démarre, Orchestrator la transmet au runtime sans serveur, ce qui résout les références de ressources à leurs valeurs réelles avant de les transmettre au processus du serveur MCP.

Dans le code du serveur MCP, les variables sont alors disponibles en tant que variables d'environnement standard. Par exemple:

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

Remarque :

Les comportements suivants s'appliquent à l'inférence de ressources dans les serveurs MCP:

• Les noms de ressource ne sont pas sensibles à la casse dans la syntaxe %ASSETS/...% .
• La clé de variable d'environnement détermine le masquage des secrets dans l'interface utilisateur. Les clés correspondant à des modèles tels que API_KEY, SECRET, PASSWORD, TOKEN ou Authorization sont automatiquement masquées par ****. La référence %ASSETS/...% est toujours visible (non masquée).
• Si une ressource n'existe pas ou si le Robot n'y a pas accès, la variable d'environnement ne sera pas résolue et le serveur recevra la chaîne %ASSETS/...% brute.