MCP uip

uip mcp expose la CLI en tant que serveur du protocole de contexte du modèle , permettant aux clients compatibles MCP (Claude Desktop, Cursor, hôtes MCP VS Code, etc.) d'invoquer toute sous-commande uip en tant qu'outil.

Remarque :

Les compétences sont le chemin principal pour apprendre aux agents de codage d'IA à utiliser la UiPath CLI — voir uip skills et Compétences. MCP est fourni comme alternative aux clients qui ne prennent pas en charge les compétences ou qui préfèrent l'invocation d'outils de style MCP. Si votre agent prend en charge les compétences, préférez les compétences.

Synthèse

uip mcp serve

uip mcp serve respecte les options globales (--output, --output-filter, --log-level, --log-file) pour le processus de serveur lui-même; l'outil qu'il expose aux clients accepte n'importe quelle chaîne de commande CLI et renvoie sa combinaison stdout/stderr. Les codes de sortie suivent le contrat standard.

Service MCP uip

Démarre le serveur MCP sur stdio (JSON-RPC délimité par une nouvelle ligne). Il n’y a pas d’écouteur réseau, pas de transport HTTP et pas de configuration de port — stdio est le seul transport pris en charge dans 1.x.

Arguments

Aucun

Options

None. The server runs until the stdio transport is closed by the client (usually when the host application quits).

Comportement

• Le serveur annonce un seul outil, run_command, qui prend un argument:
  • command — La commande CLI à exécuter, sans le préfixe uip . Exemple: "login status --output json".
• Le serveur énumère chaque sous-commande uip installée au démarrage et inclut un catalogue de commandes rendu dans la description de l’outil MCP. Les sous-commandes mcp et help sont exclues de ce catalogue — le client ne peut pas demander au serveur de démarrer un autre serveur MCP.
• Pour chaque appel run_command , la CLI exécute la commande demandée dans une invocation enfant et renvoie la combinaison stdout/stderr. Si l'enfant quitte non-zéro, ou s'il a écrit une enveloppe d'erreur à stderr avec un code de sortie zéro (un cas rare où une commande signale l'échec sans modifier le code de sortie), le résultat est marqué isError: true et préfixé avec Error (exit code N):.

Exemple (démarrage du serveur à partir d'un shell — normalement votre client MCP lance ceci pour vous):

uip mcp serve

Configurer un client MCP

Toutes les configurations utilisent les mêmes commandes/arguments. Le nom du serveur (uipath ci-dessous) est arbitraire.

Claude Desktop — modifier 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"]
    }
  }
}

Redémarrez Claude Desktop après avoir enregistré.

Code Claude — ajouter via sa CLI:

claude mcp add uipath -- uip mcp serve

Curseur : modifiez .cursor/mcp.json (projet-local) ou la configuration MCP globale du curseur:

{
  "mcpServers": {
    "uipath": {
      "command": "uip",
      "args": ["mcp", "serve"]
    }
  }
}

VS Code — modifier .vscode/mcp.json:

{
  "servers": {
    "uipath": {
      "command": "uip",
      "args": ["mcp", "serve"]
    }
  }
}

Cycle de vie

Le serveur MCP ne dispose pas de commande d’arrêt autonome. Il se trouve en tant que processus enfant du client MCP et se termine lorsque:

• le client ferme la connexion stdio,
• l'application hôte se ferme, ou
• vous supprimez l'entrée de serveur de la configuration et du rechargement du client.

Contexte d'authentification et de locataire

uip mcp serve ne gère pas les informations d'identification. Chaque run_command invocation lit la même session stockée qu'un shell interactif le ferait. Vous devez donc avoir exécuté uip login séparément avant de demander à l'agent d'appeler des commandes qui nécessitent l'authentification. Si aucune session n’existe, le résultat de l’outil contiendra la charge utile habituelle AuthenticationError (voir Codes de sortie).

Format des données

Les résultats de l’outil suivent le contrat d’appel d’outil MCP. En cas de réussite:

{
  "content": [
    { "type": "text", "text": "<combined stdout/stderr>" }
  ],
  "isError": false
}

En cas d'échec, isError est true et text est préfixé par Error (exit code N):. Le texte à l’intérieur est la sortie CLI normale (JSON si l’appelant a demandé --output json, sinon le format par défaut).

Considérations

• Demandez toujours JSON à l’intérieur des appels MCP. Transmettez --output json dans la chaîne command afin que l’agent reçoive des données structurées au lieu de tables.
• Aucun filtrage des commandes destructrices. L'outil run_command peut invoquer n'importe quelle sous-commande uip , y compris logout, tools uninstall et les outils qui modifient l'état d'Orchestrator. Traitez le serveur MCP comme un shell authentifié et étendez l’agent en conséquence.
• help et mcp sont masqués dans le catalogue , mais peuvent toujours être invoqués par le client. Rien n'empêche mcp serve d'être appelé de manière récursive via un autre run_command; il s'agit d'une pratique no-op, car le serveur externe contrôle stdio.

Associé

• uip skills — chemin d'intégration de l'IA principal.
• Compétences - pourquoi les compétences sont préférées à l'accès MCP brut pour l'ergonomie de l'agent.
• Authentification — la session run_command hérite.
• Options globales — --output json à l'intérieur des appels MCP.