> 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 Utilice las herramientas MCP integradas de PowerShell Universal para inspeccionar y gestionar recursos, ficheros de repositorio, notificaciones, trabajos y controles del portal. PowerShell Universal incluye herramientas MCP integradas en `/api/v1/mcp`. Ayudan a los clientes MCP a inspeccionar el repositorio de configuración de PowerShell Universal, descubrir cmdlets, leer la salida de trabajos y las notificaciones, y aplicar los cambios de repositorio admitidos. Las herramientas integradas son independientes de las herramientas de IA personalizadas. Conecte un cliente MCP a `/api/v1/mcp` y autentíquese con un token de aplicación de PowerShell Universal. ## Conectarse desde Visual Studio Code GitHub Copilot puede llamar a las herramientas integradas cuando Visual Studio Code está conectado al servidor MCP de PowerShell Universal. Pulse `Ctrl+Shift+P`, ejecute **MCP: Add Server...**, seleccione **HTTP** e introduzca la URL del endpoint MCP. De forma predeterminada, la URL es `http://localhost:5000/api/v1/mcp`. La configuración de `settings.json` resultante tiene este aspecto: ```json "mcp": { "servers": { "PSU": { "url": "http://localhost:5000/api/v1/mcp" } } } ``` Para autenticarse con un token de aplicación de PowerShell Universal, inclúyalo como token bearer en la cabecera `Authorization`: ```json "mcp": { "servers": { "PSU": { "url": "http://localhost:5000/api/v1/mcp", "headers": { "Authorization": "Bearer " } } } } ``` Sustituya `` por un token para el usuario y los roles de PowerShell Universal que deba utilizar el cliente. No incluya en el control de código fuente una configuración que contenga un token de aplicación real. Si la conexión se realiza correctamente, GitHub Copilot muestra las herramientas de PowerShell Universal disponibles. ## Control de acceso La mayoría de las herramientas integradas requieren el rol **Administrator** u **Operator**. `search_ant_design_controls` también admite el rol **App Editor**. `get_job_output_by_id` requiere un usuario autenticado y verifica que dicho usuario tiene permiso para leer el trabajo solicitado o su permiso de lectura configurado. Utilice un token de aplicación dedicado con únicamente el rol que necesite el cliente MCP. Las herramientas de escritura del repositorio pueden crear, actualizar, mover y eliminar ficheros de configuración, por lo que no debe conceder acceso de Administrator u Operator a un cliente MCP en el que no confíe. ## Flujo habitual 1. Llame a `list_resource_types` y `list_resources` para identificar el recurso de configuración. 2. Utilice las herramientas de repositorio y de comandos para inspeccionar los ficheros y cmdlets pertinentes. 3. Aplique un cambio deliberado en el repositorio con una herramienta de escritura cuando esté autorizado. 4. Llame a `reload_resource` para recargar el recurso afectado. 5. Utilice `get_notifications` o `get_job_output_by_id` para verificar el resultado. ## Herramientas de recursos y comandos | Herramienta | Descripción | | --------------------- | ------------------------------------------------------------------------------- | | `list_resource_types` | Enumera los tipos de recursos de PowerShell Universal disponibles. | | `list_resources` | Enumera los recursos de un tipo seleccionado, con filtrado por comodines. | | `reload_resource` | Recarga un tipo de recurso seleccionado tras un cambio de configuración. | | `list_commands` | Enumera los comandos de un módulo de PowerShell. | | `command_help` | Devuelve la ayuda enfocada o completa de un comando, sus parámetros y ejemplos. | | `list_app_commands` | Enumera los cmdlets de desarrollo de Universal Apps. | ## Herramientas de repositorio y operativas ### Herramientas de repositorio Las siguientes herramientas inspeccionan y gestionan ficheros y directorios relativos al repositorio: | Herramienta | Descripción | | ------------------------- | ------------------------------------------------------ | | `list_files` | Enumera ficheros y directorios. | | `search_files` | Busca nombres de ficheros y directorios. | | `search_file_content` | Busca en el contenido de los ficheros del repositorio. | | `get_file_content` | Lee un fichero del repositorio. | | `set_file_content` | Sustituye el contenido de un fichero del repositorio. | | `new_file_system_item` | Crea un fichero o directorio en el repositorio. | | `move_file_system_item` | Mueve o renombra un elemento del repositorio. | | `delete_file_system_item` | Elimina un elemento del repositorio. | Todas las rutas son relativas al repositorio. Utilice las herramientas de descubrimiento antes de modificar un fichero y llame a `reload_resource` después de un cambio de configuración autorizado. ### Herramientas operativas | Herramienta | Descripción | | ---------------------------- | --------------------------------------------------------------------------------------------------------------------- | | `get_notifications` | Devuelve las notificaciones recientes, opcionalmente filtradas por estado de lectura, nivel, hora o cursor. | | `get_job_output_by_id` | Devuelve la salida de la canalización o del flujo del trabajo cuando el llamante tiene permiso para leer ese trabajo. | | `search_ant_design_controls` | Busca los controles del portal de Ant Design y PSBlazor disponibles y devuelve sus parámetros. | ## Límites de herramientas y destinos de ejecución PowerShell Universal admite una limitación opcional de la frecuencia por minuto de las herramientas MCP y un límite opcional de trabajos simultáneos para los trabajos de herramientas de IA. Configure estos límites en la configuración del servidor para proteger la instancia de una actividad excesiva de herramientas. Las herramientas de IA personalizadas también pueden definir destinos **Run In** y **Run On**. Estas opciones controlan el entorno y el ordenador o grupo de ordenadores que se utiliza cuando una herramienta personalizada inicia un trabajo. No modifican los requisitos de autorización de las herramientas MCP integradas que se enumeran en esta página. ## Ejemplos Utilice el descubrimiento de recursos antes de editar la configuración: ``` list_resource_types list_resources(type: "scripts", filter: "Inventory*") get_file_content(path: "scripts/Inventory.ps1") ``` Tras una actualización autorizada, recargue e inspeccione las notificaciones: ``` set_file_content(path: "scripts/Inventory.ps1", content: "") reload_resource(resourceType: "scripts") get_notifications(unreadOnly: true, levels: "Warning,Error") ``` --- # 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=&goal= ``` `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.