Herramientas MCP integradas

PowerShell Universal incluye varias herramientas MCP integradas que ayudan a los agentes de programación a inspeccionar los recursos de PSU y a conocer la superficie de comandos local. Están disponibles en el endpoint /api/v1/mcp.

Estas herramientas integradas son independientes de sus herramientas de IA personalizadas. En la práctica, resultan más útiles cuando un agente necesita inspeccionar scripts, endpoints, aplicaciones o la ayuda de cmdlets antes de realizar un cambio.

Para acceder a ellas de forma remota, conecte un cliente MCP a /api/v1/mcp y autentíquese con un token de aplicación de PSU. Las herramientas integradas requieren acceso de Administrator u Operator.

Flujo típico

La mayoría de las sesiones de programación siguen un patrón como este:

1. Llame a list_resource_types para ver qué tipos de recursos de PSU están disponibles.
2. Llame a list_resources para encontrar el script, endpoint, aplicación o flujo de trabajo concreto que necesita.
3. Llame a list_commands o list_app_commands para descubrir los cmdlets disponibles en ese servidor PSU.
4. Llame a command_help para obtener ayuda específica sobre el cmdlet que planea utilizar.
5. Llame a reload_resource después de cambiar la configuración para que PSU recargue el recurso.

list_resource_types

Devuelve los tipos de recursos disponibles en la instancia de PSU conectada, como scripts, endpoints, aplicaciones y flujos de trabajo.

Utilice esto primero en lugar de adivinar los nombres de tipo disponibles.

Ejemplo:

list_resource_types

list_resources

Lista los recursos de un tipo determinado y los devuelve como JSON.

Parámetros:

• type - El tipo de recurso a inspeccionar. Utilice un valor devuelto por list_resource_types.
• filter - Un filtro con comodines que coincide con nombres o descripciones de recursos.

Ejemplo:

{
	"type": "<resource type from list_resource_types>",
	"filter": "deploy*"
}

list_commands

Busca comandos en un módulo de PowerShell instalado en el servidor PSU.

Parámetros:

• module - El nombre del módulo.
• name - Un filtro de nombre de comando. Se admiten comodines.

Normalmente, a esto le sigue command_help.

Ejemplo:

{
	"module": "Universal",
	"name": "*PSUAi*"
}

command_help

Devuelve información de ayuda sobre un comando disponible en el servidor PSU.

Parámetros:

• module - El nombre del módulo.
• command - El comando a inspeccionar.
• parameter - Nombre de parámetro o patrón con comodines opcional.
• full - Incluir el resultado de ayuda completo.
• examples - Incluir ejemplos.

Empiece con una ayuda específica en lugar de solicitar siempre el texto de ayuda completo.

Ejemplo:

{
	"module": "Universal",
	"command": "Invoke-PSUAiAgent",
	"parameter": "Prompt",
	"full": false,
	"examples": true
}

list_app_commands

Devuelve los cmdlets específicos de aplicaciones que se utilizan para crear aplicaciones de PSU, especialmente los comandos de componentes UD y de interactividad.

Parámetro:

• filter - Un filtro con comodines para el nombre del comando.

Ejemplo:

{
	"filter": "New-UD*"
}

reload_resource

Recarga un tipo de recurso de PSU después de que los ficheros o la configuración hayan cambiado.

Parámetro:

• resourceType - El tipo de recurso a recargar.

Ejemplo:

{
	"resourceType": "<resource type from list_resource_types>"
}

Esto resulta especialmente útil cuando un agente edita la configuración a través de una copia local o un sistema de ficheros remoto y después necesita que PSU aplique el cambio.