Authentification avec connexion interactive

La connexion interactive est conçue pour les développeurs travaillant localement qui ont besoin d’un accès rapide aux serveurs MCP de test. Le client de cette méthode est la UiPath CLI (outil de ligne de commande uipath ) exécutée sur votre machine de développement.

Lorsque vous exécutez uipath auth, la CLI ouvre votre navigateur par défaut à la page de connexion UiPath Cloud. Après vous être authentifié, la CLI enregistre le jeton de porteur obtenu dans un fichier .env de votre répertoire actuel. Vous incluez ensuite ce jeton dans l’en-tête Authorization de vos requêtes HTTP vers le point de terminaison du serveur MCP.

La connexion interactive est adaptée aux scénarios suivants:

• Développement et tests locaux de serveurs MCP.
• Tests rapides d'API avec cURL, Postman ou MCP Inspection.
• Débogage des appels d’outils MCP avec toutes les autorisations utilisateur.
• Tout scénario dans lequel un développeur humain est présent au terminal.

Il ne convient pas aux scénarios Unattended ou automatisés. Dans ce cas, utilisez plutôt une application externe . Pour les intégrations IDE, utilisez le flux MCP OAuth.

Prérequis

• La UiPath CLI est installée sur votre machine de développement.
• Vous disposez d'un compte avec le rôle Automation User, Automation Developer ou Folder Administrator dans le dossier contenant le serveur MCP.

S’authentifier et appeler un serveur MCP

1. Authentifiez-vous auprès d’UiPath:

   uipath auth
   

   La CLI ouvre votre navigateur par défaut. Connectez-vous à UiPath Cloud pour terminer l'authentification. La CLI enregistre le jeton du porteur obtenu dans un fichier .env de votre répertoire actuel sous le nom UIPATH_ACCESS_TOKEN.

2. Exportez le jeton vers votre environnement shell:

   export UIPATH_ACCESS_TOKEN=$(grep UIPATH_ACCESS_TOKEN .env | cut -d= -f2)
   

3. Appelez un serveur MCP à l'aide du jeton exporté:

   curl -X POST "https://cloud.uipath.com/{org}/{tenant}/agenthub_/mcp/{folderKey}/{slug}" \
     -H "Authorization: Bearer $UIPATH_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}},"id":1}'
   

Résultat

Le serveur MCP valide le jeton et répond à la requête initialize . Vous pouvez ensuite envoyer les messages de protocole MCP suivants avec le même en-tête Authorization pour chaque requête.

Attributs du jeton

• Type: JWT
• Audience: comprend OrchestratorApiUserAccess
• Émetteur: UiPath Identity Server ({env}.uipath.com/identity_)
• Expiration: une heure. Il n’y a pas d’actualisation automatique, réexécutez uipath auth pour obtenir un nouveau jeton.

Le jeton accorde:

• Accès à tous les dossiers dans lesquels l'utilisateur connecté dispose de rôles attribués.
• Toutes les autorisations dont dispose l’utilisateur dans ces dossiers (hérités de ses rôles).
• Compatibilité avec les activités Integration Service (le contexte de l’utilisateur est présent).

Types de serveur MCP applicables

Cette méthode d’authentification fonctionne avec tous les types de serveur MCP: UiPath, Codé, Commande, Auto-hébergé, Distant et Plate-forme.