Types de serveur MCP

Serveurs MCP UiPath

Le serveur MCP UiPath expose les artefacts UiPath (workflows RPA, agents, workflows d'API, processus Maestro BPMN et activités Integration Service) en tant qu'outils MCP. Utilisez-le lorsque la logique d'automatisation existe déjà dans UiPath et doit être mise à la disposition des modèles d'IA.

Ce type de serveur est créé et géré directement au sein de la plateforme UiPath, ce qui permet une intégration native, un déploiement simplifié et une gouvernance centralisée par le biais d'Orchestrator.

Mode de fonctionnement

La configuration se produit entièrement dans Orchestrator, dans l'onglet Serveurs MCP à l'échelle du dossier. Les utilisateurs sélectionnent les artefacts à exposer en tant qu’outils et enregistrent le serveur. Aucun packaging, aucun code ou processus externe n’est requis.

Une fois configuré, le serveur est accessible via l’URL de serveur MCP UiPath standard. Pour le format de l'URL, vérifiez Obtention de l'URL du serveur MCP.

Authentification

Les serveurs MCP UiPath utilisent le modèle d’authentification de serveur MCP standard. Pour plus de détails sur les méthodes prises en charge et les autorisations requises, consultez la section Authentification du serveur MCP.

Une contrainte supplémentaire s'applique: les outils soutenus par les activités Integration Service nécessitent des jetons de contexte utilisateur. Ces outils fonctionnent avec la connexion interactive ou le flux OAuth MCP, mais non avec les jetons d'accès personnels ou les informations d'identification du client d'application externe.

Configuration

Pour obtenir des instructions détaillées, consultez la section Création de serveurs MCP UiPath.

Serveurs MCP distants

Le serveur MCP distant permet à UiPath de se connecter aux serveurs MCP hébergés en dehors de la plateforme UiPath. Orchestrator agit comme un proxy, transmettant les requêtes MCP vers une URL externe que vous fournissez.

Le serveur MCP distant couvre deux scénarios:

• Services tiers gérés en externe: par exemple, Atlassian MCP ou Stripe MCP, accessibles via l’Internet public.
• Serveurs MCP sur site accessibles depuis UiPath Cloud sans ouvrir de ports entrants. En cochant l'option Se connecter via le relais , le relais UiPath établit un tunnel sortant de longue durée depuis votre réseau vers le cloud UiPath, et le serveur MCP distant est configuré par rapport à l'URL du relais. Aucun VPN, une exposition publique ou une connectivité entrante n’est requise.

Dans les deux scénarios, le point de terminaison distant doit parler HTTP Streamable.

Mode de fonctionnement

La configuration se fait dans Orchestrator en fournissant l'URL distante et un ensemble facultatif d'en-têtes HTTP personnalisés. Aucun package, aucun code ou processus UiPath n’est impliqué.

Lorsqu'un outil est invoqué, Orchestrator transmet l'appel à l'URL distante avec tous les en-têtes personnalisés configurés. Les en-têtes spécifiques à UiPath, y compris le jeton du porteur, ne sont pas transférés vers le serveur distant, de sorte que votre identité UiPath ne l'atteint jamais. Les en-têtes personnalisés avec des valeurs contenant des termes tels que secret, api_key ou token sont masqués dans l'interface utilisateur après l'enregistrement.

Les valeurs d’en-tête personnalisées peuvent référencer les ressources Orchestrator à l’aide de la syntaxe %ASSETS/AssetName% . Les serveurs MCP distants résolvent ces références via l'API de ressource Orchestrator avant de transférer la requête, sans nécessiter de robot ou de clé de robot. Pour plus de détails, consultez Utilisation des ressources Orchestrator dans les serveurs MCP.

Authentification

Les serveurs MCP distants utilisent le modèle d’authentification de serveur MCP standard. Les quatre méthodes d'authentification prises en charge fonctionnent avec ce type. Pour plus de détails, consultez la section Authentification du serveur MCP.

Configuration

Pour obtenir des instructions détaillées, consultez la section Créer un serveur MCP distant.

Serveurs MCP de la plateforme

Remarque :

Cette fonctionnalité est en aperçu.

Le serveur MCP de la plate-forme expose un service UiPath propriétaire sous la forme d’un ensemble sélectionné d’outils MCP. Au lieu d'exposer chaque opération proposée par l'API du service, vous choisissez celles qui deviennent des outils, et ce choix est enregistré auprès du serveur. Utilisez-la lorsqu'un modèle doit accéder directement à un service UiPath et qu'un administrateur doit décider exactement quelles opérations sont dans l'étendue.

Les services suivants sont disponibles:

• Test Manager: le cycle de vie des tests dans un projet, y compris les exigences, les cas de test et leurs étapes, les ensembles de test, les exécutions et les journaux d'exécution. Il se présente sous la forme de trois entrées: Test Manager, Test Manager External et Test Manager Performance Testing, la dernière couvrant les scénarios de performances, les groupes de charge et les rapports d’exécution.
• Contrôle de la gestion des cas: accès en lecture seule à une instance de cas unique, y compris ses variables, son dernier état d'exécution, son plan de cas et les règles sous lesquelles elle s'exécute.
• Docs AI: recherchez la documentation du produit UiPath. Un outil renvoie une réponse générée par l'IA avec des citations, un autre renvoie les segments de document correspondants et un troisième soumet des commentaires sur une réponse précédente.

Mode de fonctionnement

La configuration se produit dans Orchestrator: choisissez le service, puis choisissez ses opérations. La liste est regroupée par catégorie, de sorte que les opérations connexes apparaissent ensemble. Pour exposer toutes les opérations proposées par le service, y compris celles ajoutées ultérieurement, activez Tous les outils à la place. Aucun package, aucun code ou processus n’est impliqué.

La requête que UiPath envoie au service a un délai d'expiration de 30 secondes et l'appel d'outil est tenu ouvert jusqu'à ce qu'il soit renvoyé. Les appels apparaissent dans l'onglet Exécutions sur le serveur, et le contexte du traçage est transmis au service.

Authentification

Les serveurs MCP de la plateforme utilisent le modèle d’authentification de serveur MCP standard. Pour plus de détails, consultez la section Authentification du serveur MCP.

Configuration

Pour obtenir des instructions détaillées, consultez la section Création de serveurs MCP de la plate-forme.

Serveurs Swagger MCP

Remarque :

Cette fonctionnalité est en aperçu.

Le serveur Swagger MCP 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. Utilisez-le pour une API qui n'est pas un service propriétaire UiPath et qui ne dispose pas d'un serveur MCP propre.

Contrairement à un serveur MCP distant, qui proxys à quelque chose qui parler déjà MCP, un serveur Swagger MCP fournit la couche MCP pour une API qui ne le fait pas. Contrairement à un serveur MCP de plate-forme, qui démarre à partir d’une liste fixe de services UiPath, un serveur MCP Swagger démarre à partir de n’importe quel document OpenAPI que vous fournissez.

Mode de fonctionnement

La configuration se produit dans Orchestrator en fournissant l'URL du document ou en collant le document lui-même. Ajoutez ce que l'API attend d'en-tête, en utilisant la même syntaxe %ASSETS/AssetName% que les autres types de serveur pour garder les secrets en dehors de la configuration. Pour une API sur un réseau privé, connectez-vous via Relay.

Sur une connexion standard, la requête que UiPath envoie à l'API a un délai d'expiration de 30 secondes et une limite de réponse de 1 Mio.

Authentification

Les serveurs MCP Swagger utilisent le modèle d’authentification de serveur MCP standard. Pour plus de détails, consultez la section Authentification du serveur MCP.

Configuration

Pour obtenir des instructions étape par étape, consultez Création de serveurs MCP Swagger.

Serveurs MCP de commande

La commande serveur MCP permet à UiPath d'intégrer un serveur MCP existant depuis un flux de package externe, tel que NPM (npx) ou PyPI (uvx), à l'aide d'une commande prise en charge par la plateforme. Utilisez-le pour exécuter des serveurs MCP préexistants ou tiers sans les reempaqueter en tant qu’artefacts UiPath.

Mode de fonctionnement

Les serveurs MCP de type s’exécutent sur UiPath Serverless et prennent en charge à la fois les serveurs MCP Python et JavaScript/Node.js. Chaque serveur maintient une session par tâche, avec une durée de tâche maximale de 15 minutes.

La configuration se produit dans Orchestrator en fournissant la commande et ses arguments. Aucune définition de package, de code ou de processus UiPath n’est requise. La configuration est stockée sous la forme d'une entrée dans un fichier mcp.json . Par exemple:

{
  "servers": {
    "filesystem-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
    }
  }
}

