Authentifizierung mit interaktiver Anmeldung (CLI)

Die interaktive Anmeldung ist für Entwickler konzipiert, die lokal arbeiten und schnellen Zugriff auf Test-MCP-Server benötigen. Der Client in dieser Methode ist die UiPath CLI (uipath -Befehlszeilentool), die auf Ihrer Entwicklungsmaschine ausgeführt wird.

Wenn Sie uipath auth ausführen, öffnet die CLI Ihren Standardbrowser auf der UiPath Cloud-Anmeldeseite. Nach der Authentifizierung speichert die CLI das resultierende Bearer-Token in einer .env -Datei in Ihrem aktuellen Verzeichnis. Sie fügen dieses Token dann in den Authorization -Header Ihrer HTTP-Anforderungen an den MCP-Serverendpunkt ein.

Die interaktive Anmeldung ist für die folgenden Szenarien geeignet:

• Lokale Entwicklung und Tests von MCP-Servern.
• Schnelle API-Tests mit cURL, Postman oder MCP-Instanz.
• Debuggen von MCP-Tool-Aufrufen mit vollständigen Benutzerberechtigungen.
• Jedes Szenario, in dem ein menschlicher Entwickler am Terminal vorhanden ist.

Es ist nicht für unbeaufsichtigte oder automatisierte Szenarien geeignet. Verwenden Sie in diesem Fall stattdessen eine externe Anwendung . Verwenden Sie für IDE-Integrationen den MCP OAuth-Flow.

Voraussetzungen

• Die UiPath CLI ist auf Ihrer Development-Maschine installiert.
• Sie haben ein Konto mit der Rolle Automation User, Automation Developer oder Folder Administrator in dem Ordner, der den MCP-Server enthält.

Authentifizieren und rufen Sie einen MCP-Server an

1. Authentifizieren Sie sich bei UiPath:

   uipath auth
   

   Die CLI öffnet Ihren Standardbrowser. Melden Sie sich bei UiPath Cloud an, um die Authentifizierung abzuschließen. Die CLI speichert das resultierende Bearer-Token in einer .env -Datei in Ihrem aktuellen Verzeichnis als UIPATH_ACCESS_TOKEN.

2. Exportieren Sie das Token in Ihre Shell-Umgebung:

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

3. Rufen Sie einen MCP-Server mit dem exportierten Token auf:

   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}'
   

Ergebnis

Der MCP-Server überprüft das Token und antwortet auf die initialize -Anforderung. Sie können dann nachfolgende MCP-Protokollnachrichten mit demselben Authorization -Header für jede Anforderung senden.

Tokeneigenschaften

• Typ: JWT
• Zielgruppe: enthält OrchestratorApiUserAccess
• Aussteller: UiPath Identity Server ({env}.uipath.com/identity_)
• Ablauf: eine Stunde. Es gibt keine automatische Aktualisierung. Führen Sie uipath auth erneut aus, um ein neues Token zu erhalten.

Das Token gewährt:

• Zugriff auf alle Ordner, in denen der angemeldete Benutzer Rollenzuweisungen hat.
• Alle Berechtigungen, die der Benutzer in diesen Ordnern hat (von seinen Rollen geerbt).
• Kompatibilität mit Integration Service-Aktivitäten (Benutzerkontext ist vorhanden).

Anwendbare MCP-Servertypen

Diese Authentifizierungsmethode funktioniert mit allen MCP-Servertypen: UiPath, Codiert, Befehl, Selbst gehostet, Remote und Plattform.