mcp de uip

uip mcp la CLI como un servidor de protocolo de contexto de modelo , lo que permite a los clientes compatibles con MCP (Claude Desktop, Cursor, hosts MCP de VS Code, etc.) invocar cualquier subcomando uip como herramienta.

Nota:

Las habilidades son la ruta principal para enseñar a los agentes de codificación de IA a utilizar UiPath CLI — consulta uip skills y Habilidades. MCP se proporciona como una alternativa para los clientes que no admiten habilidades o que prefieren la invocación de herramientas de estilo MCP. Si tu agente admite habilidades, da preferencia a las habilidades.

Sinopsis

uip mcp serve

uip mcp serve respeta las opciones globales (--output, --output-filter, --log-level, --log-file) para el propio proceso del servidor; la herramienta que expone a los clientes acepta cualquier cadena de comandos CLI y devuelve su stdout/stderr combinados. Los códigos de salida siguen el contrato estándar.

servicio de mcp de uip

Inicia el servidor MCP en stdio (JSON-RPC delimitado por saltos de línea). No hay escucha de red, transporte HTTP ni configuración de puertos: stdio es el único transporte compatible en 1.x.

Argumentos

Nada.

Opciones

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

Comportamiento

• El servidor anuncia una única herramienta, run_command, que toma un argumento:
  • command (string) : el comando CLI que se ejecutará, sin el prefijo uip . Ejemplo: "login status --output json".
• El servidor enumera cada subcomando uip instalado al inicio e incluye un catálogo de comandos representados en la descripción de la herramienta MCP. Los subcomandos mcp y help se excluyen de ese catálogo: el cliente no puede pedir al servidor que inicie otro servidor MCP.
• En cada llamada run_command , la CLI ejecuta el comando solicitado en una invocación secundaria y devuelve el stdout/stderr combinado. Si el elemento secundario sale distinto de cero, o si escribió un sobre de error en stderr con un código de salida cero (un caso raro en el que un comando informa de un fallo sin cambiar el código de salida), el resultado se marca isError: true y tiene el prefijo Error (exit code N):.

Ejemplo (iniciar el servidor desde un shell; normalmente tu cliente MCP inicia esto por ti):

uip mcp serve

Configurar un cliente MCP

Todas las configuraciones utilizan el mismo comando/argumentos. El nombre del servidor (uipath a continuación) es arbitrario.

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

Reinicia Claude Desktop después de guardar.

Claude Code : añadir a través de su CLI:

claude mcp add uipath -- uip mcp serve

Cursor : edita .cursor/mcp.json (proyecto-local) o la configuración global de MCP del Cursor:

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

VS Code — editar .vscode/mcp.json:

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

Ciclo de vida

El servidor MCP no tiene un comando de detención independiente. Vive como un proceso secundario del cliente MCP y sale cuando:

• el cliente cierra la conexión stdio,
• la aplicación host se cierra, o
• eliminas la entrada del servidor de la configuración del cliente y vuelves a cargar.

Contexto de autenticación y tenant

uip mcp serve no gestiona las credenciales. Cada invocación run_command lee la misma sesión almacenada que lo haría un shell interactivo, por lo que debes haber ejecutado uip login por separado antes de pedir al agente que llame a los comandos que requieren autenticación. Si no existe ninguna sesión, el resultado de la herramienta contendrá la carga útil AuthenticationError habitual (consulta Códigos de salida).

Forma de datos

Los resultados de la herramienta siguen el contrato de llamada de herramienta de MCP. En caso de éxito:

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

En caso de error, isError es true y text tiene el prefijo Error (exit code N):. El texto interno es la salida CLI normal (JSON si la persona que llama solicitó --output json; de lo contrario, el formato predeterminado).

Consideraciones

• Solicite siempre JSON desde el interior de las llamadas de MCP. Pasa --output json en la cadena command para que el agente reciba datos estructurados en lugar de tablas.
• Sin filtrado de comandos destructivos. La herramienta run_command puede invocar cualquier subcomando uip , incluidos logout, tools uninstall y las herramientas que mutan el estado de Orchestrator. Trata el servidor MCP como un shell autenticado y establece el ámbito del agente en consecuencia.
• help y mcp están ocultos en el catálogo , pero el cliente puede seguir invocándolos. Nada impide que mcp serve se llame de forma recursiva a través de otro run_command; esto es un no-op en la práctica porque el servidor externo controla stdio.

Relacionado

• uip skills : ruta de integración de IA principal.
• Habilidades : por qué se prefieren las habilidades al acceso MCP sin formato para la ergonomía del agente.
• Autenticación : la sesión run_command hereda.
• Opciones globales : --output json dentro de las llamadas de MCP.