MCP-Servertypen

UiPath MCP-Server

Der UiPath-MCP-Server stellt UiPath-Artefakte (RPA-Workflows, Agents, API-Workflows, BPMN-Prozesse von Maestro und Aktivitäten von Integration Service) als MCP-Tools bereit. Verwenden Sie sie, wenn die Automatisierungslogik bereits in UiPath vorhanden ist und für KI-Modelle verfügbar gemacht werden muss.

Dieser Servertyp wird direkt innerhalb der UiPath-Plattform erstellt und verwaltet und bietet eine native Integration, eine vereinfachte Bereitstellung und zentrale Governance über den Orchestrator.

Wie es funktioniert

Die Konfiguration erfolgt vollständig im Orchestrator auf der Registerkarte MCP-Server mit Ordner-Scope. Benutzer wählen die Artefakte aus, die als Tools verfügbar gemacht werden sollen, und speichern den Server. Es ist keine Verpackung, kein Code oder ein externer Prozess erforderlich.

Nach der Konfiguration ist der Server über die Standard-URL des UiPath MCP-Servers erreichbar. Das URL-Format finden Sie unter Abrufen der MCP-Server-URL.

Authentication

UiPath-MCP-Server verwenden das Standard-MCP-Server-Authentifizierungsmodell. Weitere Informationen zu den unterstützten Methoden und erforderlichen Berechtigungen finden Sie unter MCP-Serverauthentifizierung.

Es gilt eine zusätzliche Einschränkung: Tools, die von Integration Service-Aktivitäten unterstützt werden, erfordern Benutzerkontexttoken. Diese Tools funktionieren mit der interaktiven Anmeldung oder dem MCP-OAuth-Flow, aber nicht mit persönlichen Zugriffstoken oder Anmeldeinformationen externer Anwendungen.

Konfiguration

Schritt-für-Schritt-Anweisungen finden Sie unter Erstellen von UiPath-MCP-Servern.

Remote-MCP-Server

Mit dem Remote-MCP-Server kann UiPath eine Verbindung zu MCP-Servern herstellen, die außerhalb der UiPath-Plattform gehostet werden. Orchestrator fungiert als Proxy und leitet MCP-Anforderungen an eine externe URL weiter, die Sie angeben.

Der Remote-MCP-Server deckt zwei Szenarien ab:

• Extern verwaltete Drittanbieterdienste: z. B. Atlassian-MCP oder Stripe-MCP, das über das öffentliche Internet erreicht wird.
• Lokale MCP-Server , die von der UiPath Cloud aus erreicht werden müssen, ohne eingehende Ports zu öffnen. Wenn Sie die Option Über Relay verbinden aktivieren, richtet UiPath Relay einen langlebigen ausgehenden Tunnel von Ihrem Netzwerk zu UiPath Cloud ein, und der Remote-MCP-Server wird gegen die Relay-URL konfiguriert. Es ist kein VPN, keine öffentliche Bereitstellung oder keine eingehende Konnektivität erforderlich.

In beiden Szenarien muss der Remoteendpunkt Streamable HTTP sprechen.

Wie es funktioniert

Die Konfiguration erfolgt im Orchestrator durch Bereitstellen der Remote-URL und eines optionalen Satzes benutzerdefinierter HTTP-Header. Es ist kein UiPath-Paket, kein UiPath-Code oder kein Prozess beteiligt.

Wenn ein Tool aufgerufen wird, leitet der Orchestrator den Aufruf zusammen mit allen benutzerdefinierten Headern an die Remote-URL weiter. UiPath-spezifische Header, einschließlich des Bearer-Tokens, werden nicht an den Remoteserver weitergeleitet , sodass Ihre UiPath-Identität diesen nie erreicht. Benutzerdefinierte Header mit Werten, die Begriffe wie secret, api_key, oder token enthalten, werden nach dem Speichern in der Benutzeroberfläche maskiert.

Benutzerdefinierte Header-Werte können mit der Syntax %ASSETS/AssetName% auf Orchestrator-Assets verweisen. Remote-MCP-Server lösen diese Verweise über die Orchestrator-Asset-API auf, bevor sie die Anforderung weiterleiten, ohne dass ein Roboter oder Roboterschlüssel erforderlich ist. Weitere Informationen finden Sie unter Verwenden von Orchestrator-Assets auf MCP-Servern.

