Ground-to-Cloud-Authentifizierung

Wenn MCP-Server lokal ausgeführt werden (mit uipath run), erfolgt die Authentifizierung auf zwei separaten Ebenen:

• Runtime zu Cloud: Die lokale Runtime authentifiziert sich, damit sie den MCP-Server bei der Cloud registrieren kann.
• Client zu Cloud: Externe Clients authentifizieren sich, wenn sie den mit der Cloud verbundenen MCP-Server-Endpunkt aufrufen.

Ebene 1: Runtime to Cloud (Server-Registrierung)

Der Befehl uipath run benötigt ein eigenes Token, um den MCP-Server bei der Cloud zu registrieren. Dies ist die Authentifizierung des Entwicklers, die Identität der Person, die den Server lokal ausführt.

# 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

Die Runtime verwendet dieses Token, um eine SignalR-Verbindung zur Cloud herzustellen und die Tools des Servers zu registrieren.

Ebene 2: Client zu Cloud (Server aufrufen)

Externe Clients (wie MCP-Instanz, cURL, ein IDE oder ein beliebiger HTTP-Client) authentifizieren sich bei der Cloud über eine der vier Standardmethoden, die unter MCP-Server-Authentifizierung beschrieben sind. Die URL ist die gleiche wie für jeden anderen MCP-Server:

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

Wie Anforderungen fließen

Das Bearer-Token des Clients erreicht nie die lokale Runtime. Die Cloud validiert das Token und leitet nur die MCP-Protokollnachricht über Redis weiter. Die lokale Runtime und der MCP-Serverprozess sehen das Token nicht.

Anwendbare MCP-Servertypen

Die Ground-to-Cloud-Authentifizierung gilt für MCP-Servertypen mit einer lokalen Runtime:

• Selbst gehostet: Wird immer lokal ausgeführt und verwendet immer die Ground-to-Cloud-Authentifizierung.
• Codiert und Befehl: Verwenden Sie die Ground-to-Cloud-Authentifizierung, wenn sie während der Entwicklung lokal über uipath run ausgeführt werden. Nach der Bereitstellung für Orchestrator werden sie als Cloud-Aufträge ausgeführt und es ist keine lokale Laufzeit vorhanden.

Client-Anmeldeinformationen mit lokalen Servern

Wenn Sie Client-Anmeldeinformationen mit uipath run verwenden, legen Sie die Umgebungsvariable UIPATH_FOLDER_KEY fest. Der GetFoldersForCurrentUser -Aufruf des Python-SDK unterstützt keine Client-Anmeldeinformationen. Weitere Informationen finden Sie unter Bekannte Einschränkung: GetFoldersForCurrentUser.