Créer un serveur MCP distant

Créez un serveur MCP distant dans Orchestrator en spécifiant un nom, une URL et des détails de connexion.

1. Sur la page Serveurs MCP, sélectionnez Ajouter un serveur MCP. La fenêtre Ajouter un serveur MCP s’affiche.
2. En haut de la page, sélectionnez le type Distant.
3. Dans le champ Nom, nommez le serveur MCP.
   Remarque :

   Le nom est utilisé comme champ de données dynamique réel pour l’ URL d’aperçu. Pour cette raison, assurez-vous que le nom que vous fournissez respecte les critères de validation suivants :

   • Le nom doit être conforme à la règle Regex : /^[a-zA-Z0-0]+(?:[-]+[a-zA-Z0-0+)*$/.
   • La valeur doit comporter un minimum de 3 caractères et un maximum de 50 caractères.
4. Dans l’URL de prévisualisation, entrez un nom pour prévisualiser l’URL complète.

L' URL d'aperçu utilise le format suivant : https://cloud.uipath.com/<OrganizationName>/<TenantName>/agenthub_/mcp/<FolderID>/<MCPServerName>.

Assurez-vous que vous disposez des autorisations appropriées pour accéder au dossier et y créer un serveur MCP.

5. Ajoutez une Description du serveur MCP.

6. Ajoutez l’URL distante du serveur MCP déployé à distance.

7. Ajoutez les En-têtes du serveur MCP.

   Vous pouvez utiliser ce champ pour les en-têtes de requête HTTP personnalisés qu'Orchestrator envoie lorsqu'il communique avec le point de terminaison distant du serveur MCP. Ces en-têtes sont souvent utilisés pour l'authentification, comme les clés API, ou pour la configuration personnalisée que le serveur MCP attend dans ses requêtes.

   Pour éviter de coder en dur des secrets dans les en-têtes, référencez les ressources Orchestrator en utilisant la syntaxe %ASSETS/AssetName% comme valeur complète de l’en-tête. Par exemple, utilisez Authorization: %ASSETS/RemoteBearerToken% ou X-Api-Key: %ASSETS/MyApiKey%.

   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 ressources distantes sont résolues via Orchestrator à l'aide de l'identité de l'appelant et du contexte du dossier du serveur MCP. Cela fonctionne sans robot ni clé de robot. Pour plus de détails, consultez Utilisation des ressources Orchestrator dans les serveurs MCP.

   Remarque :

   • Utilisez des en-têtes uniquement si le point de terminaison de votre serveur MCP distant les attend pour une communication sécurisée. Laissez cette section vide si aucun en-tête d'authentification supplémentaire n'est requis.
   • Lorsque vous ajoutez un en-tête incluant des termes tels que secret, api_key ou token, la valeur est automatiquement masquée après l'enregistrement.

8. Dans le champ Connexion , sélectionnez une connexion existante ou ajoutez-en une nouvelle.

   L'ajout d'une nouvelle connexion ouvre la boîte de dialogue Integration Service, dans laquelle vous allez pointer la connexion vers la même URL que le serveur, la conserver dans un dossier partagé et finaliser sa connexion.

   Laissez ce champ vide si le point de terminaison distant ne nécessite pas d'authentification basée sur OAuth, ou s'il reçoit déjà des informations d'identification via le champ En-têtes ci-dessus. Lorsqu'une connexion est attachée, elle fournit l'en-tête Authorization pour chaque appel, et tout en-tête Authorization configuré dans En-têtes est ignoré.

   Pour plus de détails sur le fonctionnement des connexions et sur la façon de configurer une connexion pour un utilisateur individuel plutôt que pour l'ensemble du serveur, consultez À propos des connexions MCP.

   Remarque :

   Pour supprimer ultérieurement une connexion par défaut, modifiez le serveur, effacez le champ Connexion et enregistrez.

9. Sélectionnez Ajouter.

Résultat: le serveur MCP est créé et affiché sur la page Serveurs MCP .