Authentication

Remote-MCP-Server verwenden das Standard-MCP-Server-Authentifizierungsmodell. Alle vier unterstützten Authentifizierungsmethoden funktionieren mit diesem Typ. Weitere Informationen finden Sie unter MCP-Serverauthentifizierung.

Konfiguration

Schritt-für-Schritt-Anweisungen finden Sie unter Erstellen eines Remote-MCP-Servers.

Platform MCP Servers

Hinweis:

This functionality is in preview.

The Platform MCP Server exposes a first-party UiPath service as a curated set of MCP tools. Instead of exposing every operation the service's API offers, you choose which ones become tools, and that choice is saved with the server. Use it when a model needs to reach a UiPath service directly, and an administrator should decide exactly which operations are in scope.

The following services are available:

• Test Manager: the test lifecycle inside a project, including requirements, test cases and their steps, test sets, executions, and execution logs. It appears as three entries: Test Manager, Test Manager External, and Test Manager Performance Testing, the last covering performance scenarios, load groups, and execution reports.
• Case Management Control: read-only access to a single case instance, including its variables, latest execution state, case plan, and the rules it runs under.
• Docs AI: search over UiPath product documentation. One tool returns an AI-generated answer with citations, another returns the matching document chunks, and a third submits feedback on a previous answer.

Wie es funktioniert

Configuration happens in Orchestrator: choose the service, then choose its operations. The list is grouped by category, so related operations appear together. To expose every operation the service offers, including ones added later, enable All tools instead. No package, code, or process is involved.

The request UiPath makes to the service has a 30-second timeout, and the tool call is held open until it returns. Calls appear in the Runs tab on the server, and the trace context carries through to the service.

Authentication

Platform MCP Servers use the standard MCP Server authentication model. For details, check MCP Server authentication.

Konfiguration

For step-by-step instructions, check Creating Platform MCP Servers.

Swagger MCP Servers

Hinweis:

This functionality is in preview.

The Swagger MCP Server turns an OpenAPI document into MCP tools. You supply the document, and each operation it describes becomes a tool that the server invokes over HTTP. Use it for an API that isn't a UiPath first-party service and has no MCP server of its own.

Unlike a Remote MCP Server, which proxies to something that already speaks MCP, a Swagger MCP Server provides the MCP layer for an API that doesn't. Unlike a Platform MCP Server, which starts from a fixed list of UiPath services, a Swagger MCP Server starts from any OpenAPI document you supply.

Wie es funktioniert

Configuration happens in Orchestrator by providing the document's URL, or by pasting the document itself. Add whatever HTTP headers the API expects, using the same %ASSETS/AssetName% syntax as other server types to keep secrets out of the configuration. For an API on a private network, connect through Relay.

On a Standard connection, the request UiPath makes to the API has a 30-second timeout and a 1 MiB response limit.

Authentication

Swagger MCP Servers use the standard MCP Server authentication model. For details, check MCP Server authentication.

Konfiguration

For step-by-step instructions, check Creating Swagger MCP Servers.

Command-MCP-Server

Mit dem Befehls-MCP-Server kann UiPath einen vorhandenen MCP-Server aus einem externen Paketfeed wie NPM (npx) oder PyPI (uvx) mithilfe eines von der Plattform unterstützten Befehls integrieren. Verwenden Sie sie, um bereits vorhandene MCP-Server oder Drittanbieter-MCP-Server auszuführen, ohne sie als UiPath-Artefakte neu zu packen.

Wie es funktioniert

Befehls-MCP-Server werden auf UiPath Serverless ausgeführt und unterstützen sowohl Python- als auch JavaScript/Node.js-MCP-Server. Jeder Server unterhält eine Sitzung pro Auftrag mit einer maximalen Auftragsdauer von 15 Minuten.