Un serveur MCP de commande partage le même format de runtime et de configuration que les serveurs MCP codés et auto-hébergés. Pour plus de détails, consultez la section Base partagée du serveur MCP.

Variables d'environnement et secrets

Les variables d'environnement sont configurées directement sur le serveur MCP dans Orchestrator et sont stockées de manière chiffrée. Les ressources Orchestrator peuvent être référencées pour la gestion des secrets à l’aide de la syntaxe %ASSETS/AssetName% . Pour plus de détails, consultez Utilisation des ressources Orchestrator dans les serveurs MCP.

Authentification

Les serveurs MCP de type utilisent le modèle d’authentification de serveur MCP standard. Chaque appel d'outil démarre une tâche sans serveur, de sorte que les appelants ont besoin des autorisations MCPServers.View et Jobs.Create . Pour plus de détails, consultez la section Authentification du serveur MCP.

Configuration

Pour obtenir des instructions étape par étape, consultez Création de serveurs MCP de type commande.

Serveurs MCP codés

Un serveur MCP codé est un serveur MCP Python écrit à l'aide de l' infrastructure FastMCP à partir du package Python mcp , puis packagé et publié dans Orchestrator en tant qu'artefact UiPath NuGet (.nupkg). La bibliothèque uipath-mcp fournit la couche de runtime qui intègre le serveur à la plateforme UiPath.

