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. In the Connection field, select an existing connection or add a new one.

   Adding a new connection opens the Integration Service dialog, where you point the connection at the same URL as the server, keep it in a shared folder, and complete its sign-in.

   Leave this field empty if the remote endpoint doesn't require OAuth-based authentication, or if it already receives credentials through the Headers field above. When a connection is attached, it supplies the Authorization header for every call, and any Authorization header configured in Headers is ignored.

   For details on how connections work, and how to configure a connection for an individual user instead of the whole server, check About MCP Connections.

   Remarque :

   To remove a default connection later, edit the server, clear the Connection field, and save.

9. Sélectionnez Ajouter.

Result: The MCP Server is created and displayed on the MCP Servers page.