Authentification du serveur MCP

Les serveurs MCP UiPath nécessitent une authentification pour chaque requête HTTP. Il n’y a pas d’authentification basée sur la session. Même après l’établissement d’une session MCP, chaque requête ultérieure doit inclure un en-tête Authorization: Bearer <token> valide.

L'en-tête mcp-session-id est uniquement destiné à la gestion de l'état du protocole MCP. Il ne s'agit pas d'un mécanisme d'authentification.

Méthodes d'authentification SQL

Il existe quatre façons d’obtenir un jeton pour accéder à un serveur MCP UiPath:

Method	Source du jeton	Étendues et autorisations requises
Flux OAuth MCP	Automatique, géré par l’IDE	Géré par le flux de découverte
Personal access token (PAT)	IU UiPath Cloud	Sélectionnez OR.Jobs et OR.Execution dans la ressource Accès à l'API Orchestrator .
Application externe	Admin > Apps	Configurez OR.Execution et OR.Jobs dans l'application. Au moment de la demande de jeton, incluez OR.Default pour contrôler le comportement de routage.
Connexion interactive	uipath auth Commande CLI	Accordé automatiquement lors de la connexion

Quand utiliser chaque méthode

La méthode appropriée dépend de la présence d'un humain au moment de la connexion et de l'exposition des connecteurs Integration Service par le serveur MCP.

Scénario	Méthode recommandée	Remarques
Utilisation d'un IDE (VS Code, GitHub Copilot)	Flux OAuth MCP	L'IDE gère automatiquement la découverte, la connexion et l'actualisation du jeton. Rien à configurer au-delà de l’URL du serveur MCP.
Charges de travail automatisées ou sans assistance ( pipelines CI/CD, comptes de service, microservices, processus de longue durée)	Application externe – Étendues des applications	La seule méthode qui fonctionne sans interaction de l’utilisateur. Requêtes OR.Default pour la configuration la plus simple.
Connexion à partir d'une application tierce (Copilot Studio, ChatGPT)	Application externe – Étendues des utilisateurs	Créez une application confidentielle avec des étendues d’utilisateur, configurez manuellement les paramètres OAuth de l’application tierce et demandez à l’utilisateur de se connecter via l’application.
Créer un client MCP de bureau ou mobile	Application externe: application non confidentielle avec PKCE	Aucune clé secrète du client ne peut fuiter et PKCE protège le flux de code d’autorisation. L'utilisateur se connecte via un navigateur et l'application reçoit un jeton en son nom.
Développer ou tester localement (présence humaine)	Connexion interactive ou jeton d’accès personnel	La connexion interactive nécessite une seule commande et hérite des autorisations de votre dossier; les jetons durent une heure. Les PAT ont une expiration configurable ne dépassant pas un an et fonctionnent avec n’importe quel client HTTP.
Le serveur MCP utilise les activités Integration Service	Flux MCP OAuth, Connexion interactive ou Application externe - Étendues des utilisateurs	Les activités d'Integration Service nécessitent le contexte de l'utilisateur. Les PAT et les informations d’identification du client se connectent au serveur MCP, mais les appels d’outils basés sur Integration Service expirent.

Exigences communes

Les exigences suivantes s'appliquent, quelle que soit la méthode d'authentification choisie.

Chaque requête doit être authentifiée

Il n’y a pas de report de session. Chaque requête HTTP doit inclure un en-tête Authorization: Bearer <token> valide. L'en-tête mcp-session-id concerne uniquement l'état du protocole MCP.

Format d’URL

L’URL du point de terminaison du serveur MCP a toujours le format suivant:

https://cloud.uipath.com/{org}/{tenant}/agenthub_/mcp/{folderKey}/{slug}

Où :

• {org}: le nom de votre organisation UiPath
• {tenant}: votre nom de locataire
• {folderKey}: le GUID du dossier (pas le nom du dossier ni le chemin)
• {slug}: le champ de données dynamique de l'URL du serveur MCP

Autorisation de dossier minimale

L'identité authentifiée (utilisateur ou application externe) doit disposer de l'autorisation MCPServers.View dans le dossier contenant le serveur MCP. Cette autorisation est incluse dans les rôles Automation User, Automation Developer et Folder Administrator .

Autorisation supplémentaire pour les CodedServers et les CommandServers

Les serveurs MCP Codés et de Commande exécutent les tâches Orchestrator. L’identité doit également disposer de l’autorisation Jobs.Create . Cette autorisation est incluse dans les rôles Automation User et Automation Developer .

Limitation d'Integration Service

Si le serveur MCP expose des outils soutenus par les activités Integration Service, seule l’authentification en contexte utilisateur fonctionne (connexion interactive ou flux OAuth MCP). Les PAT et les informations d’identification du client de l’application externe se connectent au serveur MCP, mais les appels d’outils basés sur Integration Service expirent.

Validation du jeton

Les serveurs MCP UiPath valident les jetons à l'aide des schémas suivants, en séquence. La première correspondance gagne:

Schéma	Audience	Utilisé par
Jeton d’accès au Robot	Orchestrator	Jetons d’exécution du Robot
Jeton d’accès OAuth d’identité	OrchestratorApiUserAccess	Connexion interactive
Jeton d’accès personnel de l’identité	UiPath.Orchestrator	Jetons d’accès personnels, jetons d’application externe, jetons de flux MCP OAuth

Tous les schémas appliquent la validation de la signature, la validation de l'émetteur, la validation de l'audience, la validation de l'expiration et la correspondance de l'ID de partition (revendication prt_id ) par rapport à l'organisation à partir de l'URL de la demande.