Utilisez ce type lorsqu'un serveur MCP personnalisé doit être créé et hébergé sur UiPath, avec le code stocké, versionné et distribué via le système de gestion des packages UiPath.

Mode de fonctionnement

Les serveurs MCP codés s’exécutent sur UiPath Serverless. Chaque serveur maintient une session par tâche, avec une durée de tâche maximale de 15 minutes. Les appels d’outils actifs sont soumis à un délai d’expiration de connexion d’environ 3,5 minutes, et les sessions inactives sont terminées après environ 6 à 7 minutes d’inactivité.

Pour déployer un serveur MCP codé, le code serveur est compressé et publié dans Orchestrator à l'aide de la CLI uipath-mcp , puis le serveur MCP codé est configuré dans Orchestrator dans le même dossier où le package est déployé. Le serveur est référencé par une entrée mcp.json :

{
  "servers": {
    "math-server": {
      "type": "stdio",
      "command": "python",
      "args": ["server.py"]
    }
  }
}

Comme un serveur MCP de type Commande, un serveur codé est défini par une entrée mcp.json . La différence est qu'un serveur codé exécute le code d'un artefact UiPath NuGet publié dans Orchestrator, au lieu d'extraire un package à partir d'un flux externe.

Un serveur MCP codé partage le même runtime, le même format de configuration et le même transport que les serveurs MCP de type Commande et Auto-hébergés. Pour plus de détails, consultez la section Base partagée du serveur MCP.

Variables d'environnement et secrets

