> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/es/inteligencia/built-in-mcp-tools.md).

# 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](/powershell-universal/es/inteligencia/ai-tools.md) 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:

```json
{
	"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:

```json
{
	"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:

```json
{
	"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:

```json
{
	"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:

```json
{
	"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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.devolutions.net/powershell-universal/es/inteligencia/built-in-mcp-tools.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.