Authentifizierung mit einem persönlichen Zugriffstoken

Persönliche Zugriffstoken (PATs) sind benutzerbezogene Token mit einer konfigurierbaren Lebensdauer (bis zu einem Jahr). Sie sind nützlich, wenn Sie ein langlebigeres Token benötigen, das die interaktive Anmeldung bietet, oder wenn Sie uipath auth nicht interaktiv ausführen können, sich aber dennoch als Benutzer authentifizieren müssen.

Wenn Sie ein PAT erstellen, müssen Sie Berechtigungen aus der Orchestrator API-Zugriffsressource auswählen, die die benötigten MCP-Vorgänge abdecken.

Voraussetzungen

• Sie haben die Rolle Automation User, Automation Developer oder Folder Administrator in dem Ordner, der den MCP-Server enthält. Diese Rollen enthalten die Berechtigung MCPServers.View .

Generieren Sie ein persönliches Zugriffstoken

1. Wechseln Sie zu UiPath, wählen Sie Ihr Benutzersymbol und dann Einstellungen aus.

2. Navigieren Sie zu Persönliches Zugriffstoken und wählen Sie Neues Token generieren aus.

3. Geben Sie einen Namen und ein Ablaufdatum ein.

4. Wählen Sie unter Scopes die folgenden Berechtigungen aus der Orchestrator-API- Zugriffsressource aus:

   • OR.Execution: Erforderlich zum Auflisten von Tools. MCP-Server ruft die Orchestrator ListReleases -API auf, um Prozessmetadaten aufzulösen, und dieser Endpunkt erfordert diesen Scope.
   • OR.Jobs: Erforderlich zum Ausführen von Tools. Alle MCP-Servertypen, die Prozesse als Tools ausführen (UiPath, Coded und Command), rufen die Orchestrator StartJobs -API auf, die diesen Scope erfordert.

5. Wählen Sie Speichern aus und kopieren Sie das Token sofort.

   Wichtig:

   Das Token wird nur einmal angezeigt. Wenn Sie es jetzt nicht kopieren, müssen Sie ein neues Token generieren.

Ergebnis

Das Token ist jetzt für die Verwendung im Authorization -Header von HTTP-Anforderungen an den MCP-Server verfügbar.

Verwenden Sie das persönliche Zugriffstoken

So rufen Sie einen MCP-Server mit dem Token auf:

curl -X POST "https://cloud.uipath.com/{org}/{tenant}/agenthub_/mcp/{folderKey}/{slug}" \
  -H "Authorization: Bearer <your-PAT>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{...},"id":1}'

Tokeneigenschaften

• Undurchsichtiges Token mit Zielgruppe UiPath.Orchestrator.
• Konfigurierbares Ablaufdatum (bis zu einem Jahr).
• Der Zugriff ist die Schnittstelle zwischen den PAT-Scopes und den Rollenberechtigungen auf Ordnerebene des Benutzers.
• Funktioniert mit jedem HTTP-Client (cURL, Postman, MCP-Instanz, benutzerdefinierter Code).

Einschränkungen

• PATs sind an eine bestimmte Benutzeridentität gebunden. Wenn der Benutzer deaktiviert ist, funktioniert das PAT nicht mehr.
• PATs können nur von Benutzern erstellt werden, die über interaktiven Zugriff auf UiPath verfügen.
• Integration Service-Aktivitäten unterstützen keine PAT-Authentifizierung. Die MCP-Verbindung ist erfolgreich, aber Toolaufrufe, die auf Integration Service-Verbindungen basieren, schlagen fehl.