Créer des serveurs MCP Swagger

Créez un serveur MCP Swagger dans Orchestrator en fournissant un document OpenAPI qui décrit l'API à exposer en tant qu'outils.

Remarque :

Cette fonctionnalité est en aperçu.

Un serveur MCP Swagger transforme un document OpenAPI en outils MCP. Vous fournissez le document, et chaque opération qu'il décrit devient un outil que le serveur invoque via HTTP.

Prérequis

• L'autorisation de Création au niveau du dossier pour les serveurs MCP.
• Le document OpenAPI pour l'API, soit sous forme d'URL, soit sous forme de fichier que vous pouvez coller.

Créer un serveur Swagger MCP

1. Dans Agent Gateway > Serveurs MCP, sélectionnez le menu Ajouter un serveur MCP .

2. Sous Externe, sélectionnez Swagger.

3. Saisissez un nom. Il s'agit du nom complet affiché dans la liste des serveurs.

4. Saisissez un champ de données dynamique.

   Remarque :

   Le champ de données dynamique accepte uniquement les lettres minuscules, les chiffres et les traits d’union, et doit comprendre entre 3 et 50 caractères. Il devient le dernier segment de l’URL du serveur.

5. (Facultatif) Entrez une description de 500 caractères maximum.

6. Choisissez comment fournir le document OpenAPI: sélectionnez À partir de l'URL et entrez l' URL Swagger à partir de laquelle il est servi, ou sélectionnez Coller JSON et collez le document lui-même.

   Remarque :

   L’option À partir de l’URL est l’option à privilégier, car c’est la seule qui prend en charge l’actualisation ultérieure des outils. Utilisez Coller JSON lorsque le document n'est pas servi à une adresse que UiPath peut atteindre. Le fait de basculer entre les deux options efface ce que vous avez saisi dans l'autre.

7. Sélectionnez le type de connexion: Standard pour vous connecter directement sur Internet public, ou Privé (Relay) pour acheminer le trafic via UiPath Relay pour une API à l'intérieur de votre propre réseau.

8. Ajoutez les En-têtes attendus par l'API, un par ligne, sous la forme Name:value.

   Remarque :

   La valeur résolue est envoyée à l'API en tant qu'en-tête configuré. Utilisez donc des en-têtes basés sur la ressource uniquement pour les points de terminaison dans lesquels vous avez approuvé ces secrets.

   Au lieu de coller une clé secrète, donnez à un en-tête une valeur de la forme %ASSETS/AssetName%. UiPath le résout par rapport à la ressource dans le dossier du serveur avant d’envoyer la requête, et l’appel échoue plutôt que de transférer un espace réservé non résolu si la ressource ne peut pas être lue. Le remplissage automatique répertorie uniquement les ressources qui permettent aux automatisations et à l'accès à l'API.

9. Vous pouvez également développer les garde-fous et les configurer.

10. Sélectionnez Ajouter.

Résultat: UiPath lit le document, le récupère si vous avez donné une URL, et crée un outil par opération qu'il décrit. Si le document ne peut pas être lu, le serveur n’est pas créé et l’erreur en nomme la raison. Sélectionnez Copier l'URL sur la ligne du serveur pour obtenir son adresse:

https://cloud.uipath.com/{org_name}/{tenant_name}/agenthub_/mcp/{folder_key}/{server_slug}

Les ressources Text, Secret, Bool, Integer, Credential et Windows Credential sont prises en charge pour les en-têtes basés sur les ressources; Les ressources Credential (Informations d'identification) et Windows Credential (Informations d'identification Windows) se résolvent sur la valeur du mot de passe. Les ressources clé-valeur-liste ne sont pas prises en charge, car une valeur d'en-tête doit se résoudre en une seule chaîne.

Pour récupérer ultérieurement les modifications apportées à l'API, sélectionnez Actualiser sur le serveur. Elle lit le document de son URL et reconstruit la liste des outils; les clients connectés voient la nouvelle liste la prochaine fois qu'ils en demandent une. Un serveur créé à partir d'un document collé n'a aucune URL à lire, donc le garder actuel signifie modifier le document collé.

Remarque :

Sur une connexion standard , la requête qu'UiPath envoie à l'API a un délai d'expiration de 30 secondes et une limite de réponse de 1 Mio, et l'appel d'outil est maintenu ouvert jusqu'à ce qu'il soit renvoyé. Les opérations de longue durée et les opérations qui renvoient des charges utiles volumineuses ne sont pas adaptées à ce type de serveur.

Les appels apparaissent dans l'onglet Exécutions sur le serveur.

Pour savoir comment les appelants s’authentifient et connaître les autorisations dont ils ont besoin, consultez la section Authentification du serveur MCP. Pour connaître ce type de serveur et comment il se compare aux autres, vérifiez Types de serveur MCP.