Utiliser les ressources Orchestrator dans les serveurs MCP

Les serveurs MCP ont souvent besoin de secrets, tels que des clés API, des identifiants de base de données ou des jetons de service, pour se connecter à des 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% .

Les références de ressources sont résolues différemment selon le type de serveur MCP:

• Les serveurs MCP de type commande et codés utilisent l'inférence de ressource robot/runtime. Les références de ressources sont résolues dans le cadre du runtime de la tâche sans serveur avant le démarrage du processus du serveur MCP.
• Les serveurs MCP distants utilisent l'inférence de l'API de ressource. Les références de ressources dans les en-têtes personnalisés sont résolues via Orchestrator avant que la requête ne soit transmise au point de terminaison distant, sans nécessiter de robot ou de clé de robot.

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.

Ressources de référence dans les serveurs MCP de type Commande et Codés

Les serveurs MCP de type commande et codés référencent les ressources dans les variables d'environnement. 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.

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

Référencer les ressources dans les en-têtes du serveur MCP distant

Les serveurs MCP distants ne démarrent pas de tâche de runtime UiPath, ils n'utilisent donc pas l'inférence de ressource robot/runtime. Au lieu de cela, vous pouvez référencer les ressources dans des en-têtes HTTP personnalisés. Orchestrator résout les valeurs des ressources avant de transmettre la requête au serveur MCP distant.

Utilisez %ASSETS/AssetName% comme valeur d'en-tête complète:

Authorization: %ASSETS/RemoteBearerToken%
X-Api-Key: %ASSETS/MyApiKey%
X-Region: us-east-1

Si le point de terminaison distant attend un préfixe tel que Bearer, stockez la valeur de l'en-tête complète dans la ressource. Par exemple, stockez Bearer <token> dans la ressource RemoteBearerToken , puis configurez l'en-tête comme Authorization: %ASSETS/RemoteBearerToken%.

Les références d'en-tête de ressource distante sont résolues via Orchestrator à l'aide de l'identité UiPath de l'appelant et du contexte de dossier du serveur MCP. Orchestrator applique les autorisations de ressources requises et l'éligibilité à l'accès direct à l'API. Ce chemin fonctionne sans robot ou clé de robot.

Remarque :

L'appelant doit avoir accès au dossier du serveur MCP et l'autorisation d'afficher la ressource référencée. Si la ressource est manquante, inaccessible ou non éligible à un accès direct à l’API, la requête MCP distante échoue au lieu de transférer un espace réservé non résolu.

Valeurs des ressources prises en charge

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/...% .
• Pour les serveurs MCP de type Commande et Codés, la clé variable d'environnement détermine le masquage du secret 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.
• Pour les en-têtes du serveur MCP distant, les ressources textuelles, secrètes, booléennes, entières, les informations d’identification et les informations d’identification Windows sont prises en charge. Pour les ressources liées aux informations d’identification, la valeur du mot de passe est utilisée pour la substitution.
• Configurez les en-têtes basés sur les ressources uniquement pour les points de terminaison distants approuvés, car la valeur résolue est envoyée à ce point de terminaison.

Remarque :

Les ressources de liste clé-valeur ne sont pas prises en charge pour la substitution de ressources du serveur MCP.