Die Konfiguration erfolgt im Orchestrator durch Angabe des Befehls und seiner Argumente. Es ist keine UiPath-Paket-, Code- oder Prozessdefinition erforderlich. Die Konfiguration wird als Eintrag in einer mcp.json -Datei gespeichert. Zum Beispiel:

{
  "servers": {
    "filesystem-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
    }
  }
}

Ein Befehls-MCP-Server hat dasselbe Runtime- und Konfigurationsformat wie codierte und selbst gehostete MCP-Server. Weitere Informationen finden Sie unter Freigegebene Grundlage von MCP-Server.

Umgebungsvariablen und Geheimnisse

Umgebungsvariablen werden direkt auf dem MCP-Server in Orchestrator konfiguriert und verschlüsselt gespeichert. Auf Orchestrator-Assets kann für die Verwaltung von geheimen Schlüsseln mithilfe der Syntax %ASSETS/AssetName% verwiesen werden. Weitere Informationen finden Sie unter Verwenden von Orchestrator-Assets auf MCP-Servern.

Authentication

Befehls-MCP-Server verwenden das Standard-MCP-Server-Authentifizierungsmodell. Jeder Toolaufruf startet einen serverlosen Auftrag, sodass Aufrufer sowohl die Berechtigung MCPServers.View als auch die Berechtigung Jobs.Create benötigen. Weitere Informationen finden Sie unter MCP-Serverauthentifizierung.

Konfiguration

Schritt-für-Schritt-Anweisungen finden Sie unter Erstellen von MCP-Servern für Befehle.

Codierte-MCP-Server

Ein codierter MCP-Server ist ein Python-MCP-Server, der mit dem FastMCP-Framework aus dem mcp -Python-Paket geschrieben wurde, dann verpackt und im Orchestrator als UiPath NuGet-Artefakt (.nupkg) veröffentlicht. Die Bibliothek uipath-mcp bietet die Runtime-Ebene, die den Server in die UiPath Platform integriert.

Verwenden Sie diesen Typ, wenn ein benutzerdefinierter MCP-Server auf UiPath erstellt und gehostet werden muss, wobei Code über das UiPath-Paketverwaltungssystem gespeichert, versioniert und verteilt werden muss.

Wie es funktioniert

Codierte MCP-Server werden auf UiPath Serverless ausgeführt. Jeder Server unterhält eine Sitzung pro Auftrag mit einer maximalen Auftragsdauer von 15 Minuten. Aktive Toolaufrufe unterliegen einem Verbindungs-Timeout von etwa 3,5 Minuten und inaktive Sitzungen werden nach etwa 6–7 Minuten Inaktivität beendet.

Zum Bereitstellen eines codierten MCP-Servers wird der Servercode mithilfe der uipath-mcp für den Orchestrator gepackt und veröffentlicht. Dann wird der codierte MCP-Server im Orchestrator im selben Ordner konfiguriert, in dem das Paket bereitgestellt wird. Auf den Server wird durch einen mcp.json -Eintrag verwiesen:

{
  "servers": {
    "math-server": {
      "type": "stdio",
      "command": "python",
      "args": ["server.py"]
    }
  }
}

Wie ein Befehls-MCP-Server wird ein codierter Server durch einen mcp.json -Eintrag definiert. Der Unterschied besteht darin, dass ein codierter Server Code von einem UiPath NuGet-Artefakt ausführt, das im Orchestrator veröffentlicht wurde, anstatt ein Paket aus einem externen Feed abzurufen.

Ein codierter MCP-Server hat die gleiche Laufzeit, das Konfigurationsformat und den gleichen Transport wie Befehls- und selbst gehostete MCP-Server. Weitere Informationen finden Sie unter Freigegebene Grundlage von MCP-Server.

Umgebungsvariablen und Geheimnisse

Für codierte MCP-Server werden Umgebungsvariablen nicht auf der MCP-Server-Entität selbst konfiguriert. Stattdessen werden sie für den Prozess im Orchestrator unter Einstellungen > Umgebungsvariablen festgelegt und verschlüsselt gespeichert. Auf Orchestrator-Assets kann für die Verwaltung von geheimen Schlüsseln mithilfe der Syntax %ASSETS/AssetName% verwiesen werden. Weitere Informationen finden Sie unter Verwenden von Orchestrator-Assets auf MCP-Servern.

