Authentification de l’ancrage dans le cloud

Lorsque les serveurs MCP s'exécutent localement (à l'aide de uipath run), l'authentification se produit à deux couches distinctes:

• Runtime vers le cloud: le runtime local s’authentifie afin de pouvoir enregistrer le serveur MCP auprès du cloud.
• Client vers le cloud: les clients externes s’authentifient lorsqu’ils appellent le point de terminaison du serveur MCP orienté vers le cloud.

Couche 1: runtime vers cloud (enregistrement du serveur)

La commande uipath run a besoin de son propre jeton pour enregistrer le serveur MCP auprès du Cloud. Il s'agit de l'authentification du développeur, de l'identité de la personne exécutant le serveur localement.

# Authenticate the runtime — interactive login
uipath auth

# Or authenticate the runtime — client credentials
uipath auth --client-id "..." \
  --client-secret "..." \
  --base-url "https://cloud.uipath.com/{org}/{tenant}" \
  --scope "OR.Default"

# Start the local server
uipath run mcp-server

Le runtime utilise ce jeton pour établir une connexion SignalR au cloud et enregistrer les outils du serveur.

Couche 2: client vers cloud (appel du serveur)

Les clients externes (tels que Inspecteur MCP, cURL, un IDE ou tout client HTTP) s'authentifient auprès du cloud via l'une des quatre méthodes standard décrites dans Authentification du serveur MCP. L’URL est la même que pour tout autre serveur MCP:

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

Flux des demandes

Le jeton du porteur du client n'atteint jamais le runtime local. Le Cloud valide le jeton et transmet uniquement le message du protocole MCP via Redis. Le runtime local et le processus du serveur MCP ne voient pas le jeton.

Types de serveur MCP applicables

L’authentification « Ground-to-Cloud » s’applique aux types de serveur MCP qui ont un runtime local:

• Auto-hébergé: s’exécute toujours localement, utilise toujours l’authentification du terrain au cloud.
• Codé et commande: utilisez l’authentification du terrain vers le cloud lors de l’exécution locale via uipath run lors du développement. Une fois déployés dans Orchestrator, ils s'exécutent sous forme de tâches cloud et aucun runtime local n'est impliqué.

Informations d’identification du client avec serveurs locaux

Lorsque vous utilisez les informations d'identification du client avec uipath run, définissez la variable d'environnement UIPATH_FOLDER_KEY . L’appel GetFoldersForCurrentUser du SDK Python ne prend pas en charge les informations d’identification du client. Pour plus de détails, consultez la section Limitation connue: GetFoldersForCurrentUser.