Types de serveur MCP

Serveurs MCP UiPath

Le serveur MCP UiPath expose les artefacts UiPath (workflows RPA, agents, workflows d'API, processus agentiques 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.

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 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.