Authentication

Codierte MCP-Server verwenden das Standard-MCP Server-Authentifizierungsmodell. Jeder Toolaufruf startet einen serverlosen Auftrag, sodass Aufrufer sowohl die Berechtigung MCPServers.View als auch die Berechtigung Jobs.Create benötigen. Weitere Informationen finden Sie unter MCP-Serverauthentifizierung.

Konfiguration

Schritt-für-Schritt-Anweisungen finden Sie unter Erstellen codierter MCP-Server. Implementierungsdetails und einen Leitfaden für die ersten Schritte finden Sie im uipath-mcp Quick Start.

Selbst gehostete MCP-Server

Der selbst gehostete MCP-Server wird in einer Infrastruktur ausgeführt, die vom Benutzer, lokalen Maschinen, lokalen Servern oder privaten Cloud-Umgebungen gesteuert wird, während er mit UiPath für Governance und Auffindbarkeit verbunden ist. Verwenden Sie sie, wenn der MCP-Server auf lokale Ressourcen zugreifen muss, die über die Cloud-Infrastruktur nicht erreichbar sind, oder wenn eine Richtlinie erfordert, dass die Runtime auf kundeneigener Hardware läuft.

Wie es funktioniert

Ein selbst gehosteter MCP-Server kann nicht über die Orchestrator-Benutzeroberfläche konfiguriert werden. Stattdessen registriert es sich bei UiPath, wenn es lokal gestartet wird. Im Gegensatz zu codierten und Befehls-MCP-Servern unterstützt eine selbst gehostete Runtime-Instanz mehrere gleichzeitige Sitzungen mit zufälliger Verteilung, wenn mehrere Sitzungen eine Verbindung mit derselben Slug herstellen. Der Serverlebenszyklus wird vollständig von Ihnen gesteuert.

Ein selbst gehosteter MCP-Server hat die gleiche Laufzeit, das Konfigurationsformat und den gleichen Transport wie Befehls- und codierte MCP-Server. Weitere Informationen finden Sie unter Freigegebene Grundlage von MCP-Server.

Registrieren des Servers

Bevor der Server gestartet wird, muss die Runtime wissen, unter welchem Orchestrator-Ordner sie registriert werden soll. Je nach Authentifizierungsmethode werden zwei Registrierungspfade unterstützt:

• Mit interaktiver Authentifizierung (uipath auth): UIPATH_FOLDER_PATH wird auf den Ordnerpfad festgelegt. Die Runtime löst es automatisch in einen Ordnerschlüssel auf.
• Bei der Authentifizierung mit Client-Anmeldeinformationen: UIPATH_FOLDER_KEY wird direkt auf die Ordner-GUID festgelegt, da die API für die Ordnerauflösung keine Client-Anmeldeinformationen unterstützt.

Beispiele für Registrierungsbefehle:

# Interactive auth
export UIPATH_FOLDER_PATH=<your-folder-path>
uipath run my-mcp

# Client-credential auth
export UIPATH_FOLDER_KEY=<your-folder-key>
uipath run my-mcp

Nach der Registrierung wird der Server im Orchestrator angezeigt und ist über die Standard-MCP-Endpunkt-URL erreichbar. Das URL-Format finden Sie unter Abrufen der MCP-Server-URL.

Authentication

Die Authentifizierung funktioniert auf zwei Ebenen für selbst gehostete MCP-Server:

• Das Token uipath auth des Entwicklers (oder die Client-Anmeldeinformationen) registriert die Runtime.
• Das Bearer-Token des Aufrufers authentifiziert jeden Toolaufruf.

Das Token des Aufrufers erreicht nie die lokale Runtime. UiPath validiert es in der Cloud und leitet nur die MCP-Protokollnachricht weiter.

Weitere Informationen zu den unterstützten Authentifizierungsmethoden und erforderlichen Berechtigungen finden Sie unter MCP-Serverauthentifizierung.

Konfiguration

Implementierungsdetails und eine Anleitung für die ersten Schritte finden Sie im uipath-mcp -Schnellstart.