> 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/fr/intelligence/built-in-mcp-tools.md). # Outils MCP intégrés Utilisez les outils MCP intégrés de PowerShell Universal pour inspecter et gérer les ressources, les fichiers de dépôt, les notifications, les tâches et les contrôles du portail. PowerShell Universal inclut des outils MCP intégrés à `/api/v1/mcp`. Ils aident les clients MCP à inspecter le dépôt de configuration de PowerShell Universal, à découvrir les applets de commande, à lire la sortie des tâches et les notifications, et à appliquer les modifications de dépôt prises en charge. Les outils intégrés sont distincts des outils d'IA personnalisés. Connectez un client MCP à `/api/v1/mcp` et authentifiez-vous avec un jeton d'application PowerShell Universal. ## Se connecter à partir de Visual Studio Code GitHub Copilot peut appeler les outils intégrés lorsque Visual Studio Code est connecté au serveur MCP de PowerShell Universal. Appuyez sur `Ctrl+Shift+P`, exécutez **MCP: Add Server...**, sélectionnez **HTTP**, puis entrez l'URL du terminal MCP. Par défaut, l'URL est `http://localhost:5000/api/v1/mcp`. La configuration `settings.json` résultante ressemble à ceci : ```json "mcp": { "servers": { "PSU": { "url": "http://localhost:5000/api/v1/mcp" } } } ``` Pour vous authentifier avec un jeton d'application PowerShell Universal, incluez-le comme jeton bearer dans l'en-tête `Authorization` : ```json "mcp": { "servers": { "PSU": { "url": "http://localhost:5000/api/v1/mcp", "headers": { "Authorization": "Bearer " } } } } ``` Remplacez `` par un jeton correspondant à l'utilisateur et aux rôles PowerShell Universal que le client doit utiliser. Ne soumettez pas au contrôle de code source une configuration contenant un véritable jeton d'application. Si la connexion réussit, GitHub Copilot affiche les outils PowerShell Universal disponibles. ## Contrôle d'accès La plupart des outils intégrés nécessitent le rôle **Administrator** ou **Operator**. `search_ant_design_controls` prend aussi en charge le rôle **App Editor**. `get_job_output_by_id` nécessite un utilisateur authentifié et vérifie que cet utilisateur a la permission de lire la tâche demandée ou son autorisation de lecture configurée. Utilisez un jeton d'application dédié avec seulement le rôle requis par le client MCP. Les outils d'écriture dans le dépôt peuvent créer, mettre à jour, déplacer et supprimer des fichiers de configuration; n'accordez donc pas d'accès Administrator ou Operator à un client MCP non fiable. ## Flux typique 1. Appelez `list_resource_types` et `list_resources` pour identifier la ressource de configuration. 2. Utilisez les outils de dépôt et de commande pour inspecter les fichiers et les applets de commande pertinents. 3. Appliquez une modification délibérée du dépôt avec un outil d'écriture lorsque vous y êtes autorisé. 4. Appelez `reload_resource` pour recharger la ressource touchée. 5. Utilisez `get_notifications` ou `get_job_output_by_id` pour vérifier le résultat. ## Outils de ressources et de commandes | Outil | Description | | --------------------- | ---------------------------------------------------------------------------------------- | | `list_resource_types` | Liste les types de ressources PowerShell Universal disponibles. | | `list_resources` | Liste les ressources d'un type sélectionné, avec filtrage par caractères génériques. | | `reload_resource` | Recharge un type de ressource sélectionné après une modification de la configuration. | | `list_commands` | Liste les commandes d'un module PowerShell. | | `command_help` | Retourne l'aide ciblée ou complète d'une commande, de ses paramètres et de ses exemples. | | `list_app_commands` | Liste les applets de commande de développement d'applis Universal. | ## Outils de dépôt et outils opérationnels ### Outils de dépôt Les outils suivants inspectent et gèrent les fichiers et répertoires relatifs au dépôt : | Outil | Description | | ------------------------- | ------------------------------------------------------ | | `list_files` | Liste les fichiers et les répertoires. | | `search_files` | Recherche dans les noms de fichiers et de répertoires. | | `search_file_content` | Recherche dans le contenu des fichiers du dépôt. | | `get_file_content` | Lit un fichier du dépôt. | | `set_file_content` | Remplace le contenu d'un fichier du dépôt. | | `new_file_system_item` | Crée un fichier ou un répertoire dans le dépôt. | | `move_file_system_item` | Déplace ou renomme un élément du dépôt. | | `delete_file_system_item` | Supprime un élément du dépôt. | Tous les chemins sont relatifs au dépôt. Utilisez les outils de découverte avant de modifier un fichier, et appelez `reload_resource` après une modification de configuration autorisée. ### Outils opérationnels | Outil | Description | | ---------------------------- | ----------------------------------------------------------------------------------------------------------- | | `get_notifications` | Retourne les notifications récentes, avec filtrage optionnel par état de lecture, niveau, heure ou curseur. | | `get_job_output_by_id` | Retourne la sortie du pipeline ou du flux de tâches lorsque l'appelant est autorisé à lire cette tâche. | | `search_ant_design_controls` | Recherche parmi les contrôles de portail Ant Design et PSBlazor disponibles et retourne leurs paramètres. | ## Limites des outils et cibles d'exécution PowerShell Universal prend en charge une limitation optionnelle du débit des outils MCP par minute et une limite optionnelle de tâches concurrentes pour les tâches d'outils d'IA. Configurez ces limites dans les paramètres du serveur pour protéger l'instance contre une activité excessive des outils. Les outils d'IA personnalisés peuvent aussi définir des cibles **Run In** et **Run On**. Ces paramètres contrôlent l'environnement et l'ordinateur ou le groupe d'ordinateurs utilisés lorsqu'un outil personnalisé démarre une tâche. Ils ne modifient pas les exigences d'autorisation des outils MCP intégrés listés sur cette page. ## Exemples Utilisez la découverte de ressources avant de modifier la configuration : ``` list_resource_types list_resources(type: "scripts", filter: "Inventory*") get_file_content(path: "scripts/Inventory.ps1") ``` Après une mise à jour autorisée, rechargez et inspectez les notifications : ``` 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/fr/intelligence/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.