Pour les serveurs MCP codés, les variables d'environnement ne sont pas configurées sur l'entité de serveur MCP elle-même. Au lieu de cela, elles sont définies sur le processus dans Orchestrator, dans Paramètres > Variables d'environnement, et sont stockées chiffrées. Les ressources Orchestrator peuvent être référencées pour la gestion des secrets à l’aide de la syntaxe %ASSETS/AssetName% . Pour plus de détails, consultez Utilisation des ressources Orchestrator dans les serveurs MCP.

Authentification

Les serveurs MCP codés utilisent le modèle d'authentification du serveur MCP standard. Chaque appel d'outil démarre une tâche sans serveur, de sorte que les appelants ont besoin des autorisations MCPServers.View et Jobs.Create . Pour plus de détails, consultez la section Authentification du serveur MCP.

Configuration

Pour obtenir des instructions étape par étape, consultez Création de serveurs MCP codés. Pour obtenir des détails sur la mise en œuvre et un guide de démarrage, consultez le uipath-mcp démarrage rapide.

Serveurs MCP auto-hébergés

Le serveur MCP auto-hébergé s'exécute sur une infrastructure contrôlée par l'utilisateur, des machines locales, des serveurs locaux ou des environnements cloud privés, tout en se connectant à UiPath pour la gouvernance et la détectabilité. Utilisez-le lorsque le serveur MCP a besoin d'accéder à des ressources locales inaccessibles depuis l'infrastructure Cloud, ou lorsque la politique exige que le runtime fonctionne sur le matériel appartenant au client.

Mode de fonctionnement

Un serveur MCP auto-hébergé ne peut pas être configuré via l’interface utilisateur d’Orchestrator. Au lieu de cela, il s'enregistre auprès d'UiPath lorsqu'il est démarré localement. Contrairement aux serveurs MCP codés et de commande, une instance de runtime auto-hébergée prend en charge plusieurs sessions simultanées, avec une distribution aléatoire lorsque plusieurs sessions se connectent au même champ de données dynamique. Le cycle de vie du serveur est entièrement contrôlé par vous.

Un serveur MCP auto-hébergé partage le même runtime, le même format de configuration et le même transport que les serveurs MCP de type Commande et Codés. Pour plus de détails, consultez la section Base partagée du serveur MCP.

Enregistrement du serveur

Avant de démarrer le serveur, le runtime doit connaître le dossier Orchestrator sous lequel l’enregistrer. Deux chemins d'enregistrement sont pris en charge, selon la méthode d'authentification:

• Avec authentification interactive (uipath auth): UIPATH_FOLDER_PATH est défini sur le chemin du dossier. Le runtime le résout automatiquement en clé de dossier.
• Avec authentification client-informations d’identification: UIPATH_FOLDER_KEY est défini directement sur le GUID du dossier, car l'API de résolution de dossier ne prend pas en charge les informations d'identification du client.

Exemples de commandes d'enregistrement:

# Interactive auth
export UIPATH_FOLDER_PATH=<your-folder-path>
uipath run my-mcp

# Client-credential auth
export UIPATH_FOLDER_KEY=<your-folder-key>
uipath run my-mcp

Une fois enregistré, le serveur apparaît dans Orchestrator et est accessible via l’URL de point de terminaison MCP standard. Pour le format de l'URL, vérifiez Obtention de l'URL du serveur MCP.

Authentification

L’authentification fonctionne sur deux couches pour les serveurs MCP auto-hébergés:

• Le jeton uipath auth du développeur (ou les informations d'identification du client) enregistre le runtime.
• Le jeton du porteur de l'appelant authentifie chaque appel d'outil.

Le jeton de l'appelant n'atteint jamais le runtime local. UiPath le valide dans le cloud et transmet uniquement le message de protocole MCP.

Pour plus de détails sur les méthodes d’authentification prises en charge et les autorisations requises, consultez la section Authentification du serveur MCP.

Configuration

Pour obtenir des détails sur la mise en œuvre et un guide de démarrage, consultez le uipath-mcp démarrage rapide.