- Überblick
- Erste Schritte
- Konzepte
- Verwenden der UiPath CLI
- Anleitungen
- CI/CD-Rezepte
- Befehlsreferenz
- Überblick
- Exitcodes
- Globale Optionen
- UIP-codierter Agent
- UIP-Coded
- UIP-Kontextgrundlage
- UIP-Dokumentation
- UIP-Funktion
- UIP-Leitplanken
- uip llm-configuration
- uip llm-gateway
- UIP Maestro-Erstellung
- UIP Maestro-Registrierung
- UIP-Modellhub
- Aktivitäten finden
- get-standard-xaml
- Analysieren
- Analyseregeln-Liste
- Erstellen
- Bereinigung
- data-fabric-entities installieren
- data-fabric-entities-Liste
- Dateien differenzieren
- Get-Library-Object-Repository
- Get-Object-Repository
- Init
- Instanzenliste
- Packen
- Pakete überprüfen
- Pakete installieren
- Paketversionen
- Veröffentlichen
- Remote
- restore
- Ausführen, Debuggen & Ausführung enthält
- Einstellungen
- Studio-Start
- Vorlagensuche
- Testdaten-Add-Entität
- Testdaten-Warteschlange hinzufügen
- Testdaten-Hinzufügevariante
- TM
- UIA
- Überprüfen
- Workflow-Beispiele abrufen
- Workflow-Beispiele
- UIP-Aufgaben
- Anhang
- benutzerdefiniertes Feld
- Defects
- Ausführungen
- Exportaufträge
- Migration
- Objektbeschriftung
- Packen
- perf-szenario
- Perf-Szenario-Lastgruppen
- Ausführungsdaten für perf-szenario
- Perf-Szenario-Bericht
- Projekt
- Projektberechtigungen
- Aufforderungen
- Melden
- Anforderungen
- Ergebnis
- Ausführen
- Zeitpläne
- scopes
- Testfallprotokoll
- Testfälle
- Testsätze
- Testschrittprotokoll
- Benutzer
- Warten
- UIP-Ablaufverfolgungen
- Feedback zu UIP-Ablaufverfolgungen
- Migration
- Referenz und Support
UIP-MCP
Syntax und Optionen für „uip mcp“, der UiPath CLI als Model Context Protocol-Server für MCP-fähige Clients verfügbar macht.
uip mcp macht die CLI als Modellkontextprotokollserver verfügbar, sodass MCP-fähige Clients (Claude Desktop, Cursor, VS Code MCP-Hosts usw.) einen beliebigen uip -Unterbefehl als Tool aufrufen können.
Fähigkeiten sind der Hauptpfad, um KI-Codierungsagenten die Verwendung der UiPath CLI beizubringen – siehe uip skills und Fähigkeiten. MCP wird als Alternative für Clients bereitgestellt, die keine Fähigkeiten unterstützen oder einen MCP-Stil-Aufruf für Tools bevorzugen. Wenn Ihr Agent Fähigkeiten unterstützt, bevorzugen Sie Fähigkeiten.
Zusammenfassung
uip mcp serve
uip mcp serve
uip mcp serve honors the global options (--output, --output-filter, --log-level, --log-file) for the server process itself; the tools it exposes to clients run any CLI command and return its output. Exit codes follow the standard contract.
UIP-MCP-Server
Startet den MCP-Server auf Studio (JSON-RPC durch Newline-Delimited). Es gibt keinen Netzwerk-Listener, keinen HTTP-Transport und keine Portkonfiguration – Studio ist der einzige unterstützte Transport in 1.x.
Argumente
Keine.
Optionen
Keines. Der Server wird ausgeführt, bis der Studio-Transport vom Client geschlossen wird (normalerweise, wenn die Hostanwendung beendet wird).
Verhalten
- The server advertises two tools:
run_command, for AI models, takes one argument:command(string) — The CLI command to run, without theuipprefix. Example:"login status --output json". The server splits the string on whitespace, keeping quoted runs together, and appends--output json.
run_argv, for programs that already hold the command as an argument list, takes one argument:args(array of strings) — The command's arguments, one per element, without theuipprefix. Example:["is", "connections", "list", "--output", "json"]. Each element is passed through as given, so values with spaces or quotes are safe. Nothing is appended, so pass your own--output.
- Der Server listet jeden installierten
uip-Unterbefehl beim Start auf und enthält einen gerenderten Befehlskatalog in der Beschreibung des MCP-Tools. Die Unterbefehlemcpundhelpwerden von diesem Katalog ausgeschlossen – der Client kann den Server nicht auffordern, einen anderen MCP-Server zu starten. - Calls to both tools run one at a time.
- On each
run_commandcall, the CLI runs the requested command and returns the combined stdout/stderr. If the child exits non-zero, or if it wrote an error envelope to stderr with a zero exit code (a rare case where a command reports failure without changing the exit code), the result is flaggedisError: trueand prefixed withError (exit code N):.
Beispiel (Starten des Servers über eine Shell – normalerweise startet Ihr MCP-Client dies für Sie):
uip mcp serve
uip mcp serve
Konfigurieren eines MCP-Clients
Alle Konfigurationen verwenden denselben Befehl/jede Argumente. Der Servername (uipath unten) ist beliebig.
Claude Desktop – Bearbeiten Sie claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"uipath": {
"command": "uip",
"args": ["mcp", "serve"]
}
}
}
{
"mcpServers": {
"uipath": {
"command": "uip",
"args": ["mcp", "serve"]
}
}
}
Starten Sie Claude Desktop nach dem Speichern neu.
Claude Code – über die CLI hinzufügen:
claude mcp add uipath -- uip mcp serve
claude mcp add uipath -- uip mcp serve
Cursor – Bearbeiten Sie .cursor/mcp.json (projekt-lokal) oder die globale MCP-Konfiguration des Cursors:
{
"mcpServers": {
"uipath": {
"command": "uip",
"args": ["mcp", "serve"]
}
}
}
{
"mcpServers": {
"uipath": {
"command": "uip",
"args": ["mcp", "serve"]
}
}
}
VS-Code – .vscode/mcp.json bearbeiten:
{
"servers": {
"uipath": {
"command": "uip",
"args": ["mcp", "serve"]
}
}
}
{
"servers": {
"uipath": {
"command": "uip",
"args": ["mcp", "serve"]
}
}
}
Lebenszyklus
Der MCP-Server hat keinen eigenständigen Stoppbefehl. Er ist ein untergeordneter Prozess des MCP-Clients und wird beendet, wenn:
- Der Client schließt die Studio-Verbindung,
- Die Hostanwendung wird beendet oder
- entfernen Sie den Servereintrag aus der Konfiguration des Clients und laden Sie neu.
Authentifizierung und Mandantenkontext
uip mcp serve does not manage credentials. Every run_command and run_argv invocation reads the same stored session as an interactive shell would — so you must have run uip login separately before asking the agent to call commands that require auth. If no session exists, the tool result will contain the usual AuthenticationError payload. Refer to Exit codes.
Datenform
Toolergebnisse folgen dem MCP-Tool-Aufrufvertrag. Bei Erfolg:
{
"content": [
{ "type": "text", "text": "<combined stdout/stderr>" }
],
"isError": false
}
{
"content": [
{ "type": "text", "text": "<combined stdout/stderr>" }
],
"isError": false
}
On failure, isError is true and text is prefixed with Error (exit code N):. The inner text is the command's JSON output.
A run_argv result returns stdout, stderr, and the exit code as separate fields, both as structuredContent and as the same object serialized in text. A non-zero exit is reported in exitCode, and isError is never set:
{
"content": [
{ "type": "text", "text": "{\"stdout\":\"…\",\"stderr\":\"\",\"exitCode\":0}" }
],
"structuredContent": { "stdout": "…", "stderr": "", "exitCode": 0 }
}
{
"content": [
{ "type": "text", "text": "{\"stdout\":\"…\",\"stderr\":\"\",\"exitCode\":0}" }
],
"structuredContent": { "stdout": "…", "stderr": "", "exitCode": 0 }
}
Überlegungen
- Request JSON from
run_argvcalls.run_commandappends--output jsonto every command.run_argvappends nothing, so include--output jsoninargswhen the caller parses the output. - No filtering of destructive commands. The
run_commandandrun_argvtools can invoke anyuipsubcommand, includinglogout,tools uninstall, and tools that mutate Orchestrator state. Treat the MCP server as an authenticated shell and scope the agent accordingly. helpundmcpsind im Katalog ausgeblendet , können aber dennoch vom Client aufgerufen werden. Nichts verhindert, dassmcp serverekursiv durch ein anderesrun_commandaufgerufen wird; Dies ist in der Praxis ein No-OP, da der äußere Server Studio steuert.
Zugehörig
uip skills– Der primäre KI-Integrationspfad.- Fähigkeiten – warum Fähigkeiten für die Erneuerung von Agents dem unformatierten MCP-Zugriff vorzuziehen sind.
- Authentifizierung – Die Sitzung
run_commanderbt diese. - Globale Optionen –
--output jsoninnerhalb von MCP-Aufrufen.